Ricette di prompt per la generazione di immagini con Recraft v4 Styles: prompt copiabili e output reali

Anatomia della struttura dei prompt di recraft-v4-styles

Ogni team che consegna immagini generate prima o poi si scontra con lo stesso muro: qualcuno ha rifinito con cura un prompt, ha ottenuto un risultato sorprendente una volta, l'ha incollato distrattamente in un blocco note e sei settimane dopo nessuno riesce a riprodurre quel risultato. Quel prompt era calibrato per una singola esecuzione, senza alcuna registrazione di quali parole avessero davvero funzionato. Non appena cambiano modello, parametri o membri del team, i risultati derivano, e non c'è una baseline a cui tornare.

Le ricette di prompt risolvono questo problema: trattano il prompt come un artefatto strutturato e versionato, non come una stringa esoterica. Una ricetta scompone le parti del prompt che svolgono ruoli diversi — soggetto, riferimento di stile, tonalità e vincoli — così ogni parte può essere modificata consapevolmente e in modo isolato. Questa struttura offre tre cose che agli sviluppatori interessano davvero:

• Riproducibilità. Con una ricetta fissa, parametri fissi e un seed fisso, il team può rigenerare mesi dopo un'immagine comparabile.
• Testabilità. Puoi fare un confronto A/B tra due ricette che differiscono solo in uno slot e attribuire la differenza a quello slot.
• Costo di onboarding. I nuovi membri leggono la libreria di ricette invece di dover decifrare a ritroso l'intuito di qualcuno.

Questa guida è organizzata come un libro di ricette, pensato per recraft-v4-styles/text-to-image. Ogni sezione di ricetta fornisce pattern di prompt copiabili per un compito specifico: guida tramite riferimento di stile, tonalità illustrativa, tonalità fotografica. Le ultime sezioni spiegano come leggere gli output reali, iterare una variabile alla volta e richiamare le ricette nel codice applicativo tramite un'interfaccia modello unificata.

I prompt qui presenti sono punti di partenza, non garanzie. I modelli di immagine sono sensibili alla formulazione, e piccole modifiche possono spostare visibilmente l'output. Tratta ogni ricetta come una base che devi adattare e rimisurare.

Una nota sulla struttura dei prompt: separa gli slot con delimitatori chiari (punti, interruzioni di riga o segmenti etichettati), così tu e il tuo team potete leggere il prompt come una specifica, non come un testo in prosa.

Come usare questo libro di ricette

1. Scegli la ricetta che corrisponde al tipo di output desiderato (guida di stile, illustrazione o fotografia).
2. Copiala, sostituisci il soggetto nello slot del soggetto e fai una prima esecuzione come baseline.
3. Confrontala con la tua intenzione (vedi "Leggere gli output reali e iterare").
4. Regola un solo slot alla volta e registra la modifica accanto all'output.

Questo ciclo — ricetta, esecuzione, confronto, una sola modifica — è la disciplina centrale su cui si basa il resto dell'articolo.

Ricetta di guida tramite riferimento di stile

Ricetta per la tonalità illustrativa

La guida tramite riferimento di stile è la parte di recraft-v4-styles che richiede i prompt più rigorosi. L'obiettivo è far ereditare al risultato l'aspetto del riferimento — la sua palette, la qualità del tratto, la resa — senza copiarne il contenuto letterale. L'approccio affidabile è descrivere le proprietà visive del riferimento a parole e collocarle in uno slot separato, mantenendo distinto lo slot del soggetto.

Ricetta S1 — Guida tramite riferimento basata su attributi

soggetto: una volpe seduta nell'erba alta, vista di tre quarti
riferimento di stile: palette tenue di colori naturali, morbidi lavaggi ad acquerello, grana della carta visibile, contorni sottili e irregolari, ombre a basso contrasto, nessun nero pieno
tonalità: illustrazione calma e naturalistica
composizione: soggetto centrato, ampio spazio negativo sopra
vincoli: nessun testo, nessuna firma, nessuna cornice

