Guida all'uso
Ricette di prompt per Imagen 4.0 Ultra: prompt copiaincolla per dettagli e illuminazione realistici
Una guida per sviluppatori: costruire prompt, controllare l'illuminazione e usare i negative prompt al livello di qualità più alto
In questa pagina
Perché la struttura del prompt conta di più nel livello Ultra
Il livello di qualità più alto di un modello di immagini non è un pulsante magico. Segue i tuoi prompt in modo più fedele, e questa è un'arma a doppio taglio: i prompt vaghi restituiscono un'immagine raffinata ma mediocre, mentre i prompt contraddittori restituiscono risultati apparentemente sicuri ma sbagliati. Nel livello Ultra paghi per la fedeltà, quindi il prompt stesso diventa la variabile principale che controlli.
Accumulare parole chiave è un tipico errore. Elenchi come 4k, ultra detailed, masterpiece, hyperrealistic, sharp focus, trending non dicono al modello cosa renderizzare né come illuminarlo. Per lo più aggiungono rumore, e quando ogni generazione è una chiamata a piena qualità il rumore costa caro.
Un prompt strutturato ottiene tre cose contemporaneamente:
- Rende l'output riproducibile. Se il tuo prompt ha slot fissi, puoi cambiare un solo slot sapendo con chiarezza cosa ha fatto la differenza.
- Rende possibile il debug. Quando un'immagine viene male, puoi indicare il blocco che ha fallito (di solito l'illuminazione o la fotocamera) invece di riscrivere tutto.
- Rende la tua integrazione testabile. Il testo del prompt diventa un asset versionabile che puoi registrare, confrontare in diff e testare in A/B, invece di seppellirlo in una stringa dentro una chiamata di funzione.
Il resto di questa guida ti fornisce uno scheletro, un vocabolario per l'illuminazione, una breve regola sui negative prompt e una raccolta di ricette che puoi incollare nelle tue chiamate tramite l'interfaccia unificata di HiAPI.ai e poi adattare.

Lo scheletro del prompt in cinque blocchi
Usa sempre gli stessi cinque blocchi nello stesso ordine. L'ordine conta meno della coerenza, ma una lettura che parte dal soggetto funziona meglio, perché i blocchi successivi sono modificatori di una scena già stabilita.
[soggetto] + [dettagli] + [illuminazione] + [fotocamera] + [stile]
Blocco 1: soggetto
Indica in una frase l'oggetto principale e la sua azione o stato. I sostantivi concreti battono gli aggettivi.
una tazza di caffè in ceramica su un tavolo di legno, con vapore che sale
Blocco 2: dettagli
Ciò che rende concreto il soggetto — materiali, usura, texture, piccoli difetti. È qui che si guadagna il realismo.
... gres smaltato, bordo scheggiato, condensa fine sulla superficie esterna, graffi visibili sulla venatura del legno
Blocco 3: illuminazione
Il blocco con la leva maggiore. Specifica la sorgente luminosa, la direzione e la qualità. La sezione successiva lo approfondisce.
... illuminata dalla luce di una finestra da sinistra, morbida, pomeriggio nuvoloso
Blocco 4: fotocamera
Composizione, distanza e caratteristiche dell'obiettivo. Mantienilo breve: primo piano, 50mm, profondità di campo ridotta di solito basta.
... primo piano, 50mm, profondità di campo ridotta
Blocco 5: stile
Solo a questo punto aggiungi l'intento di resa: fotografia di prodotto editoriale, stile documentario, fotogramma cinematografico. Se vuoi un output neutro, saltalo del tutto.
... fotografia di prodotto editoriale
Una volta assemblato, il prompt completo è una sola riga:
una tazza di caffè in ceramica su un tavolo di legno, con vapore che sale, gres smaltato, bordo scheggiato, condensa fine sulla superficie esterna, graffi visibili sulla venatura del legno, illuminata dalla luce di una finestra da sinistra, morbida, pomeriggio nuvoloso, primo piano, 50mm, profondità di campo ridotta, fotografia di prodotto editoriale
Due regole pratiche. Primo, se un blocco non ha contenuti utili da dire, omettilo invece di riempirlo di sciocchezze. Secondo, controlla la lunghezza totale — un prompt compatto fatto di cinque proposizioni concrete di solito batte un paragrafo di modificatori.

