Introduzione
GPT Image 2.5 Flare Modifica immagine applica il gpt-image-2.5-flare di OpenAI alle immagini che hai già. Accetta da una a sedici sorgenti, una maschera PNG e l’opzione di sfondo trasparente, e restituisce le modifiche abbastanza in fretta per un uso interattivo.
Scegli la modalità in base al materiale di partenza
| Cosa hai | Modalità |
|---|---|
| un brief scritto | GPT Image 2.5 Flare Da testo a immagine |
| un’immagine da cambiare | GPT Image 2.5 Flare Modifica immagine |
Caratteristiche principali
Composizioni rapide da più sorgenti
Due o più sorgenti diventano una scena, con i volti mantenuti dalle loro immagini. Il nostro esempio con due sorgenti è finito in molto meno di un minuto.
Maschere e scontorni
Una maschera PNG limita la ridipintura a una zona; background transparent restituisce un vero canale alfa in PNG o WebP, pronto per un layout senza passaggio di keying.
Più modifiche in un passaggio
Abito, ora del giorno e meteo possono cambiare insieme, purché il prompt dica anche cosa deve restare uguale. Il nostro esempio della terrazza ha cambiato abito e luce in una richiesta.
Parametri della richiesta
| Parametro | Obbligatorio | Nota |
|---|---|---|
prompt | Sì | Fino a 5.000 caratteri. Metti tra virgolette doppie ogni parola che deve comparire nell’immagine e indica dove va; il resto viene letto come descrizione. almeno 1 caratteri · al massimo 5000 caratteri |
image_urls | Sì | Da 1 a 16 immagini sorgente. Richiamale nel prompt in base all’ordine (la prima immagine, la seconda immagine). almeno 1 elementi · al massimo 16 elementi |
mask_url | No | PNG facoltativo della stessa dimensione della prima immagine sorgente. I pixel trasparenti indicano la zona da ridipingere; quelli opachi restano. |
aspect_ratio | No | Quindici formati da 1:3 a 3:1, 1:1 per impostazione predefinita. Il risultato prende il formato che scegli, non quello della sorgente, e il formato cambia il prezzo. |
resolution | No | 1k (predefinito), 2k o 4k. Un’immagine quadrata misura 1024, 2048 o 2880 pixel di lato; un livello più alto costa di più per immagine. |
quality | No | low, medium, high (predefinito), xhigh o max. Ogni livello aggiunge dettaglio, tempo e costo; tieni xhigh e max per le versioni finali. |
num_outputs | No | Da 1 a 10 immagini per richiesta, 1 per impostazione predefinita. Ogni immagine è fatturata separatamente. |
input_fidelity | No | low (predefinito) o high. High mantiene più fedelmente volti, tessuti e dettagli stampati delle sorgenti. |
background | No | auto (predefinito), transparent o opaque. Transparent richiede output png o webp e restituisce un vero canale alfa. |
output_format | No | png (predefinito), jpeg o webp. Non cambia il prezzo. |
output_quality | No | Qualità di compressione per jpeg e webp, da 0 a 100: valori alti conservano più dettaglio e producono file più pesanti. Non si usa con png e non cambia il prezzo. |
official_fallback | No | Attivo per impostazione predefinita. Predefinito: |
Prezzi
Si paga per immagine prodotta in base a qualità, livello di dimensione e formato; sul percorso ufficiale ogni immagine sorgente aggiunge anche un costo fisso per ogni immagine prodotta. Il preventivo mostra il totale prima dell’invio. Una richiesta per una sola modifica PNG in qualità high e dimensione 1k, nel formato 1:1, 3:2, 2:3, 4:3, 3:4, 16:9 o 9:16, senza maschera, con input fidelity low e background auto parte dal percorso economico al prezzo economico. Con Official fallback attivo (predefinito), una richiesta che quel percorso rifiuta o non riesce a completare viene rieseguita sul percorso ufficiale al prezzo ufficiale, quindi il preventivo mostra sia il prezzo di partenza sia l’importo massimo. Le richieste rifiutate non vengono addebitate. Sul percorso ufficiale i prompt lunghi aggiungono un piccolo costo per i token di input oltre i primi 100, una volta per richiesta; il testo in cinese, giapponese o coreano conta circa un token per carattere.
| Specifiche | Prezzo |
|---|---|
| $0.001816 / immagine |
| $0.001816 / immagine |
| $0.00244 / immagine |
| $0.00244 / immagine |
| $0.002752 / immagine |
| $0.002752 / immagine |
| $0.00304 / immagine |
| $0.00304 / immagine |
| $0.003568 / immagine |
| $0.003568 / immagine |
| $0.003808 / immagine |
| $0.003808 / immagine |
| $0.003856 / immagine |
| $0.003856 / immagine |
| $0.004192 / immagine |
| $0.004192 / immagine |
| $0.004744 / immagine |
| $0.004744 / immagine |
| $0.005104 / immagine |
| $0.00568 / immagine |
| $0.00568 / immagine |
| $0.00652 / immagine |
| $0.00652 / immagine |
| $0.007312 / immagine |
| $0.007312 / immagine |
| $0.008176 / immagine |
| $0.008176 / immagine |
| $0.008728 / immagine |
| $0.008728 / immagine |
| $0.010936 / immagine |
| $0.01396 / immagine |
| $0.01396 / immagine |
| $0.018592 / immagine |
| $0.018592 / immagine |
| $0.020998 / immagine (Con Official fallback: fino a $0.023992) |
| $0.020998 / immagine (Con Official fallback: fino a $0.023992) |
| $0.021472 / immagine |
| $0.021472 / immagine |
| $0.022 / immagine (Con Official fallback: fino a $0.028) |
| $0.022 / immagine (Con Official fallback: fino a $0.028) |
| $0.022864 / immagine (Con Official fallback: fino a $0.031456) |
| $0.022864 / immagine (Con Official fallback: fino a $0.031456) |
| $0.024136 / immagine |
| $0.024136 / immagine |
| $0.025636 / immagine (Con Official fallback: fino a $0.042544) |
| $0.0316 / immagine |
| $0.0316 / immagine |
| $0.034504 / immagine |
| $0.034504 / immagine |
| $0.037864 / immagine |
| $0.037864 / immagine |
| $0.043504 / immagine |
| $0.043504 / immagine |
| $0.049816 / immagine |
| $0.049816 / immagine |
| $0.054616 / immagine |
| $0.054616 / immagine |
| $0.055624 / immagine |
| $0.055624 / immagine |
| $0.059872 / immagine |
| $0.059872 / immagine |
| $0.07144 / immagine |
| $0.07144 / immagine |
| $0.075328 / immagine |
| $0.082936 / immagine |
| $0.082936 / immagine |
| $0.096472 / immagine |
| $0.096472 / immagine |
| $0.110728 / immagine |
| $0.110728 / immagine |
| $0.124624 / immagine |
| $0.124624 / immagine |
| $0.135064 / immagine |
| $0.135064 / immagine |
| $0.168976 / immagine |
| $0.002872 / immagine |
| $0.002872 / immagine |
| $0.004456 / immagine |
| $0.004456 / immagine |
| $0.005152 / immagine |
| $0.005152 / immagine |
| $0.005704 / immagine |
| $0.005704 / immagine |
| $0.006328 / immagine |
| $0.006328 / immagine |
| $0.006712 / immagine |
| $0.006712 / immagine |
| $0.007312 / immagine |
| $0.007312 / immagine |
| $0.008128 / immagine |
| $0.008128 / immagine |
| $0.009088 / immagine |
| $0.009088 / immagine |
| $0.009928 / immagine |
| $0.01108 / immagine |
| $0.01108 / immagine |
| $0.01276 / immagine |
| $0.01276 / immagine |
| $0.014176 / immagine |
| $0.014176 / immagine |
| $0.015904 / immagine |
| $0.015904 / immagine |
| $0.017296 / immagine |
| $0.017296 / immagine |
| $0.021808 / immagine |
| $0.024112 / immagine |
| $0.024112 / immagine |
| $0.03688 / immagine |
| $0.03688 / immagine |
| $0.041896 / immagine |
| $0.041896 / immagine |
| $0.043072 / immagine |
| $0.043072 / immagine |
| $0.048064 / immagine |
| $0.048064 / immagine |
| $0.055432 / immagine |
| $0.055432 / immagine |
| $0.062416 / immagine |
| $0.062416 / immagine |
| $0.062944 / immagine |
| $0.062944 / immagine |
| $0.067984 / immagine |
| $0.067984 / immagine |
| $0.07624 / immagine |
| $0.07624 / immagine |
| $0.086032 / immagine |
| $0.087496 / immagine |
| $0.087496 / immagine |
| $0.095248 / immagine |
| $0.095248 / immagine |
| $0.098968 / immagine |
| $0.098968 / immagine |
| $0.110656 / immagine |
| $0.110656 / immagine |
| $0.121312 / immagine |
| $0.121312 / immagine |
| $0.142816 / immagine |
| $0.142816 / immagine |
| $0.152632 / immagine |
| $0.171016 / immagine |
| $0.171016 / immagine |
| $0.19456 / immagine |
| $0.19456 / immagine |
| $0.220456 / immagine |
| $0.220456 / immagine |
| $0.248464 / immagine |
| $0.248464 / immagine |
| $0.274216 / immagine |
| $0.274216 / immagine |
| $0.342928 / immagine |
| $0.003736 / immagine |
| $0.003736 / immagine |
| $0.006016 / immagine |
| $0.006016 / immagine |
| $0.0076 / immagine |
| $0.0076 / immagine |
| $0.008368 / immagine |
| $0.008368 / immagine |
| $0.009304 / immagine |
| $0.009304 / immagine |
| $0.011176 / immagine |
| $0.011176 / immagine |
| $0.01192 / immagine |
| $0.01192 / immagine |
| $0.0124 / immagine |
| $0.0124 / immagine |
| $0.01324 / immagine |
| $0.01324 / immagine |
| $0.016216 / immagine |
| $0.0166 / immagine |
| $0.0166 / immagine |
| $0.02116 / immagine |
| $0.02116 / immagine |
| $0.023872 / immagine |
| $0.023872 / immagine |
| $0.026296 / immagine |
| $0.026296 / immagine |
| $0.028552 / immagine |
| $0.028552 / immagine |
| $0.032272 / immagine |
| $0.032272 / immagine |
| $0.035992 / immagine |
| $0.050776 / immagine |
| $0.050776 / immagine |
| $0.056176 / immagine |
| $0.056176 / immagine |
| $0.0652 / immagine |
| $0.0652 / immagine |
| $0.080464 / immagine |
| $0.080464 / immagine |
| $0.086752 / immagine |
| $0.086752 / immagine |
| $0.094288 / immagine |
| $0.094288 / immagine |
| $0.103984 / immagine |
| $0.103984 / immagine |
| $0.11296 / immagine |
| $0.11296 / immagine |
| $0.115576 / immagine |
| $0.115576 / immagine |
| $0.127864 / immagine |
| $0.127864 / immagine |
| $0.14272 / immagine |
| $0.14272 / immagine |
| $0.14272 / immagine |
| $0.168592 / immagine |
| $0.168592 / immagine |
| $0.184552 / immagine |
| $0.184552 / immagine |
| $0.197104 / immagine |
| $0.197104 / immagine |
| $0.201832 / immagine |
| $0.201832 / immagine |
| $0.253408 / immagine |
| $0.259552 / immagine |
| $0.259552 / immagine |
| $0.320608 / immagine |
| $0.320608 / immagine |
| $0.37588 / immagine |
| $0.37588 / immagine |
| $0.414736 / immagine |
| $0.414736 / immagine |
| $0.456544 / immagine |
| $0.456544 / immagine |
| $0.569656 / immagine |
Casi d’uso
Prove d’abito e restyling
Mostra la stessa persona con un abito nuovo o in un luogo nuovo per un lookbook o una bozza di campagna, con più opzioni per richiesta.
Unire persone di scatti separati
Metti nella stessa immagine due persone fotografate separatamente, per un poster, una miniatura o un pannello di storia.
Aggiornamenti stagionali
Trasforma un’immagine di campagna estiva in una versione autunnale o notturna per la stagione successiva, con persona e prodotto invariati.
Consigli avanzati
Dai un compito a ogni sorgente
L’uomo e la soglia dalla prima immagine, la donna dalla seconda: scrivilo, perché l’ordine è l’unico legame tra prompt e sorgenti.
Raggruppa le modifiche collegate
Un abito nuovo e un’altra ora del giorno si esprimono bene in una richiesta; modifiche non collegate funzionano meglio come modifiche separate.
Alza la fedeltà per i volti
Imposta input_fidelity su high quando un volto deve restare riconoscibile dopo la modifica; il prezzo non cambia.
Usa la maschera per cambiare lo sfondo
Quando deve cambiare solo lo sfondo, tieni il soggetto opaco e lo sfondo trasparente in una maschera PNG della dimensione della prima sorgente.
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": "openai/gpt-image-2.5-flare/edit",
"input": {
"aspect_ratio": "1:1",
"background": "auto",
"image_urls": [
"https://example.com/reference.png"
],
"input_fidelity": "low",
"num_outputs": 1,
"output_format": "png",
"prompt": "A ceramic teapot on a linen cloth, soft window light, muted palette"
}
}'
# 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.