Questa è la ricetta più trasferibile: non stai incollando un'immagine di riferimento, stai descrivendo ciò che rende riconoscibile il riferimento. Resiste meglio agli aggiornamenti del modello rispetto alla copia del nome di uno stile.

Ricetta S2 — Intensità del riferimento, tocco leggero

soggetto: una teiera in ceramica su una mensola di legno
riferimento di stile: un omaggio sottile all'arte poster di metà secolo — forme semplificate, palette bicolore, leggera texture di stampa
tonalità: sobria, piatta
vincoli: sfondo a tinta unita, nessun gradiente, nessun testo

Nota la formulazione "omaggio sottile". L'intensità della guida è in gran parte una questione di formulazione: un linguaggio vago ("omaggio sottile", "liberamente ispirato a", "un lieve richiamo a") mantiene il soggetto dominante, mentre un linguaggio forte ("adotta con forza lo stile di…", "dominato da…") fa prendere il sopravvento al riferimento.

Ricetta S3 — Riferimento dominante, soggetto secondario

riferimento di stile: audace arte vettoriale piatta, forme geometriche spesse, palette complementare ad alta saturazione, bordi netti, nessuna texture
soggetto: una catena montuosa, semplificata in triangoli sovrapposti
tonalità: da poster, sicura
vincoli: nessun testo, nessun gradiente, nessun dettaglio fotografico

Quando è il riferimento a dover dominare, mettilo per primo e descrivi il soggetto come già tradotto nel linguaggio visivo del riferimento ("semplificata in triangoli sovrapposti"). Questo evita un errore comune: il soggetto mantiene dettagli fotografici mentre lo sfondo diventa piatto.

Cambiare l'intensità senza riscrivere il tutto

Mantieni gli slot soggetto, tonalità, vincoli e composizione identici byte per byte, e modifica solo la frase di guida nello slot del riferimento di stile:

• un lieve richiamo a → omaggio sottile a → in sintonia con lo spirito di → adotta con forza lo stile di

Registra ogni variante insieme al suo output. Dopo tre o quattro esecuzioni saprai quale frase è più vicina all'intenzione per quel riferimento, e la bloccherai nella ricetta.

Trappole comuni

• Nominare un marchio o un artista vivente come riferimento di stile spesso produce risultati incoerenti e talvolta evasivi. Descrivi invece le proprietà.
• Mescolare due riferimenti nello stesso slot porta a una mediazione. Se serve una combinazione, scrivi due segmenti di riferimento chiaramente etichettati e indica quale domina.
• Omettere i vincoli invita artefatti testuali, firme e cornici.

Ricetta per la tonalità fotografica

Gli output illustrativi e quelli fotografici rispondono a sistemi lessicali diversi. Ragiona in termini di linee, forme, texture e modellazione chiaroscurale, non di obiettivi e luce. Le ricette seguenti presuppongono che tu abbia già inserito il tuo contenuto nello slot del soggetto.

Ricetta I1 — Vettoriale piatto, palette minimale

soggetto: un corriere in bicicletta
tonalità: illustrazione vettoriale piatta
riferimento di stile: riempimenti a tinta unita, palette bicromatica più un colore d'accento, spessore del tratto uniforme, forme geometriche arrotondate, nessun gradiente, nessuna texture
composizione: vista laterale, linea d'orizzonte semplice, sfondo a tinta unita
vincoli: nessun testo, nessuna ombra, nessun contorno doppio

Le ricette di tipo piatto sono le più facili da mantenere coerenti in una serie, perché il loro lessico è binario: nessun gradiente, nessuna texture, spessore del tratto uniforme. Usa la stessa formulazione per ogni elemento di un set di asset.

Ricetta I2 — Line art disegnata a mano

soggetto: una pianta da interno in un vaso di terracotta
tonalità: illustrazione a inchiostro disegnata a mano
riferimento di stile: linee a inchiostro sottili e a spessore variabile, leggero tremolio, ombreggiature radi a tratteggio incrociato, sfondo bianco sporco, un'unica velatura di colore d'accento
composizione: centrata, soggetto interamente inquadrato, margine ridotto
vincoli: nessun testo, nessun riempimento a colori tranne la velatura d'accento

