Introduzione
FLUX.2 [max] Modifica applica il modello FLUX.2 di qualità più alta di Black Forest Labs alle foto che hai già. Accetta da una a tre fonti e un’istruzione, e restituisce un’immagine con la proporzione della prima fonte o in una delle nove proporzioni, a 1k o 2k.
Scegli la modalità in base al materiale di partenza
| Materiale di partenza | Modalità |
|---|---|
| una descrizione scritta | FLUX.2 Max Testo in immagine |
| da una a tre foto da modificare o combinare | FLUX.2 Max Modifica |
Caratteristiche principali
Fino a tre riferimenti
Combina persone e luoghi da foto separate in un’unica richiesta. Nel nostro test della libreria due ritratti e una stanza sono diventati un’unica scena, con volto, acconciatura e abiti di ciascuna donna conservati e la luce delle lampade della libreria su entrambe.
Cambi di sfondo e di luce
Sostituisci lo sfondo di uno studio con un porto al tramonto e illumina di nuovo il soggetto, lasciando invariati volto, barba, espressione e abiti.
Un solo prezzo per modifica
Una modifica viene addebitata per immagine a un unico prezzo, qualunque sia il numero di fonti o il livello di dimensione. Le richieste rifiutate non vengono addebitate.
Parametri della richiesta
| Parametro | Obbligatorio | Nota |
|---|---|---|
prompt | Sì | Fino a 5.000 caratteri. Di’ che cosa cambiare e che cosa deve restare uguale. almeno 1 caratteri · al massimo 5000 caratteri |
image_urls | Sì | Da 1 a 3 immagini di partenza, fino a 10 MB ciascuna. Indica nel prompt che cosa porta ciascuna: una persona, una stanza, un prodotto. almeno 1 elementi · al massimo 3 elementi |
aspect_ratio | No | auto (predefinito) mantiene la forma della prima immagine di partenza a circa un megapixel; oppure scegli una di nove forme da 21:9 a 9:21. La forma non cambia il prezzo. |
resolution | No | 1k (predefinito) o 2k, usato solo quando scegli una proporzione; con auto il risultato resta a circa un megapixel. Le modifiche costano uguale a entrambi i livelli. |
seed | No | Numero intero facoltativo da 0 a 2147483647. Riutilizzalo con lo stesso prompt e le stesse fonti per confrontare più facilmente le variazioni; non garantisce un’immagine identica. |
Prezzi
$0.076 / immagine
Addebitato per immagine a un unico prezzo per modifica, qualunque sia il numero di immagini di partenza o il livello di dimensione. Le richieste fallite o rifiutate non vengono addebitate.
Casi d’uso
Fotografia di prodotti e luoghi
Nuovi sfondi, nuova luce e scene coerenti per immagini di catalogo e di campagna.
Ritocco di ritratti quotidiani
Cambia ambiente, luce o stile di un ritratto quotidiano mantenendo riconoscibile la persona.
Scene di gruppo da foto separate
Porta persone da ritratti individuali in un’unica stanza o location.
Consigli avanzati
Di’ che cosa resta uguale
Dopo la modifica, elenca volti, capelli, abiti e posa che non devono cambiare.
Numera le fonti
Chiamale immagine 1, immagine 2 e immagine 3 nell’ordine in cui le hai caricate e assegna a ciascuna un ruolo.
Usa foto di partenza pulite e quotidiane
Le modifiche sono filtrate con rigore: nei nostri test Max ha rifiutato le modifiche ai ritratti già al livello Lieve. Prodotti, luoghi e ritratti con abiti ordinari sono il materiale più sicuro.
Scegli auto per mantenere l’inquadratura
Auto mantiene la proporzione della prima fonte; scegli una proporzione e un livello quando vuoi un ritaglio diverso o il 2k.
Calcola fino a due minuti
Le nostre modifiche hanno richiesto circa da 45 a 120 secondi.
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-max/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.

























