Introduzione
FLUX.2 Dev Image Edit modifica o combina fino a tre immagini di partenza su FLUX.2 [dev] di Black Forest Labs, un modello a pesi aperti da 32 miliardi di parametri. Descrivi il nuovo abito, ambientazione o luce, indica cosa deve restare e ricevi un’immagine. Mantiene i volti vicini alle fonti, può mettere nella stessa scena persone di foto diverse e non applica alcun filtro a immagini di partenza, prompt e risultato.
Scegli la modalità in base al materiale di partenza
| Cosa hai | Modalità |
|---|---|
| da una a tre immagini da modificare o combinare | FLUX.2 Dev Image Edit |
| solo un brief scritto | FLUX.2 Dev Text to image |
Caratteristiche principali
Fino a tre riferimenti
Elenca le immagini nell’ordine in cui il prompt le richiama e chiamale image 1, image 2 e image 3. Nel nostro test una donna di un ritratto e un uomo di un altro hanno ballato insieme in una nuova scena, con entrambi i volti ancora vicini alle loro foto.
Inquadratura che segue l’originale
Con il formato su auto il risultato mantiene le proporzioni della prima immagine a circa un megapixel. Scegli una proporzione e 2k quando vuoi un ritaglio diverso o più pixel.
Un solo prezzo fisso
Il prezzo per immagine resta lo stesso con una, due o tre immagini di partenza e con 1k o 2k.
Parametri della richiesta
| Parametro | Obbligatorio | Nota |
|---|---|---|
prompt | Sì | Fino a 5.000 caratteri. Indica cosa cambiare e cosa deve restare uguale. 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 ("image 1", "image 2"). Le foto nitide e frontali mantengono meglio i volti. almeno 1 elementi · al massimo 3 elementi |
aspect_ratio | No | auto (default) segue il formato della prima immagine di partenza a circa un megapixel. Scegli una delle nove proporzioni da 21:9 a 9:21 per ritagliare diversamente. |
resolution | No | 1k (default) o 2k, usata solo quando scegli una proporzione precisa. Con auto il risultato resta a circa un megapixel. |
seed | No | Un numero intero da 0 a 2147483647. Tienilo fisso mentre modifichi il prompt, così i risultati sono facili da confrontare; non garantisce un’immagine identica. |
Prezzi
$0.023 / 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
Un nuovo abito e una nuova ambientazione per la stessa persona
Porta una persona da un ufficio a un bar o da una strada a una spiaggia, con un altro abito e un’altra luce, mantenendone il volto.
Due persone nella stessa scena
Porta in un’unica inquadratura persone di ritratti separati, per una foto di coppia o una coppia di personaggi.
Cambi di luce e di colore
Chiedi una nuova fonte di luce con un colore hex e mantieni il resto della composizione.
Consigli avanzati
Di’ cosa resta
Inizia con "same man, same face and beard", poi elenca cosa cambia. Elenchi brevi ed espliciti funzionano meglio di descrizioni lunghe.
Numera le persone
Quando combini foto scrivi "the woman from image 1 and the man from image 2" e chiedi di mantenere entrambi i volti esattamente come nelle foto.
Una sola persona per inquadratura, quando conta
Aggiungi "alone in the frame, no other people" per evitare che compaiano altre figure sullo sfondo.
Parti da auto
Lascia prima il formato su auto. Scegli una proporzione e 2k quando il contenuto ti piace, e tieni lo stesso seed per confrontare la versione più grande.
Usa fonti chiare
Le foto ben illuminate e frontali trasferiscono meglio i volti. La seconda e la terza persona sono un po’ meno stabili della prima.
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-dev/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.
