Le parole che contano davvero sono spessore variabile, tremolio e tratteggio incrociato rado. Toglile e otterrai una line art generica; mantienile e l'output si legge come disegnato, non come ricalcato.

Ricetta I3 — Illustrazione materica e chiaroscurata

soggetto: un faro su una costa rocciosa al crepuscolo
tonalità: illustrazione pittorica con texture di pennellate visibili
riferimento di stile: pennellate spesse e opache, forme d'ombra stratificate, transizione cromatica dal caldo al freddo, grana della tela, bordi selettivamente ammorbiditi
composizione: orizzonte basso, faro spostato a destra del centro
vincoli: nessun testo, nessun fotorealismo, nessun bagliore da obiettivo

Per le illustrazioni chiaroscurate, specifica come è costruito il chiaroscuro — forme stratificate, tratteggio incrociato o velature morbide — invece di limitarti a dire "con ombre". Parole vaghe sul chiaroscuro producono mezzitoni fangosi.

Ricetta I4 — Illustrazione tecnica isometrica

soggetto: la disposizione interna di un piccolo caffè
tonalità: illustrazione tecnica isometrica
riferimento di stile: proiezione isometrica a 30 gradi, tinte piatte, contorni sottili e coerenti, forme di arredi semplici e ripetute, nessuna distorsione prospettica
composizione: scena completa, sfondo neutro, illuminazione uniforme
vincoli: nessuna etichetta testuale, nessuna figura umana, nessun'altra ombra oltre a semplici ombre proiettate

Le ricette isometriche falliscono spesso perché si insinua un linguaggio prospettico. Specifica esplicitamente il tipo di proiezione e vieta i termini fotografici.

Tabella rapida del lessico

• Linee: spessore del tratto uniforme, variabile, affusolato, tremolio disegnato a mano, bordi netti.
• Forme: geometriche, arrotondate, semplificate, triangoli sovrapposti, priorità alla silhouette.
• Texture: grana della carta, grana della tela, texture di stampa, nessuna.
• Chiaroscuro: riempimenti piatti, bicromia, tratteggio incrociato, forme d'ombra stratificate, velature morbide.

Leggere gli output reali e iterare

Le ricette fotografiche si basano su luce, resa dell'obiettivo, materiali e inquadratura. Le stesse parole di soggetto che producono illustrazioni pulite produrranno "foto" piatte se non si aggiungono slot fotografici. Mantieni breve lo slot della tonalità e metti le caratteristiche tecniche nello slot del riferimento di stile.

Ricetta P1 — Luce naturale morbida, taglio editoriale

soggetto: una ciotola di agrumi su una tovaglia di lino
tonalità: fotografia food editoriale
riferimento di stile: luce morbida e diffusa da finestra proveniente da sinistra, profondità di campo ridotta, campo visivo equivalente a 50mm, colori naturali, alte luci attenuate con delicatezza, grana sottile
composizione: ripresa dall'alto di tre quarti, soggetto leggermente fuori centro
vincoli: nessun testo, nessun oggetto di scena oltre il bordo, nessuna alta luce abbagliante

La direzione della luce è la frase con la leva maggiore. Specificare la fonte e la direzione ("luce morbida e diffusa da finestra proveniente da sinistra") dà risultati più stabili rispetto a "bella luce".

Ricetta P2 — Luce dura, nitidezza da prodotto

soggetto: un altoparlante wireless nero opaco su una superficie di cemento
tonalità: fotografia di prodotto in studio
riferimento di stile: un'unica luce principale dura proveniente dall'alto a destra, bordi d'ombra netti, dettagli puliti a livello macro, sfondo grigio neutro, leggera separazione del contorno, nessuna dominante cromatica
composizione: centrato, ad altezza occhi, formato quadrato
vincoli: nessun testo, nessun riflesso da studio, nessuna polvere

