HiAPI
Blog

Guida all'uso

Ricette di prompt per Flux-1 Kontext Max: prompt di editing copiaincolla che funzionano davvero

I modelli di formulazione delle istruzioni che puoi incollare oggi stesso in Kontext Max, e come iterare quando la prima modifica non va a segno

Nov 3, 2026
Article cover: flat marbled liquid forms in celadon and slate folding over a dark ink field.

L'essenza delle ricette di prompt per Kontext Max

Una ricetta di prompt non è un testo descrittivo: è un formato di istruzione compatto che dice al modello con precisione cosa cambiare e cosa preservare. Per Flux-1 Kontext Max, ogni ricetta affidabile che usiamo segue la stessa struttura in quattro parti:

  • Verbo: il tipo di operazione: sostituire, rimuovere, ricolorare, aggiungere, estendere, ristilizzare.
  • Obiettivo: la regione o l'oggetto su cui agisce il verbo, da nominare esplicitamente ("la giacca rossa indossata dalla persona a sinistra").
  • Modifica desiderata: lo stato finale, non il processo ("rendila blu navy" invece di "cambia il colore").
  • Clausola di conservazione: ciò che deve restare esattamente identico ("mantieni le stesse pieghe del tessuto, l'illuminazione e lo sfondo").

Quindi una ricetta si legge così: replace the jacket on the person at left with a navy wool coat; keep pose, lighting, and background unchanged.

Il modello mentale chiave: Kontext Max è un editor, non un generatore. Parte dalla tua immagine di input e applica un differenziale (diff). Più piccolo è il differenziale e più precisi sono i confini, più il risultato è prevedibile. I prompt che somigliano a descrizioni di generazione immagini ("un ritratto suggestivo di una donna in una città notturna") danno al modello la libertà di rigenerare tutto, e lo farà.

La clausola di conservazione è la parte che quasi tutti saltano, ed è quella che conta di più. Senza di essa, il modello considera il resto dell'immagine come modificabile a piacere. Con essa, di fatto disegni una maschera in linguaggio naturale: cosa utile, perché non devi mai costruire una maschera a mano.

La ricetta scompone il prompt in flussi di input distinti che confluiscono in un unico passaggio di editing.

Le regole di formulazione che cambiano il risultato

Queste sono le leve che puoi controllare a livello di prompt. Ognuna spinge il risultato in modo affidabile verso una direzione prevedibile.

Usa l'imperativo, non la descrizione

Scrivi "rimuovi il cestino in basso a destra", non "c'è un cestino che non dovrebbe essere lì". Il modo imperativo corrisponde direttamente all'operazione di editing. Il modo descrittivo suona come una didascalia di scena e invita alla rigenerazione.

Nomina l'obiettivo, non l'intera immagine

"Il cartello sopra la porta" è meglio di "il testo nell'immagine". Se nella tua immagine ci sono tre cartelli, specifica quale ("il cartello di legno appeso sopra l'ingresso a sinistra"). Gli ancoraggi spaziali (sinistra, destra, sopra, primo piano, dietro il soggetto) non costano quasi nulla e eliminano gran parte dell'ambiguità.

Un solo intervento per istruzione

Se servono due modifiche, concatenale con un punto e virgola solo se agiscono sulla stessa regione: remove the chair; keep the floorboards and shadows beneath it. Le modifiche non correlate vanno in chiamate separate. Accumulare modifiche non correlate in un unico prompt è la causa più comune di danni collaterali.

Ordine: prima i vincoli, poi lo stile

Metti i vincoli di conservazione e di ambito prima di qualsiasi aggettivo opzionale. Keep the background, wardrobe, and expression unchanged; restyle the lighting to soft window light funziona. Invece Restyle to soft cinematic lighting, keep background unchanged fa sì che la resa cinematografica si propaghi a tutta l'immagine. Il modello tratta ciò che legge per ultimo come cornice di riferimento dominante, quindi chiudi con ciò che non deve muoversi.

Dichiara lo stato finale, non i passaggi

"Rendi il cielo cupo, con nuvole grigie uniformi" è un obiettivo. "Desatura, aggiungi nuvole, riduci il contrasto" è un flusso di lavoro che il modello non eseguirà alla lettera e potrebbe applicare in eccesso. Descrivi il risultato che vuoi vedere.

Evita le negazioni quando esiste un obiettivo positivo

"Rimuovi la filigrana" va bene, perché la rimozione è l'operazione stessa. Ma "non farlo diventare sfocato" è più debole di "mantieni il soggetto nitido e a fuoco". Per quanto possibile, esprimi i vincoli come invarianti positive.

Sii conciso

Le ricette che superano le due frasi diluiscono l'istruzione. Se il tuo prompt richiede un intero paragrafo, probabilmente hai due modifiche oppure l'obiettivo è specificato in modo insufficiente.