Controllare luci e ombre nel prompt
Se nelle tue ricette devi cambiare una sola cosa, cambia il blocco dell'illuminazione. La luce determina l'atmosfera, rivela le texture ed è il modo più rapido per far passare un'immagine da "renderizzata" a "scattata".
Specifica quattro proprietà:
- Sorgente: finestra, cielo nuvoloso, lampadina nuda, candela, softbox, luce dello schermo, lampione.
- Direzione: da sinistra, in controluce, dall'alto, luce laterale bassa, tre quarti frontale.
- Durezza: diffusa morbida oppure direzionale netta. Questo controlla i bordi delle ombre più di qualsiasi altro fattore.
- Momento della giornata: pomeriggio nuvoloso, ora d'oro, ora blu, sole di mezzogiorno, notte.
Un vocabolario versatile
luce morbida di finestra da sinistra, attenuazione graduale
sole intenso di mezzogiorno, ombre nette, contrasto elevato
controluce con luce di contorno, soggetto in ombra
giorno nuvoloso, piatto e uniforme, ombre minime
una lampada calda, buio intorno, una pozza di luce
Errori comuni di illuminazione
Contraddizione. luce morbida, ombre forti dà al modello due istruzioni incompatibili. Scegline una.
Direzione non specificata. buona illuminazione non è un controllo, è un desiderio. Specifica sempre da dove viene la luce.
Illuminazione in conflitto con la fotocamera. controluce insieme a primo piano illuminato in modo uniforme tirano in direzioni opposte. Lascia decidere il blocco dell'illuminazione e fai descrivere al blocco della fotocamera solo la composizione.
Trattare il momento della giornata come condimento. ora d'oro è una condizione reale e vincolante. luce bellissima no.
Un'abitudine utile: scrivi prima il blocco dell'illuminazione, poi quello dei dettagli. Se sai di volere una luce laterale intensa, sai già che le texture devono restare leggibili sotto un contrasto forte, e questo ti dice cosa enfatizzare nel blocco dei dettagli.