Le parole sui materiali sono cruciali qui — opaco, cemento, grigio neutro — perché il modello ne deduce la risposta della superficie. Se il materiale non è reso correttamente, cambia prima le parole sul materiale, poi la luce.

Ricetta P3 — Documentario con luce ambiente

soggetto: una bancarella di un mercato notturno, il venditore che sistema la merce
tonalità: fotografia documentaria di strada
riferimento di stile: luce ambiente, temperature di colore miste, grana visibile, leggero motion blur sulle figure di sfondo, campo visivo equivalente a 35mm, profondità di campo profonda ma imperfetta
composizione: scatto rubato, ad altezza occhi, soggetto parzialmente incorniciato dal bordo della bancarella
vincoli: nessuna sovrimpressione testuale, nessuna espressione impostata, nessuna luce da studio

Le ricette documentarie hanno bisogno di parole permissive: scatto rubato, luce ambiente, messa a fuoco imperfetta. Senza queste, il modello ripiega su un aspetto rifinito e impostato.

Ricetta P4 — Paesaggio, compressione tele

soggetto: creste montuose stratificate all'alba
tonalità: fotografia di paesaggio
riferimento di stile: compressione tele, foschia atmosferica crescente con la distanza, ombre fredde e alte luci calde, elevata gamma dinamica ma cielo pulito, nessun rumore evidente
composizione: linee di cresta sovrapposte orizzontalmente, orizzonte nel terzo inferiore
vincoli: nessun testo, nessuna figura umana, nessun artefatto di bagliore da obiettivo

Tabella rapida del lessico

• Luce: luce diffusa da finestra, luce principale dura, separazione del contorno, luce ambiente, temperature di colore miste.
• Resa dell'obiettivo: profondità di campo ridotta, compressione tele, campo visivo grandangolare, dettagli puliti a livello macro.
• Materiali: opaco, spazzolato, cemento, lino, risposta speculare e diffusa.
• Inquadratura: ad altezza occhi, dall'alto di tre quarti, fuori centro, posizione dell'orizzonte.

Erogare le ricette tramite un'API aggregata

Una ricetta è utile solo quando puoi giudicare se l'output corrisponde all'intenzione. L'errore che la maggior parte dei team commette è valutare il risultato come "buono" o "cattivo", invece di chiedersi quale slot ha fallito. Prima di guardare l'immagine, annota cosa dovrebbe produrre ciascuno slot:

• soggetto: il contenuto letterale — è presente e descritto correttamente?
• riferimento di stile: il trattamento superficiale — palette, linee, texture, caratteristiche della luce.
• tonalità: il tono generale — calmo, audace, editoriale, da scatto rubato.
• composizione: la posizione degli elementi nell'inquadratura.
• vincoli: gli elementi negativi — nessun testo, nessun gradiente, nessun oggetto di scena aggiuntivo.

Poi confronta l'immagine riga per riga. Un risultato con il soggetto corretto ma la texture sbagliata non è un fallimento della ricetta, è un fallimento della frase sulla texture. È proprio questa distinzione a rendere rapida l'iterazione.

La regola della singola variabile

Cambia un solo slot per esecuzione, tenendo tutto il resto fisso — inclusi i parametri e, quando supportato, il seed. Se cambi due cose e l'output migliora, non hai imparato nulla di riproducibile.

Un ciclo pratico:

1. Esegui la ricetta così com'è. Salva l'output insieme al testo completo della ricetta e ai parametri.
2. Valuta ogni slot come superato/fallito in base all'intenzione che hai annotato.
3. Scegli lo slot peggiore.
4. Modifica solo quello slot — rifinisci il lessico, aggiungi vincoli o rimuovi frasi contraddittorie.
5. Riesegui. Confronta fianco a fianco con l'output precedente.
6. Quando uno slot passa, blocca quella formulazione e passa allo slot peggiore successivo.

Riconoscere i pattern di fallimento comuni

