Ricette di prompt per imagen4-fast: prompt copiabili e incollabili per gli sviluppatori

Perché le ricette di prompt battono i prompt usa-e-getta

La maggior parte dei problemi di generazione di immagini non dipende dal modello, ma dal prompt, e sono difficili da correggere perché spesso il prompt esiste solo nella cronologia chat di qualcuno o in un documento obsoleto. Un prompt usa-e-getta che martedì ha prodotto risultati eccellenti venerdì non è più riproducibile, perché non sai dire con precisione cosa conteneva.

Le ricette di prompt risolvono questo problema come le funzioni risolvono la logica copiata e incollata. Hanno una struttura fissa, slot con nome e identificatori stabili, così puoi citarle in seguito. Quando l'output cambia, hai qualcosa da confrontare.

I vantaggi pratici si vedono subito:

• Coerenza tra le chiamate. La stessa ricetta con gli stessi input produce composizioni e stili confrontabili; è essenziale quando una pagina deve renderizzare dodici immagini di card in una griglia.
• Iterazione a basso costo. Modifichi un solo slot alla volta, invece di riscrivere prosa libera e disordinata perdendo le parti che funzionavano.
• Tracciabilità. Le ricette hanno versioni. Quando il team del brand chiede perché le miniature sembrano più piatte del mese scorso, puoi fare una ricerca per bisezione.
• Revisionabilità. Le ricette si possono revisionare in una pull request come qualsiasi altra risorsa, e chi revisiona non deve necessariamente guadagnarsi da vivere scrivendo prompt.

Il resto di questo articolo è un manuale. Ogni ricetta segue lo stesso scheletro, così puoi leggerne una, adattarla e inserirla nel tuo codebase senza rifattorizzare. Tratta il modello come un componente e la ricetta come l'interfaccia che costruisci sopra di esso.

Un concetto da tenere a mente: una ricetta non è un incantesimo magico. È il contratto tra lo slot dell'interfaccia a valle e la chiamata di generazione. Lo slot dell'interfaccia decide il formato; la ricetta decide con cosa riempirlo.

Lo scheletro di base del prompt

Ogni ricetta di questo manuale è costruita sullo stesso scheletro in quattro parti. Copia questo e riempi gli slot:

[soggetto] — [composizione] — [stile] — [vincoli]

L'idea centrale è tutta qui. Sotto c'è una versione compilata, pronta da incollare e usare:

A lone ceramic coffee cup on a pale oak desk, three-quarter view, shallow depth of field,
soft morning light from the left, minimal editorial product photography, muted warm palette,
no text, no logos, no hands, centered subject with breathing room on all sides

Il ruolo di ogni slot

Soggetto è l'unica cosa di cui parla l'immagine. Nominalo in modo specifico: "tazza di caffè in ceramica", non "atmosfera da caffè". Se il soggetto ha un'azione o uno stato, mettila qui: "uno sviluppatore a metà della digitazione sulla tastiera davanti a una scrivania in penombra". Resisti alla tentazione di aggiungere un secondo soggetto; è la causa più comune di risultati confusi.

