Introduzione
FLUX.2 [flex] Modifica applica FLUX.2 [flex] di Black Forest Labs alle immagini che hai già. Accetta da una a tre fonti e un’istruzione, come una nuova luce, una nuova scena o un lettering aggiunto, e restituisce un risultato a 1k con la forma della fonte o una di nove forme.
Scegli la modalità in base al materiale di partenza
| Materiale di partenza | Modalità |
|---|---|
| una descrizione scritta | FLUX.2 [flex] Testo in immagine |
| immagini da modificare o combinare | FLUX.2 [flex] Modifica |
Caratteristiche principali
Nuova luce mantenendo il soggetto
Nel nostro test un ritratto di giorno è diventato una notte di pioggia con ciottoli bagnati, luce di vetrina e gocce di pioggia, mentre la donna, il suo cappotto e la sua posa sono rimasti come prima.
Composizioni con più fonti
Chiama ogni fonte con il suo numero e di’ come si combinano. Il nostro test del profumo ha messo una bottiglia da una foto su una cornice di marmo da un’altra, adattando luce e riflesso.
Testo aggiunto sul risultato
Metti tra virgolette il titolo o l’etichetta che vuoi aggiungere. Il nostro composito è tornato con il titolo scritto come indicato; un "No." in un’etichetta può tornare come segno di numero.
Parametri della richiesta
| Parametro | Obbligatorio | Nota |
|---|---|---|
prompt | Sì | Fino a 5.000 caratteri. Di’ che cosa cambiare e che cosa deve restare uguale, e chiama ogni fonte con la sua posizione, come immagine 1 e immagine 2. almeno 1 caratteri · al massimo 5000 caratteri |
image_urls | Sì | Da 1 a 3 immagini di partenza, nell’ordine a cui le richiama il prompt. Il prezzo è lo stesso qualunque sia il numero di fonti. almeno 1 elementi · al massimo 3 elementi |
aspect_ratio | No | auto (predefinito) mantiene circa la dimensione e la forma della prima fonte; oppure scegli una di nove forme da 21:9 a 9:21. La forma non cambia il prezzo. |
resolution | No | Per la modifica è disponibile solo 1k. Vale quando scegli una proporzione fissa; con auto il risultato segue la dimensione della prima fonte. |
seed | No | Numero intero facoltativo da 0 a 2147483647. Riutilizzalo con lo stesso prompt e le stesse fonti per confrontare le variazioni fianco a fianco. |
Prezzi
$0.115 / immagine
Addebitato per immagine a un unico prezzo fisso: il numero di immagini di partenza e la proporzione non lo cambiano. Le richieste rifiutate e fallite non vengono addebitate.
Casi d’uso
Scene di prodotto
Sposta uno scatto di prodotto in un’ambientazione curata e aggiungi un’etichetta o un titolo.
Variazioni di atmosfera e di meteo
Mostra un ritratto al tramonto, sotto la pioggia o alla luce al neon, a un cliente che sceglie una direzione.
Paesaggi e immagini quotidiane
Cambia l’ora del giorno, la stagione o lo sfondo di un paesaggio o di una scena di strada.
Consigli avanzati
Di’ che cosa resta
Dopo la modifica, elenca volto, abiti e posa che devono restare uguali.
Numera le fonti
Scrivi immagine 1 e immagine 2 nel prompt, così ogni fonte ha un ruolo chiaro.
Resta su materiale adatto a tutti
La modifica rifiuta i ritratti molto più facilmente del testo in immagine, anche al livello Lieve, quindi usala per prodotti, paesaggi e ritratti quotidiani.
Scegli auto per mantenere l’inquadratura
Con auto il risultato segue la dimensione della prima fonte. Scegli una forma fissa solo quando vuoi reinquadrare.
Calcola da uno a due minuti
Le modifiche hanno richiesto da 45 a 120 secondi nei nostri test.
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-flex/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.

