Quando e come usare i negative prompt
Un negative prompt è un breve elenco di cose da evitare, non un secondo prompt. Una volta che si espande in una descrizione completa di un'altra immagine, compete con il prompt positivo e produce risultati confusi.
In cosa eccellono i negative prompt
- Rimuovere artefatti ricorrenti: quando sul soggetto spuntano sempre scritte, usa
testo, filigrana, logo. - Allontanare la composizione dai valori predefiniti: quando il modello tende sempre a layout piatti e centrati, usa
composizione centrata, simmetria. - Escludere uno stile indesiderato specifico: quando vuoi un output fotografico, usa
cartone animato, render 3D, illustrazione. - Sopprimere elementi non desiderati: per scatti puliti di prodotto, usa
folla, persone sullo sfondo.
Cosa non possono fare i negative prompt
Non correggono in modo affidabile l'anatomia, le mani o il rendering del testo — questi sono limiti a livello di modello, non di prompt. Non possono nemmeno aggiungere dettagli che il prompt positivo non ha mai richiesto. Se vuoi una texture fine, descrivi la texture fine; non elencare sfocato sperando che funzioni.
Mantieniti tra tre e sei voci
testo, filigrana, dita in più, sovrasaturazione, cartone animato
Questo è un elenco sano. Un elenco di venti parole di solito indica che il prompt positivo è sottodescritto — correggilo prima, poi ritesta con un elenco negativo più breve. Ricostruisci il negative prompt per ogni ricetta invece di riutilizzare un elenco globale in ogni scenario; una voce negativa utile per un ritratto spesso è dannosa per un paesaggio.
Ricette copiaincolla da cui partire
Ognuna delle ricette seguenti segue lo scheletro in cinque blocchi. Incollala, poi cambia una sola variabile — quella indicata in grassetto — e confrontala con la tua baseline. Trattale come punti di partenza, non come risposte definitive.
Ricetta 1: primo piano di prodotto con texture realistiche
una tastiera meccanica nero opaco su un piano di cemento, tasti con segni di usura visibili, polvere nelle fessure, luce laterale intensa da destra, ombre nette, 85mm, profondità di campo ridotta, fotografia di prodotto editoriale
Variabile da regolare: sostituisci luce laterale intensa con luce morbida di finestra e osserva quanta texture superficiale resta. Questo singolo cambiamento è il modo migliore per capire come il modello risponde all'illuminazione.
Ricetta 2: ritratto con contesto ambientale
una donna sulla quarantina in piedi in un laboratorio artigianale, trucioli di legno sulle maniche, un sorriso accennato, luce diurna nuvolosa da una grande finestra dietro a sinistra della fotocamera, luce morbida e uniforme, 50mm, piano medio, fotografia documentaria
Variabile da regolare: il momento della giornata. Prova sole serale, luce di contorno calda e confronta la resa dell'incarnato e delle ombre.
Ricetta 3: scena d'interni con fonti luminose plausibili
una piccola cucina di appartamento di notte, piatti che asciugano sullo scolapiatti, una lampada a sospensione calda sopra il tavolo, buio intorno, una pozza di luce, 35mm, grandangolo, fotogramma cinematografico naturale
Variabile da regolare: il numero di sorgenti. Aggiungi luce fredda proveniente dal corridoio per ottenere una miscela a due sorgenti, ed è qui che le scene d'interni iniziano a sembrare reali.
Ricetta 4: paesaggio con tempo atmosferico invece che decorazione
costa rocciosa con la bassa marea, pietre bagnate e alghe, un banco di nebbia in lontananza, luce direzionale morbida dall'alto a sinistra che filtra tra le nuvole, 24mm, grandangolo, fotografia di paesaggio
Variabile da regolare: la durezza. Nella stessa scena prova sole intenso, ombre nette e confronta come si presenta la nebbia.
Ricetta 5: cibo con imperfezioni reali
una fetta di pane a lievitazione naturale tostato e imburrato a metà, briciole su un tovagliolo di lino, bordi irregolari della fetta, luce calda di finestra da sinistra, attenuazione morbida, 100mm macro, profondità di campo ridotta, fotografia gastronomica
Variabile da regolare: il blocco dei dettagli. Rimuovi del tutto la proposizione sulle imperfezioni per vedere quanta realisticità perdi — questo rende tangibile il valore del blocco dei dettagli.
Annota quale ricetta hai regolato e quale variabile hai cambiato. Questo registro è il punto di partenza della tua libreria personale di prompt.
Testare le ricette nella tua pipeline
Una ricetta è utile solo quando puoi stabilire se è migliorata. Questo richiede un minimo di processo — non un framework, solo disciplina.
Registra ogni generazione
Per ogni chiamata memorizza: il testo del prompt, l'ID della ricetta, l'unica variabile modificata (se presente) e l'output. Un log JSON piatto o un file per esecuzione basta. Senza log puoi confrontare solo a memoria, e la memoria non è affidabile con decine di varianti.
Cambia una variabile alla volta
Scegli una ricetta di baseline, eseguila, poi genera varianti che differiscono per una sola proposizione. Se cambi illuminazione e dettagli nella stessa chiamata, non puoi attribuire il risultato. Sì, è più lento. Ma è anche l'unico modo per costruire un'intuizione che si trasferisca da uno scenario all'altro.
Valuta, non solo guardare
Mantieni una breve rubric applicata in modo coerente: accuratezza del soggetto, realismo delle texture, correttezza dell'illuminazione, artefatti. Anche una rapida valutazione a tre punti per ogni dimensione trasforma un mucchio di immagini in un insieme confrontabile.
Sapere quando è pronto per la consegna
Una ricetta è pronta quando produce output accettabili su piccole esecuzioni ripetute con lo stesso prompt, e la variabile che ti interessa si comporta in modo prevedibile quando la cambi. Se una ricetta funziona una sola volta, non è una ricetta.
Ritesta quando le condizioni cambiano
Una formulazione che funziona oggi potrebbe comportarsi diversamente in futuro, perché le versioni del modello e il comportamento della piattaforma cambiano nel tempo. Quando noti una deriva, riesegui il set di baseline e aggiorna le ricette interessate, invece di riscrivere tutto.
Esegui le tue varianti tramite l'interfaccia unificata di HiAPI.ai e tieni i log insieme al codice, così le modifiche alle ricette sono diff revisionabili come qualsiasi altro asset.
Articoli correlati
Vedi tutti gli articoli →-
Guida all'uso
Guida introduttiva a seedream-5.0-flash: capacità, prezzi e punti chiave per l'integrazione
Istruzioni per l'integrazione di text-to-image / image-to-image per sviluppatori e tariffazione a immagine
-
Guida all'uso
Chiamare il modello wan2.7-video/text-to-video tramite l'API HiAPI: un flusso di lavoro pratico per video brevi
Pattern prompt-to-clip per video brevi, formulazione delle inquadrature e una richiesta API funzionante
-
Guida all'uso
Guida introduttiva a MiniMax H3 Max Turbo: video da testo, video da immagine con primo e ultimo fotogramma, parametri e prezzi
Come scegliere tra i due ID di chiamata, come compilare i parametri e come si calcola il costo