Introduzione
FLUX 3 Klein Modifica immagini cambia da una a tre immagini di riferimento che carichi su FLUX 3 Klein di Black Forest Labs, il modello a pesi aperti da 5,6 miliardi di parametri uscito a ottobre 2026, nella sua versione distillata in pochi passi. Scegli 1k o 2k e una delle quindici proporzioni, ricevi un JPEG, PNG o WebP e paghi per immagine. La piattaforma non aggiunge alcun filtro sui contenuti.
Scegli la modalità in base al materiale di partenza
| Cosa hai | Modalità |
|---|---|
| una descrizione scritta | FLUX 3 Klein Testo in immagine |
| da una a tre immagini da modificare | FLUX 3 Klein Modifica immagini |
Caratteristiche principali
Nomina ogni fonte
Scrivi <ref_image_1>, <ref_image_2> e <ref_image_3> nel prompt, nell’ordine di caricamento: è la notazione che Black Forest Labs documenta per questo modello. Nei nostri test un capo o un cappello di una foto è stato messo su una persona di un’altra, con il volto conservato.
Nessun filtro sui contenuti
Prompt, fonti e risultati non vengono revisionati. Nei nostri test i ritratti di donne maggiorenni senza filtri sono passati e le modifiche senza filtri sono state eseguite come richiesto; solo le richieste più forti sono state attenuate dal modello stesso.
Parametri della richiesta
| Parametro | Obbligatorio | Nota |
|---|---|---|
prompt | Sì | Obbligatorio, fino a 5.000 caratteri. Nomina le fonti come < |
image_urls | Sì | Obbligatorio, da uno a tre link pubblici a immagini, fino a 10 MB ciascuno, nell’ordine a cui il prompt fa riferimento. almeno 1 elementi · al massimo 3 elementi |
aspect_ratio | No | auto (predefinito) conserva il formato della prima immagine, per esempio 880 x 1184 in 1k per una fonte verticale; oppure scegli una delle quindici proporzioni da 3:1 a 1:3. |
resolution | No | 1k (predefinito) è circa un megapixel; 2k è circa quattro, per esempio 1760 x 2368 per una fonte verticale. Il 2k costa di più. |
output_format | No | jpeg (predefinito), png o webp. Stesso prezzo per tutti e tre. |
seed | No | Facoltativo, da 0 a 2147483647. Riutilizzalo per confrontare formulazioni sulle stesse fonti. |
Prezzi
Addebito per immagine in base al livello di dimensione (1k o 2k); ogni immagine di riferimento dopo la prima aggiunge un piccolo costo. Proporzione e formato di file non cambiano il prezzo.
| Specifiche | Prezzo |
|---|---|
| $0.0192 / immagine |
| $0.0768 / immagine |
Casi d’uso
Cambi di abito e accessori
Metti un abito, un cappello o una giacca da una foto di prodotto su una persona di un’altra foto, in un’unica richiesta.
Cambi di luce e stile
Trasforma il mattino in tramonto o il mezzogiorno in ora blu mentre il volto e la stanza restano.
Consigli avanzati
Scrivi una didascalia completa
Descrivi inquadratura, soggetto, abbigliamento, luogo, luce e obiettivo in frasi complete. Non c’è un prompt negativo, quindi di’ cosa vuoi invece di cosa evitare.
Elenca ciò che resta
Accanto alla modifica, nomina ciò che non deve spostarsi: volto, capelli, posa, la stanza. Senza, il modello è libero di reinterpretare l’intera inquadratura.
Bozza in 1k, finisci in 2k
Fissa il seed mentre lavori in 1k, poi rilancia gli stessi input in 2k per l’immagine finale.
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/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.


