Ricette copiaincolla per le modifiche più comuni

Ognuna delle ricette seguenti è pronta da incollare. Sostituisci le parti tra parentesi quadre con il tuo caso specifico. Le note di ragionamento spiegano perché la formulazione è costruita così: cogli il pattern, non solo il testo.

Sostituzione di oggetti

replace the [object] at [spatial anchor] with [new object]; keep the surrounding [key surface, e.g. table/floor] and lighting unchanged Ragionamento: l'ancoraggio più la clausola di conservazione rendono la composizione credibile. Nominare la superficie circostante impedisce al modello di ri-renderizzare il contesto.

Rimozione di oggetti

remove the [object] at [spatial anchor]; reconstruct the background behind it to match the surrounding [surface] and fill the shadow naturally Ragionamento: la rimozione richiede di specificare cosa entra al suo posto. Senza "ricostruisci lo sfondo", spesso ottieni una macchia o una toppa incongruente.

Sostituzione dello sfondo

replace the background with [new setting]; keep the subject's silhouette, edge detail, and lighting direction identical Ragionamento: i dettagli dei bordi e la direzione dell'illuminazione sono i punti in cui la sostituzione dello sfondo fallisce. Nominarli esplicitamente li preserva.

Modifica del testo su un cartello

change the text on the [sign/label] to read "[new text]"; keep the font weight, perspective, and material of the sign unchanged Ragionamento: un obiettivo breve e inequivocabile, più il blocco della prospettiva del carattere. Il nuovo testo deve restare breve: è nelle stringhe lunghe che compaiono gli artefatti.

Cambio di colore e materiale

recolor the [object] to [color]; preserve the original texture, folds, and highlight placement Ragionamento: usare "recolor" invece di "change the color to" rende l'istruzione più compatta, e la clausola sulla texture impedisce riempimenti piatti.

Outpainting / estensione

extend the image to the [left/right/top] by roughly [fraction, e.g. one third]; continue the existing [surface, e.g. wall/ground] seamlessly and match the current lighting Ragionamento: nominare la superficie da continuare e l'illuminazione da eguagliare è ciò che distingue un'estensione pulita da una giuntura visibile.

Ritocco di posa o espressione

adjust the subject's expression to a slight smile; keep head angle, hair, and the rest of the face unchanged Ragionamento: "il resto del viso invariato" è la barriera di sicurezza. Se non delimiti i tratti vicini, le modifiche al viso derivano.

Ristilizzazione con limiti di ambito

apply a [style, e.g. watercolor] treatment to the foreground subject only; leave the background photographic and unchanged Ragionamento: i prompt di ristilizzazione sono la principale fonte di applicazione eccessiva. Limitare lo stile a un ambito è obbligatorio, non opzionale.

Ogni ricetta mappa la formulazione sull'ambito dell'editing: dal ritocco localizzato alla riorganizzazione complessiva della stessa forma liquida.

Integrare le ricette nel tuo codice

Le ricette sono stringhe: trattale come tali nel tuo codebase, con parametri e versione.

Parametrizza, non concatenare

Archivia le ricette come modelli con slot nominati, da riempire al momento della chiamata:

RECIPES = {
    "object_replace": "replace the {object} at {anchor} with {replacement}; "
                      "keep the surrounding {surface} and lighting unchanged",
    "object_remove": "remove the {object} at {anchor}; reconstruct the background "
                     "behind it to match the surrounding {surface} and fill the shadow naturally",
}

def build(recipe_key, **slots):
    return RECIPES[recipe_key].format(**slots)

Questo mantiene stabile la formulazione su migliaia di immagini. Se una ricetta deve essere ritoccata, cambi una sola stringa invece di cento punti di chiamata.

Mantieni fissa l'immagine di input a ogni confronto

Quando ottimizzi una ricetta, riusa un'immagine di base. Se cambi sia il prompt sia l'immagine di input, non puoi attribuire la differenza a nessuno dei due.

Valida gli slot prima della chiamata

Un ancoraggio vuoto è peggio di un ancoraggio sbagliato: allarga silenziosamente l'ambito dell'editing. Verifica che ogni slot sia compilato e che gli slot di testo libero (come il nuovo testo di un cartello) siano brevi.

Una sola modifica per richiesta

Poiché in Kontext Max l'editing avviene per chiamata, modella la tua pipeline come una sequenza di passaggi di editing, ciascuno con la propria ricetta e i propri parametri, invece di un unico prompt gigantesco. Un piccolo runner di passaggi che applica le ricette in sequenza è molto più facile da debuggare di un'unica istruzione maxi.

Registra i prompt renderizzati

