Introduzione
FLUX 3 Klein Base Image editing cambia o combina da una a tre immagini di partenza a partire da un’istruzione scritta, con FLUX 3 Image Klein Base di Black Forest Labs, il checkpoint da 5.6B non distillato. Richiama le fonti come image 1, image 2 e image 3, mantieni la forma della prima immagine con auto oppure scegline una tra quindici, e scegli 1k o 2k. Nei nostri test le modifiche a 1k hanno richiesto circa 20–40 secondi, e nulla viene filtrato.
Scegli la modalità in base al materiale di partenza
| Cosa hai | Modalità |
|---|---|
| una descrizione scritta | FLUX 3 Klein Base da testo a immagine |
| da una a tre immagini da cambiare o combinare | FLUX 3 Klein Base modifica di immagini |
Caratteristiche principali
Capi da una foto di prodotto
Dai la persona come image 1 e un capo fotografato appeso a una gruccia come image 2, e la modifica veste l’una con l’altro. Nei nostri test una donna con un piumino invernale è tornata con un abito sottoveste di velluto bordeaux in uno spogliatoio di sauna, con volto e capelli mantenuti.
Stessa persona, luogo nuovo
Volto, barba e corporatura hanno retto un cambio completo di abito e di scena: un escursionista con una giacca rossa in una foresta innevata è diventato lo stesso uomo in una camicia di lino aperta su una panca di cedro. Istruzioni brevi e concrete hanno mantenuto meglio i volti.
Combina fino a tre immagini
Due foto separate di due donne sono diventate una scena su una panca di sauna, con abiti uguali e due volti riconoscibili. Con tre fonti, di’ che cosa porta ciascuna, così che nulla vada perso.
Parametri della richiesta
| Parametro | Obbligatorio | Nota |
|---|---|---|
prompt | Sì | Obbligatorio, fino a 5.000 caratteri. Indica prima cosa deve restare (volto, capelli, corporatura), poi la modifica. almeno 1 caratteri · al massimo 5000 caratteri |
image_urls | Sì | Obbligatorio, da una a tre link pubblici di immagini, fino a 10 MB ciascuna. Un link che non si apre o non è un’immagine fa fallire la richiesta senza addebito. almeno 1 elementi · al massimo 3 elementi |
aspect_ratio | No | auto (default) mantiene la forma della prima fonte: un ritratto 880 x 1184 è tornato 880 x 1184 a 1k e 1760 x 2368 a 2k. Oppure scegli una delle quindici forme da 3:1 a 1:3. |
resolution | No | 1k (default) o 2k, applicata anche con auto. 2k costa circa quattro volte 1k per l’output e il doppio per ogni fonte. |
output_format | No | JPEG (default), PNG o WebP. Non cambia il prezzo. |
seed | No | Facoltativo, da 0 a 2147483647. |
Prezzi
Fatturazione per immagine: un costo per il livello di dimensione in uscita più un costo per ogni immagine di partenza, entrambi più alti a 2k. Proporzione e formato di output non cambiano il prezzo.
| Specifiche | Prezzo |
|---|---|
| $0.054 / immagine |
| $0.216 / immagine |
Casi d’uso
Lookbook e styling
Metti un capo da una foto di prodotto su una modella presa da un’altra foto, in un luogo e con una luce nuovi, per lookbook e moodboard.
Cambi di luogo e di abito
Sposta una persona in un nuovo ambiente e in un nuovo abito in un solo passaggio, mantenendo chi è, per schede personaggio e serie.
Consigli avanzati
Usa i numeri delle immagini
Scrivi image 1, image 2 e image 3 nell’ordine di caricamento e assegna a ciascuna un ruolo: la donna di image 1, l’abito di image 2. La prima immagine fissa anche la forma quando la proporzione è auto.
Proteggi prima, poi cambia
Parti da ciò che deve restare uguale, come volto, capelli e corporatura, poi descrivi il cambiamento: capo, luogo, posa e luce. Il modello può lasciare i vestiti dove sono, quindi di’ esattamente cosa deve indossare la persona.
Attenzione al prezzo per fonte
Ogni fonte aumenta il prezzo, e 2k ne raddoppia il costo. Usa una sola fonte quando basta e fai le bozze a 1k.
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-3-klein-base/edit",
"input": {
"aspect_ratio": "auto",
"image_urls": [
"https://example.com/reference.png"
],
"output_format": "jpeg",
"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.


























