Introduzione
FLUX.2 [klein] 4B Image edit cambia o combina fino a tre immagini di partenza con un’istruzione scritta, sul modello FLUX.2 più piccolo di Black Forest Labs, open source con licenza Apache 2.0. Mantieni il formato della prima immagine con auto, oppure scegli una proporzione e un livello 1k o 2k. Ogni modifica ha un solo prezzo fisso per immagine e non viene applicato alcun filtro sui contenuti.
Scegli la modalità in base al materiale di partenza
| Cosa hai | Modalità |
|---|---|
| una descrizione scritta | FLUX.2 Klein 4B Text to image |
| da una a tre immagini da modificare o combinare | FLUX.2 Klein 4B Image edit |
Caratteristiche principali
Fino a tre riferimenti
Combina due ritratti e un luogo, oppure ridisegna lo stile di una sola foto. Il prezzo non cambia con il numero di fonti.
Modifiche che mantengono le persone
Chiedi un nuovo sfondo, una nuova luce o un altro meteo mantenendo volti, vestiti e posa. Con una sola fonte funziona in modo pulito; con tre, i volti possono variare leggermente.
Aperto, senza filtro
Nulla viene verificato né rifiutato. Nei nostri test le modifiche hanno mantenuto la sorgente senza filtro così com'era; solo il livello Molto forte è tornato attenuato.
Parametri della richiesta
| Parametro | Obbligatorio | Nota |
|---|---|---|
prompt | Sì | Indica cosa deve cambiare e cosa deve restare uguale, fino a 5.000 caratteri. Con più fonti, chiamale image 1, image 2 e image 3. almeno 1 caratteri · al massimo 5000 caratteri |
image_urls | Sì | Da una a tre immagini di partenza, fino a 10 MB ciascuna, nell’ordine in cui il prompt le richiama. Obbligatorio. almeno 1 elementi · al massimo 3 elementi |
aspect_ratio | No | Auto (default) mantiene il formato della prima fonte a circa un megapixel. Oppure scegli una delle nove proporzioni da 21:9 a 9:21. |
resolution | No | 1k (default) o 2k, cioè 2048 pixel sul lato lungo. Vale solo quando scegli una proporzione; con auto la dimensione è circa un megapixel. |
seed | No | Un numero da 0 a 2147483647. Riutilizzalo per confrontare le modifiche mentre cambi un dettaglio del prompt. |
Prezzi
$0.013 / immagine
Fatturazione per immagine a un prezzo fisso unico, qualunque sia il numero di immagini di partenza o il livello di dimensione. Le richieste fallite non vengono addebitate.
Casi d’uso
Cambi di sfondo e di atmosfera
Porta una coppia da una strada soleggiata a una notte di pioggia al neon in un solo passaggio.
Portare le persone in un luogo
Metti due ritratti in una foto di un luogo per storyboard, copertine e schede dei personaggi.
Ridisegni rapidi
Cambia luce, stagione o palette mentre la composizione resta ferma.
Consigli avanzati
Prima proteggi, poi cambia
Apri con ciò che deve restare uguale, poi descrivi solo il cambiamento. Istruzioni brevi e concrete funzionano meglio.
Dai un ruolo a ogni fonte
Con più immagini, di’ cosa porta ciascuna: questa persona, quella persona, questo luogo.
Controlla i dettagli
Con due o tre fonti guarda mani, capelli e accessori; può comparire un piccolo oggetto in più. Prova un altro seed se qualcosa non va.
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-4b/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.

