Composizione controlla il formato. Angolazione (vista a tre quarti, dall'alto, ad altezza occhi), posizione del soggetto (centrato, terzo sinistro), ritaglio (campo intero, ritaglio stretto) e profondità di campo stanno qui. Questo è lo slot in cui codifichi l'intento di proporzione con le parole, anche se la proporzione effettiva è un parametro separato.

Stile è un breve vocabolario visivo: mezzo (fotografia, vettoriale piatto, acquerello), luce (morbida luce mattutina, controluce netta), tonalità (toni caldi tenui, monocromatico ad alto contrasto) e texture (opaca, lucida, granulosa). Tienilo entro una o tre frasi brevi. Blocchi di stile più lunghi tendono a combattersi a vicenda.

Vincoli sono lo spazio negativo. Cosa non deve apparire: testo, loghi, filigrane, arti in più, sfondi disordinati, ombre dure. I vincoli sono un'assicurazione a basso costo, ed è la prima parte da espandere quando una ricetta dà problemi.

Due varianti da tenere sempre a portata

Foto di oggetto minimale:

[oggetto] su uno sfondo continuo [colore], centrato, vista frontale, luce da studio morbida e uniforme,
fotografia commerciale pulita di prodotto, nessuna ombra sullo sfondo, niente testo, nessun oggetto di scena

Foto di scena editoriale:

[soggetto della scena] in [ambiente], ampia vista d'insieme, luce naturale, sottile grana analogica,
fotografia documentaria, palette tenue, niente testo, niente loghi, nessun marchio visibile

Entrambe restano volutamente brevi. Se il tuo prompt è una pila di aggettivi, probabilmente hai fatto cadere lo slot della composizione da qualche parte dentro.

Scegli le proporzioni prima di scrivere il prompt

Scrivi il prompt dopo aver capito la forma del buco da riempire. Le proporzioni sono una decisione di prodotto, non di prompt; sceglierle tardi ti costringe a riscrivere frasi di composizione già messe a punto.

Una mappatura semplice che copre la maggior parte delle interfacce:

• Banner hero e intestazioni di pagina — formato largo. Linguaggio di composizione: "ampia vista d'insieme", "orizzonte collocato nel terzo inferiore", "spazio negativo a sinistra per il titolo sovrapposto".
• Card e tasselli di griglia — quadrato o quasi quadrato. Linguaggio di composizione: "soggetto centrato", "margini uniformi", "nessun dettaglio importante vicino ai bordi".
• Avatar e piccole immagini di profilo — quadrato, ritaglio stretto, soggetto singolo. Linguaggio di composizione: "testa e spalle", "volto centrato", "sfondo semplice".
• Miniature e righe di elenco — ritaglio largo o quadrato di piccole dimensioni, il soggetto deve restare riconoscibile dopo il ridimensionamento. Linguaggio di composizione: "un unico soggetto dominante", "alto contrasto rispetto allo sfondo", "nessun dettaglio fine".
• Contenuti editoriali o immagini per testi lunghi — formato verticale. Linguaggio di composizione: "composizione verticale", "il soggetto occupa i due terzi superiori", "ancora in primo piano nella parte inferiore".

Perché la formulazione deve corrispondere al formato

Una frase di composizione scritta per un banner largo ("spazio negativo a sinistra") non ha senso una volta ritagliata in un quadrato; un ritaglio verticale stretto descritto a parole, se chiedi un formato largo, verrà compresso. Prompt e proporzione devono essere coerenti, perché stai descrivendo due volte lo stesso rettangolo: una volta con il linguaggio, una volta con un parametro.

Flusso di lavoro pratico

1. Guarda lo slot effettivo dell'interfaccia, annota le sue proporzioni e come viene ritagliato su schermi piccoli.
2. Scegli la proporzione supportata più vicina, invece di chiedere al modello di falsificarla con margini bianchi.
3. Scrivi lo slot di composizione attorno a quel formato, incluso dove deve cadere lo spazio negativo.
4. Dopo la generazione controlla il ritaglio nel caso peggiore (mobile, griglia ridotta), non quello ideale.

Se una ricetta deve servire due slot molto diversi, fanne due ricette. Copiare una ricetta costa meno che scrivere una frase di composizione che funzioni a metà ovunque.

Blocchi di indizi di stile sostituibili per interfaccia

Lo slot dello stile è la parte che dovresti aspettarti di modificare più spesso, quindi rendilo modulare. Scrivi gli indizi di stile come un blocco autocontenuto, agganciato allo scheletro di base, e conservane uno per interfaccia o per tono di brand.

Brand-safe / neutro

fotografia editoriale minimale, luce morbida diffusa, palette neutra tenue,
sfondo pulito, incentrato sul prodotto, niente testo, niente loghi

Per pagine marketing, dove l'immagine non deve competere con il testo né suggerire rivendicazioni di brand.

Fotografico / documentario

luce naturale, fotografia documentaria, profondità di campo ridotta, grana sottile,
soggetto non in posa, colori realistici, nessun filtro pesante

Per immagini editoriali e interfacce narrative, dove il realismo funziona meglio della rifinitura.

Illustrazione piatta

illustrazione vettoriale piatta, palette limitata a due colori, forme semplici e audaci,
nessun gradiente, ampio spazio bianco, composizione geometrica, niente testo

Per onboarding, stati vuoti e documentazione, dove l'immagine deve corrispondere al design system.

Foto prodotto da studio

sfondo da studio continuo, luce principale morbida e uniforme, ombre nette, alto dettaglio sul soggetto,
fotografia da catalogo commerciale, nessun oggetto di scena, niente testo

Per cataloghi prodotti e griglie di confronto, dove la coerenza tra più immagini conta più di qualsiasi singola immagine.

Come cambiare senza degradare

• Tratta il blocco di stile come una variabile, non intrecciarlo mai con le frasi di soggetto o composizione. Se le parole di stile sono sparse nel prompt, non puoi sostituirle in modo pulito.
• Cambia un solo blocco alla volta e rigenera con lo stesso soggetto e la stessa composizione. Se due variabili cambiano insieme, non puoi capire quale abbia causato il cambiamento.
• Attenzione ai blocchi di stile che introducono di nascosto la composizione. "Centrato" e "primo piano" appartengono alla composizione, non allo stile; se vivono nel blocco di stile, il tuo lavoro sulle proporzioni viene annullato silenziosamente.
• Pota i blocchi che continuano a gonfiarsi. Tre frasi di stile di solito bastano; con cinque iniziano a competere tra loro.

Un test utile: sostituisci il blocco di stile su una ricetta per il resto identica e guarda se l'output si adatta ancora allo stesso slot dell'interfaccia. Se sì, il blocco è ben isolato.

Parametrizzare i prompt nel codice

Le ricette devono esistere come template, non come stringhe letterali sparse nei vari gestori. Un template con variabili con nome ti regala gratis A/B test, rollback e override per interfaccia.

Forma del template

RECIPE = {
    "id": "product-hero-v3",
    "template": (
        "{subject} — {composition} — {style} — {constraints}"
    ),
    "defaults": {
        "composition": "centered subject, generous margins, eye-level view",
        "style": "minimal editorial photography, soft diffused light, muted neutral palette",
        "constraints": "no text, no logos, no watermark, clean background",
    },
    "aspect_ratio": "1:1",
}


def render(recipe, **overrides):
    slots = {**recipe["defaults"], **overrides}
    return recipe["template"].format(**slots)

L'oggetto ricetta porta con sé il suo identificatore (id), il formato (aspect_ratio) e i valori predefiniti. Il chiamante fornisce solo le parti che differiscono. Questo mantiene breve il punto di chiamata e rende evidente a colpo d'occhio la differenza tra due interfacce.

Varianti per gli A/B test

Modella le varianti come override sulla ricetta di base, non come stringhe biforcate:

variants = {
    "control": {},
    "warm": {"style": "minimal editorial photography, warm afternoon light, muted warm palette"},
    "tight": {"composition": "tight crop, subject fills the frame, eye-level view"},
}

Poiché ogni variante condivide soggetto e vincoli, la differenza nei risultati è attribuibile allo slot che hai modificato. È tutto qui il valore dell'esercizio.

Rollback e fissaggio

• Dai una versione a ogni ricetta nell'id e registrala in ogni richiesta di generazione. Quando l'output cambia, i log ti dicono quale versione della ricetta ha prodotto cosa.
• Mantieni le versioni precedenti indirizzabili per un certo periodo. Un rollback deve essere un cambio di configurazione, non un ripristino del codice sotto pressione.
• Quando passi i dati al tuo sistema di analytics usa l'id della ricetta, non la stringa renderizzata, così puoi raggruppare i risultati per ricetta invece che per testo esatto del prompt.
• Valida gli slot prima di chiamare l'API: un subject vuoto deve fallire rapidamente nella tua app, non produrre un'immagine vaga.

Tratta le proporzioni come un parametro di prima classe accanto al template, perché è deciso dallo slot dell'interfaccia e non dal testo del prompt. Tutto ciò che serve all'API dovrebbe derivare da un oggetto ricetta, così ogni interfaccia ha un'unica fonte di verità.

Modalità di errore comuni e come fare debug

La maggior parte degli output scadenti è riconducibile a uno slot. Usa questa lista per decidere quale parte dello scheletro regolare prima di riscrivere l'intero prompt.

Soggetto tagliato o fuori campo

Sintomo: testa tagliata, oggetto che sborda dai bordi, dettaglio importante fuori dalla zona sicura.

Correggi prima lo slot composizione, non lo stile. Aggiungi un linguaggio di inquadratura esplicito ("soggetto intero nel campo", "margini ampi su tutti i lati") e verifica che le proporzioni corrispondano al formato previsto. Se il soggetto è alto e lo slot è largo, il formato è sbagliato, non il prompt.

Risultati confusi

Sintomo: più punti focali in competizione, sfondi affollati, oggetti di scena che non avevi chiesto.

Correggi lo slot soggetto. Riduci a un soggetto, uno stato. Sposta nei vincoli come esclusioni qualsiasi cosa potrebbe essere letto come oggetto di scena. La confusione è di solito soggetto vago, non modello troppo entusiasta.

Stile incoerente in un lotto

Sintomo: nella griglia alcune immagini sembrano fotografie, altre illustrazioni; la tonalità deriva.

Correggi il blocco stile. Accorcialo a un mezzo, una frase di luce, una frase di tonalità. Rimuovi le parole di stile che sfuggono in altri slot e separa le ricette che servono due interfacce diverse. L'incoerenza in un lotto è spesso sintomo di un blocco di stile diverso a ogni chiamata.

Compare testo o un logo

Sintomo: lettere senza senso, filigrane false, marchi simili a loghi.

Espandi i vincoli: "niente testo, niente lettering, niente loghi, niente filigrane, nessuna insegna". Se la composizione suggerisce un supporto che di solito porta testo (schermo, packaging, poster), dichiaralo esplicitamente o cambia la composizione.

L'output ignora l'emozione richiesta

Sintomo: l'immagine è corretta ma risulta piatta, rigida o generica.

Correggi il blocco stile, una frase alla volta. La luce è di solito la modifica con più leva; la tonalità viene dopo. Rigenera con lo stesso soggetto e la stessa composizione, così il confronto è onesto.

Tutti gli altri casi

Se entrambi gli slot sembrano sospetti, cambiane uno e rigenera. Se il risultato è ancora sbagliato, fai un passo indietro e controlla se la ricetta è stata chiamata a servire uno slot dell'interfaccia per cui non è mai stata scritta: è un disallineamento di prodotto, non un difetto del prompt.

Pubblicare la libreria di ricette

Una volta che le ricette diventano template con versione, diventano asset che il team mantiene insieme al codice. L'obiettivo è che chiunque possa trovare la ricetta dietro un'interfaccia, capire perché è fatta così e modificarla in sicurezza.

Organizza per interfaccia, non per testo del prompt

Raggruppa le ricette per luogo di rendering: hero, card, avatar, thumbnail, editorial-figure. Uno sviluppatore che guarda la pagina dei prezzi deve arrivare alla ricetta usata da quella pagina, non a un elenco alfabetico di aggettivi. Dai a ogni ricetta un id stabile e un suffisso di versione, e tieni i valori predefiniti dentro l'oggetto ricetta.

Revisiona le ricette nelle pull request

Tratta le modifiche alle ricette come modifiche ai componenti. Il diff deve mostrare quale slot si è mosso e perché. Chi revisiona può fare domande utili: la composizione corrisponde ancora al formato, le parole di stile sono sfuggite nella composizione, i vincoli si sono ridotti? I diff piccoli, su un solo slot, sono facili da revisionare; le riscritture integrali no.

Versionamento, logging e pulizia

• Registra l'id e la versione della ricetta in ogni richiesta di generazione, così i cambiamenti di output sono riconducibili a una modifica.
• Mantieni indirizzabili le versioni deprecate finché nessuna interfaccia le referenzia, poi rimuovile in un giro di pulizia, invece di lasciare ricette morte per sempre.
• Quando aggiungi varianti, promuovi la vincitrice come nuova versione, invece di lasciare il ramo A/B come percorso permanente.

Documenta il contratto

Per ogni ricetta documenta lo slot dell'interfaccia previsto, le proporzioni e i vincoli che non vanno rimossi. Due frasi bastano. La prossima persona che tocca questa ricetta deve sapere cosa non le è permesso rompere.

Mantieni il ciclo breve

Le ricette marciscono quando nessuno le rigenera dopo un cambio di design. Collega un piccolo passaggio di revisione a qualsiasi lavoro sull'interfaccia che modifichi uno slot immagine, e rigenera le ricette interessate come parte di quella modifica. Il sistema resta a basso costo solo se il ciclo di feedback resta breve.

Parti dallo scheletro di base, aggiungi un blocco di stile per interfaccia, e lascia che la libreria di ricette cresca da slot reali invece che ipotetici. Se stai integrando la generazione nella tua app, mantieni leggeri i punti di chiamata e lascia che sia l'oggetto ricetta a portare le decisioni.