Introduzione
GPT Image 2 Modifica immagine applica il modello gpt-image-2 di OpenAI alle immagini che hai già. Dagli da una a dieci immagini sorgente e un’istruzione: cambia un capo o un colore, riscrivi un titolo, cambia la luce di una scena o unisci persone e luoghi di più sorgenti in un’unica immagine. Una maschera PNG facoltativa limita la ridipintura a una sola zona.
Scegli la modalità in base al materiale di partenza
| Cosa hai | Modalità |
|---|---|
| un brief scritto | GPT Image 2 Da testo a immagine |
| un’immagine da cambiare | GPT Image 2 Modifica immagine |
Caratteristiche principali
Modifica con istruzioni, con maschera se serve
Senza maschera il modello deduce dal prompt cosa cambiare e ridisegna il resto in modo coerente. Con la maschera vengono ridipinti solo i pixel trasparenti e tutto il resto rimane.
Fino a dieci sorgenti per richiesta
Richiama ogni sorgente in base all’ordine: la prima immagine porta la persona, la seconda l’ambientazione, la terza il prodotto. Il modello le unisce in una nuova immagine.
Controllo di fedeltà e formato
Input_fidelity high mantiene volti, tessuti e dettagli stampati più vicini alle sorgenti. Il formato auto conserva la forma della prima sorgente; uno dei quindici formati fissi dà invece quella forma al risultato.
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 10 immagini sorgente. Richiamale nel prompt in base all’ordine (la prima immagine, la seconda immagine). almeno 1 elementi · al massimo 10 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 | auto (predefinito) mantiene il formato della prima immagine sorgente a circa 1,5 megapixel e ignora il livello di dimensione; oppure scegli uno dei quindici formati da 1:3 a 3:1. |
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 (predefinito) o high. |
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) o opaque. OpenAI non offre output trasparente su GPT Image 2; per gli scontorni usa GPT Image 2.5 Sunburst o Flare. |
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à medium e dimensione 1k, in qualsiasi formato tranne 21:9, 9:21, 3:1 e 1:3, 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.002872 / immagine |
| $0.002872 / immagine |
| $0.00304 / immagine |
| $0.00304 / immagine |
| $0.003568 / immagine |
| $0.003568 / immagine |
| $0.003736 / immagine |
| $0.003736 / immagine |
| $0.003856 / immagine |
| $0.003856 / immagine |
| $0.004192 / immagine |
| $0.004192 / immagine |
| $0.004456 / immagine |
| $0.004456 / immagine |
| $0.005104 / immagine |
| $0.005152 / immagine |
| $0.005152 / immagine |
| $0.005704 / immagine |
| $0.005704 / immagine |
| $0.005896 / immagine |
| $0.006016 / immagine |
| $0.006016 / immagine |
| $0.006712 / immagine |
| $0.006712 / immagine |
| $0.007312 / immagine |
| $0.007312 / immagine |
| $0.0076 / immagine |
| $0.0076 / immagine |
| $0.008128 / immagine |
| $0.008128 / immagine |
| $0.009304 / immagine |
| $0.009304 / immagine |
| $0.009928 / immagine |
| $0.009928 / immagine |
| $0.011176 / immagine |
| $0.011176 / immagine |
| $0.01192 / immagine |
| $0.01192 / immagine |
| $0.01324 / immagine |
| $0.01324 / immagine |
| $0.016216 / immagine |
| $0.016216 / immagine |
| $0.01396 / immagine |
| $0.01396 / immagine |
| $0.018592 / immagine |
| $0.018592 / immagine |
| $0.020368 / immagine (Con Official fallback: fino a $0.021472) |
| $0.020368 / immagine (Con Official fallback: fino a $0.021472) |
| $0.020998 / immagine (Con Official fallback: fino a $0.023992) |
| $0.020998 / immagine (Con Official fallback: fino a $0.023992) |
| $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.023626 / immagine (Con Official fallback: fino a $0.034504) |
| $0.023626 / immagine (Con Official fallback: fino a $0.034504) |
| $0.024112 / immagine |
| $0.024112 / immagine |
| $0.025636 / immagine (Con Official fallback: fino a $0.042544) |
| $0.027448 / immagine (Con Official fallback: fino a $0.049792) |
| $0.032272 / immagine |
| $0.032272 / immagine |
| $0.03688 / immagine |
| $0.03688 / immagine |
| $0.043072 / immagine |
| $0.043072 / immagine |
| $0.048064 / immagine |
| $0.048064 / immagine |
| $0.050776 / immagine |
| $0.050776 / immagine |
| $0.055432 / immagine |
| $0.055432 / immagine |
| $0.062416 / immagine |
| $0.062416 / immagine |
| $0.0652 / immagine |
| $0.0652 / immagine |
| $0.067984 / immagine |
| $0.067984 / immagine |
| $0.080464 / immagine |
| $0.080464 / immagine |
| $0.086032 / immagine |
| $0.086032 / immagine |
| $0.094288 / immagine |
| $0.094288 / immagine |
| $0.103984 / immagine |
| $0.103984 / immagine |
| $0.11296 / immagine |
| $0.11296 / immagine |
| $0.14272 / immagine |
| $0.14272 / immagine |
| $0.054616 / immagine |
| $0.054616 / immagine |
| $0.07144 / immagine |
| $0.07144 / immagine |
| $0.082936 / immagine |
| $0.082936 / immagine |
| $0.095248 / immagine |
| $0.095248 / immagine |
| $0.096472 / immagine |
| $0.096472 / immagine |
| $0.110728 / immagine |
| $0.110728 / immagine |
| $0.124624 / immagine |
| $0.124624 / immagine |
| $0.127864 / immagine |
| $0.127864 / immagine |
| $0.135064 / immagine |
| $0.135064 / immagine |
| $0.142816 / immagine |
| $0.142816 / immagine |
| $0.168976 / immagine |
| $0.171016 / immagine |
| $0.171016 / immagine |
| $0.19456 / immagine |
| $0.19456 / immagine |
| $0.197104 / immagine |
| $0.197104 / immagine |
| $0.197968 / immagine |
| $0.220456 / immagine |
| $0.220456 / immagine |
| $0.248464 / immagine |
| $0.248464 / immagine |
| $0.259552 / immagine |
| $0.259552 / immagine |
| $0.274216 / immagine |
| $0.274216 / immagine |
| $0.320608 / immagine |
| $0.320608 / immagine |
| $0.342928 / immagine |
| $0.342928 / immagine |
| $0.37588 / immagine |
| $0.37588 / immagine |
| $0.414736 / immagine |
| $0.414736 / immagine |
| $0.456544 / immagine |
| $0.456544 / immagine |
| $0.569656 / immagine |
| $0.569656 / immagine |
Casi d’uso
Riscrivere e restyling di materiali finiti
Sostituisci le parole su un poster o una copertina, il colore di un prodotto o un capo, e lascia la foto sottostante esattamente come è stata approvata.
Comporre scene da riferimenti
Inserisci una persona di una foto nell’ambientazione di un’altra, o affianca due persone scattate separatamente, senza ricostruire il layout da un prompt di testo.
Versioni localizzate di un visual
Tieni la foto e sostituisci il titolo con una riga tradotta per ogni mercato, una modifica per lingua.
Consigli avanzati
Di’ cosa resta oltre a cosa cambia
Scrivi prima la modifica, poi cosa non deve muoversi: volto, posa, luce, sfondo, logo. Tutto ciò che non proteggi può essere ridisegnato.
Numera le sorgenti
Scrivi "la donna della prima immagine" e "la barca della seconda immagine". L’ordine in image_urls è l’unico modo in cui il modello le distingue.
Usa una maschera per i piccoli interventi
Per un singolo oggetto o un pezzo di sfondo, una maschera PNG della stessa dimensione della prima sorgente è più affidabile di una descrizione a parole.
Tieni auto per un’inquadratura fedele
Lascia il formato su auto quando la modifica deve mantenere l’inquadratura della sorgente; scegli un formato fisso solo se il risultato ha bisogno di una nuova forma.
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/edit",
"input": {
"aspect_ratio": "auto",
"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.