Registra il prompt dopo il riempimento insieme al riferimento dell'output e alla versione della ricetta. Quando la qualità dell'output cambia, devi sapere se è cambiata la formulazione o il comportamento del modello.

Cosa fare quando il risultato dell'editing è sbagliato

La maggior parte dei fallimenti rientra in tre categorie. Prima diagnostica il sintomo, poi applica la correzione corrispondente.

Sintomo: obiettivo completamente mancato

La modifica avviene altrove, oppure non c'è alcun cambiamento visibile.

  • Amplia e affina l'ancoraggio: "il cartello sopra la porta" → "il cartello di legno appeso sopra l'ingresso a sinistra".
  • Se l'oggetto è piccolo, dillo: "la piccola etichetta in basso a destra".
  • Se il modello ha modificato un oggetto simile, aggiungi un disambiguante: "il più a sinistra dei due cartelli".

Sintomo: editing eccessivo

Hai chiesto una sola modifica, ma il modello ne ha fatte tre.

  • Aggiungi o rafforza la clausola di conservazione: nomina gli elementi esatti che devono restare intatti ("mantieni posa, abbigliamento e sfondo invariati").
  • Sposta i vincoli dopo l'istruzione di modifica, oppure ripetili alla fine: la posizione conta.
  • Separa i prompt accumulati in chiamate distinte.

Sintomo: deriva

L'idea è giusta, ma l'immagine circostante si è spostata: colori, illuminazione o dettagli sono cambiati.

  • Trasforma le richieste di conservazione vaghe in invarianti concrete: invece di "mantieni tutto uguale", scrivi "mantieni il bilanciamento del bianco originale, la direzione delle ombre e la texture del tessuto".
  • Controlla se gli aggettivi di stile si stanno diffondendo; limitali a un ambito ("solo il primo piano").
  • Riduci l'istruzione alla forma minima e ritestala sull'immagine di base.

Il ciclo

Esegui la ricetta → classifica il fallimento come obiettivo mancato, editing eccessivo o deriva → applica la singola correzione corrispondente → riesegui sullo stesso input di base. A ogni iterazione cambia una sola variabile. Se ne cambi due insieme, non puoi sapere quale ha fatto la differenza.

Mantieni un breve registro dei fallimenti: versione della ricetta, prompt riempito, sintomo, correzione, conclusione. Dopo qualche progetto, questo registro varrà più di qualsiasi singolo prompt.

Il ciclo di debug dal sintomo alla correzione: esegui, classifica il fallimento, ritocca la formulazione, riesegui.

Costruisci la tua libreria di ricette

I team che ottengono risultati costanti da Kontext Max non scrivono prompt una tantum migliori: mantengono un piccolo insieme di prompt verificati e versionati.

Versiona esplicitamente le ricette

Assegna a ogni ricetta una chiave e una versione (object_replace@v2). Quando cambi la formulazione, incrementa la versione e mantieni disponibile quella vecchia. Piccoli cambiamenti di formulazione producono output sensibilmente diversi, quindi una libreria di prompt senza gestione delle versioni è una fonte silenziosa di regressioni.

Testa su una suite fissa

Mantieni un piccolo insieme fisso di immagini di input e di modifiche attese note: una sostituzione, una rimozione, una sostituzione di sfondo, una modifica di cartello. Esegui questa suite a ogni modifica di una ricetta. Controlli due cose: se l'obiettivo è stato modificato e se l'immagine circostante è rimasta invariata. Una ricetta eccellente sul primo punto ma fallimentare sul secondo non è pronta.

Confronta le ricette, non tirare a indovinare

Quando due formulazioni sembrano entrambe ragionevoli, eseguile entrambe sullo stesso input di base e tieni quella che rispetta la clausola di conservazione. Confrontare costa poco; rifare un intero lotto di immagini già modificate no.

Lascia che le ricette crescano naturalmente

Parti dagli otto pattern qui sopra. Quando un collega risolve un nuovo caso di editing, aggiungilo, spiegando perché quella formulazione funziona. Con il tempo, questa libreria diventerà la documentazione implicita di prompt engineering del tuo team, e anche il materiale introduttivo per chiunque si avvicini all'API.

Depreca invece di eliminare

La finestra di contesto della tua memoria è breve. Una ricetta che fallisce su un tipo di immagine può essere perfetta su un altro. Archivia le ricette ritirate annotando perché sono state deprecate, così il prossimo non ripeterà lo stesso errore.

Tratta i prompt come codice: versiona, testa, revisiona, riusa. È questa disciplina che trasforma Flux-1 Kontext Max da demo in un anello affidabile della pipeline.

Inizia a creare con artefatti IA persistenti

Ottieni la tua chiave API e chiama modelli di immagini, video e audio tramite un'unica API basata sui task.

Leggi la documentazione API