Introduzione
FLUX.2 [klein] 9B Edit è la modalità di modifica del modello di immagini piccolo e veloce di Black Forest Labs, rilasciato il 15 gennaio 2026. Accetta da una a tre immagini di partenza e un’istruzione, restituisce un JPEG a circa un megapixel o al livello 1k o 2k che scegli, e non ha alcun filtro sui contenuti.
Scegli la modalità in base al materiale di partenza
| Cosa hai | Modalità |
|---|---|
| un brief scritto | FLUX.2 Klein 9B Text to image |
| immagini da modificare | FLUX.2 Klein 9B Edit |
Caratteristiche principali
Stessa persona, nuovo look
Nei nostri test volto, capelli e posa sono rimasti invariati attraverso cambi di abito e di sfondo. Elenca ciò che deve restare, poi descrivi il cambiamento.
Ridimensiona mentre modifichi
Scegli un formato e un livello di dimensione, e la modifica torna a 2048 pixel sul lato lungo. Con auto mantiene il formato della fonte.
Un solo prezzo fisso
Una modifica costa lo stesso con una fonte o con tre, a 1k o a 2k.
Parametri della richiesta
| Parametro | Obbligatorio | Nota |
|---|---|---|
prompt | Sì | Obbligatorio, fino a 5.000 caratteri. Indica cosa cambiare e cosa deve restare uguale, per esempio volto, capelli e posa, e nomina i nuovi capi. almeno 1 caratteri · al massimo 5000 caratteri |
image_urls | Sì | Obbligatorio, da una a tre immagini di partenza, fino a 10 MB ciascuna, nell’ordine in cui il prompt le richiama. Il numero di immagini non cambia il prezzo. almeno 1 elementi · al massimo 3 elementi |
aspect_ratio | No | auto (default) mantiene il formato della prima immagine di partenza a circa un megapixel; oppure scegli uno dei nove formati da 21:9 a 9:21. Il formato non cambia il prezzo. |
resolution | No | 1k (default) o 2k, usata solo quando scegli una proporzione; con auto il risultato resta a circa un megapixel. Non cambia il prezzo. |
seed | No | Numero intero facoltativo da 0 a 2147483647. Riutilizzalo per confrontare affiancati i cambiamenti del prompt; lascialo vuoto per averne uno casuale. |
Prezzi
$0.016 / immagine
Un solo prezzo fisso per immagine, qualunque sia il numero di immagini di partenza e che la dimensione sia 1k o 2k. Le richieste fallite o rifiutate non vengono addebitate.
Casi d’uso
Cambi di abito e di scena
Cambia i vestiti, la stanza o l’ora del giorno mantenendo le persone riconoscibili.
Variazioni rapide di una foto
Più atmosfere della stessa immagine nel tempo di un caffè.
Combinare fino a tre fonti
Una persona, un luogo e un oggetto portati in un’unica inquadratura, ciascuno nominato nel prompt.
Consigli avanzati
Indica cosa resta
Volto, capelli, posa, posto a sedere. Poi descrivi il cambiamento in una o due frasi.
Nomina i nuovi capi
Indica il taglio e il tessuto che vuoi; nei nostri test la modifica ha seguito i capi nominati nel prompt.
Cambia una cosa alla volta
Per trasformazioni più grandi, concatena due modifiche.
Scegli un formato per il 2k
Auto dà circa un megapixel; scegli un formato se vuoi il livello 2k.
Controlla mani e volti
I modelli piccoli possono sbagliare su entrambi. Prova un altro seed se succede.
Avvio rapido dell’API
# Generate the idempotency key once; reuse it when retrying after a lost response.
export SPICY_IDEMPOTENCY_KEY="${SPICY_IDEMPOTENCY_KEY:-$(uuidgen)}"
curl -X POST https://api.spicyapi.ai/api/v1/jobs/createTask \
-H "Authorization: Bearer $SPICY_API_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: $SPICY_IDEMPOTENCY_KEY" \
-d '{
"model": "black-forest-labs/flux-2-klein-9b/edit",
"input": {
"aspect_ratio": "auto",
"image_urls": [
"https://example.com/reference.png"
],
"prompt": "A ceramic teapot on a linen cloth, soft window light, muted palette",
"resolution": "1k"
}
}'
# Copy data.taskId from the response into TASK_ID, then poll the status.
TASK_ID="TASK_ID_FROM_RESPONSE"
curl "https://api.spicyapi.ai/api/v1/jobs/recordInfo?taskId=$TASK_ID" \
-H "Authorization: Bearer $SPICY_API_KEY"
Nel riferimento dell’API trovi autenticazione, schema completo, polling e gestione degli errori.
