• Perdita di vincoli. Testo o firme compaiono nonostante il vincolo "nessun testo". Di solito la causa è che una frase del soggetto o della tonalità suggerisce la tipografia, come "poster" o "etichetta". Rimuovi quel suggerimento invece di limitarti a ripetere le parole negative.
• Mediazione degli stili. Due riferimenti si fondono in una poltiglia. Scegli un riferimento dominante e degrada l'altro a modificatore.
• Conflitto tra slot. Lo slot del soggetto descrive la resa ("una volpe ad acquerello") e anche lo slot dello stile descrive la resa. Non far entrare il linguaggio della resa nello slot del soggetto.
• Iperspecificazione. Prompt lunghi stipati di decine di aggettivi diluiscono ciascuno di essi. Se una frase non ha un effetto misurabile, eliminala.

Costruire una libreria di ricette

Salva ogni ricetta come testo strutturato, con numero di versione, set di parametri utilizzato, seed quando fissato e un link ai suoi output. Tratta le modifiche alle ricette come modifiche al codice: registra cosa è cambiato e perché. Quando in futuro farai un confronto A/B tra due ricette, le differenze dovrebbero essere solo quelle che intendevi, con seed e parametri fissati per garantire un confronto equo.

Anche con tutto fisso, una certa variabilità è normale — tratta la ricetta come una baseline riproducibile, non come una garanzia bit per bit, e tieni i log degli output accanto alle ricette per mantenere onesto il confronto.

Erogare le ricette tramite un'API aggregata

Una volta stabilizzata, una ricetta deve passare nel codice — non restare in un documento condiviso che deriva. L'obiettivo è rendere il prompt un valore versionato, assemblato, inviato e registrato dalla tua applicazione, e sostituibile senza riscritture.

Assemblare il prompt dagli slot

Salva ogni slot come campo separato e concatenali al momento della richiesta. Questo ti permette di variare un solo slot nei test senza copiare il resto della stringa:

recipe = {
    "id": "photo-p1-citrus",
    "version": 3,
    "subject": "una ciotola di agrumi su una tovaglia di lino",
    "style": "luce morbida e diffusa da finestra proveniente da sinistra, "
             "profondità di campo ridotta, colori naturali, grana sottile",
    "tone": "fotografia food editoriale",
    "composition": "ripresa dall'alto di tre quarti, soggetto leggermente fuori centro",
    "constraints": "nessun testo, nessuna alta luce abbagliante",
}

prompt = "。".join(
    [recipe["subject"], recipe["tone"], recipe["style"],
     recipe["composition"], recipe["constraints"]]
)

id e version sono la chiave: ogni immagine generata dovrebbe essere riconducibile alla revisione esatta della ricetta che l'ha prodotta.

Passare i parametri in modo coerente

Fissa in un oggetto di configurazione per ogni ricetta i parametri che influenzano la riproducibilità — dimensioni, seed quando supportato e qualsiasi controllo di stile o intensità esposto dal modello — invece di spargerli nei vari punti di chiamata. In un confronto A/B dovrebbe cambiare solo il numero di versione.

Instradare tramite un'unica API

Invia le richieste attraverso l'endpoint unico e compatibile con OpenAI di HiAPI.ai, invece di integrare separatamente ogni fornitore di modelli. Così, quando il modello dietro recraft-v4-styles/text-to-image cambia, il codice delle tue ricette resta stabile; e puoi testare una ricetta con un altro modello cambiando l'identificatore del modello — senza nuovi SDK, senza nuovi flussi di autenticazione, senza riscrivere la logica di assemblaggio del prompt. Punta il client su https://api.hiapi.ai/v1 e mantieni la gestione delle versioni delle ricette nel tuo codice.

Registrare ciò che conta davvero

Per ogni generazione, registra l'id e la versione della ricetta, la stringa del prompt risolta, ogni parametro, il riferimento dell'immagine restituita e una riga di intento. Questo log è il tuo strumento per i test A/B e anche la pista di debug quando futuri aggiornamenti del modello sposteranno gli output.

Copiare e incollare una ricetta come baseline, iterare uno slot alla volta, poi bloccarla in un record versionato ed erogarla tramite HiAPI.ai — è proprio questo flusso di lavoro che trasforma un prompt fortunato in una pipeline affidabile.