Introduzione
GPT Image 2.5 Sunburst Modifica immagine applica il gpt-image-2.5-sunburst di OpenAI alle immagini che hai già. Accetta da una a sedici sorgenti, una maschera PNG facoltativa e l’opzione di sfondo trasparente, ed è il modello che OpenAI consiglia quando la precisione della modifica conta di più.
Scegli la modalità in base al materiale di partenza
| Cosa hai | Modalità |
|---|---|
| un brief scritto | GPT Image 2.5 Sunburst Da testo a immagine |
| un’immagine da cambiare | GPT Image 2.5 Sunburst Modifica immagine |
Caratteristiche principali
Maschere, fedeltà e trasparenza
Una maschera limita la ridipintura ai suoi pixel trasparenti; input_fidelity high mantiene volti e tessuti più vicini alle sorgenti; background transparent restituisce un vero canale alfa in PNG o WebP.
Fino a sedici sorgenti
Unisci persone, ambientazioni e prodotti da fino a sedici immagini in una richiesta, ognuna richiamata in base al suo ordine nel prompt. Ogni sorgente aggiunge un costo fisso di input a ogni immagine prodotta, quindi includi solo i riferimenti che contano.
La precisione è lo scopo
Nella nostra modifica dell’abito cremisi è cambiato solo il tessuto: maniche di pizzo, volto, sedia e l’unica luce principale sono rimasti dov’erano.
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
Ritoccare foto approvate
Cambia un capo, un colore o la luce in una foto già approvata senza toccare il resto dell’immagine, con o senza maschera.
Scontorni per i layout
Persone e prodotti restituiti su sfondo trasparente, pronti per un layout, una slide o una pagina prodotto senza un passaggio separato di rimozione dello sfondo.
Varianti di colore del prodotto
Una sola foto prodotto in più finiture o colori, con la maschera sul prodotto perché set e luce restino identici.
Consigli avanzati
Costruisci la maschera sulla sorgente
Stessa dimensione in pixel della prima sorgente, salvata in PNG, trasparente solo dove va ridipinto. Tutto ciò che è opaco è protetto.
Scrivi per intero l’elenco delle cose protette
Dopo la modifica, nomina ciò che deve restare: volto, capelli, posa, sedia, luce. Il modello segue un elenco scritto in modo più affidabile di uno implicito.
Negli scontorni, di’ cosa resta
Indica quale soggetto resta e che lo sfondo deve essere completamente trasparente, e imposta output_format su png o webp.
Controlla il canale alfa prima del layout
Apri il PNG o il WebP restituito nel tuo strumento di impaginazione: l’area vuota è un vero canale alfa, quindi non serve nessun passaggio aggiuntivo di keying o mascheratura.
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-sunburst/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.





