API di modifica immagini e riferimenti di GPT Image 2.5 Sunburst su E2X
GPT Image 2.5 Sunburst edit-image è l'endpoint di editing condizionato da immagini di riferimento di OpenAI su E2X, disponibile su openai/gpt-image-2.5-sunburst/edit-image. Passando uno o più URL sorgente in image_urls insieme a un'istruzione fino a 50,000 caratteri, il modello modifica l'immagine esistente, compone più prodotti in un'unica scena o sostituisce scritte incorporate. Con il nostro sconto fisso del 75%, una modifica in 1K costa $0.0525 per immagine generata sia che tu scelga la qualità low, medium, high, xhigh o max, ovvero il 75% in meno rispetto al benchmark di fascia alta di $0.211 su fal.ai.
Vuoi generare solo a partire da una descrizione scritta senza foto di riferimento? Chiama invece GPT Image 2.5 Sunburst text-to-image, che applica lo stesso listino prezzi e richiede unicamente prompt. GPT Image 2.5 Sunburst supporta tutti i 5 livelli di qualità (low, medium, high, xhigh, max) a 1K, 2K e 4K, mentre GPT Image 2.5 Flare (edit-image) è pensato per i flussi di lavoro standard a 3 livelli (low, medium, high).
Prezzi per modifica tra i livelli di risoluzione e qualità
Ogni richiesta di modifica su openai/gpt-image-2.5-sunburst/edit-image parte da una tariffa base di listino di $0.03 (30,000 micro-centesimi) che il nostro sconto globale del 75% riduce a $0.0075 (7,500 micro-centesimi) prima di applicare due coefficienti di parametro:
- Fattore
resolution: 1K (predefinito) = ×1, 2K = ×2, 4K = ×3.
- Fattore
quality: low, medium, high (predefinito), xhigh e max applicano ciascuno un coefficiente ×7.
Poiché tutte le cinque opzioni di quality moltiplicano per 7 la base scontata di $0.0075 ($0.0075 × 7 = $0.0525 a 1K), resolution è l'unica leva di costo. Puoi eseguire la qualità high, xhigh o max esattamente allo stesso prezzo di low. Inoltre, a differenza della nostra precedente rotta GPT Image 2 edit-image, dove quality era un campo obbligatorio, su GPT Image 2.5 Sunburst quality è facoltativo e predefinito su high.
Matrice tariffaria completa per modifica verificata il 4 novembre 2026:
| Risoluzione di output | Tariffa E2X scontata | Tariffa di listino | Fattore combinato | Equivalente fal.ai | Fase di editing tipica |
|---|
1K (predefinito) | $0.0525 | $0.21 | 1 × 7 | $0.211 (75% più alto) | Messa a punto dei prompt, test sui testi delle etichette, cambio sfondo |
2K | $0.1050 | $0.42 | 2 × 7 | $0.222 (53% più alto) | Packshot e-commerce di produzione e banner hero per il web |
4K | $0.1575 | $0.63 | 3 × 7 | $0.401 (61% più alto) | Composizioni pronte per la stampa ed esportazioni master ad alta risoluzione |
Questa struttura dei prezzi semplifica la gestione del budget in un ciclo di editing. Quando perfezioni un prompt per sostituire il testo sull'etichetta di una bottiglia o testi tre diversi ambienti di illuminazione per lo scontorno di un prodotto, mantieni resolution su 1K ($0.0525 ciascuno) eseguendo la qualità high o xhigh. Cinque modifiche esplorative a 1K più un'esportazione finale in 2K ($0.105) portano il totale a $0.3675.
I prezzi e i termini del prodotto possono variare. Verifica i prezzi correnti di ciascun fornitore prima di prendere una decisione d'acquisto. I prezzi Batch o Flex di Google non sono direttamente equivalenti a una richiesta API standard on-demand poiché cambiano le condizioni di pianificazione, disponibilità ed elaborazione; sono pertanto esclusi da questo confronto. Questo è un confronto circoscritto, non un'affermazione che E2X sia l'opzione più economica al mondo in ogni configurazione.
Flussi di lavoro di modifica principali per questo endpoint
- Localizzazione e sostituzione del testo nell'immagine: Fornisci all'endpoint un poster finito, la grafica piana di un packaging o una scheda UI e specifica tra doppie virgolette la stringa esatta sostitutiva. Il modello aggiorna le parole mantenendo intatti il layout circostante, la prospettiva e l'ombreggiatura della superficie.
- Composizione di scene multi-riferimento: Passa un array di URL sorgente in
image_urls per combinare elementi separati in un unico fotogramma, ad esempio posizionando lo scontorno di un prodotto dall'immagine 1 sul tavolo da studio mostrato nell'immagine 2 con la palette cromatica dell'immagine 3.
- Modifiche mirate degli attributi e restyling: Mantieni fissa la geometria del soggetto cambiando materiali, abbigliamento, ora del giorno o scenario di sfondo tramite un prompt differenziale.
- Budget del prompt esteso a 50,000 caratteri: Mentre il modello gemello text-to-image limita i prompt a 32,000 caratteri,
edit-image ne accetta fino a 50,000, offrendo alle pipeline automatizzate ampio spazio per passare specifiche dettagliate di layout, regole di stile del brand e istruzioni per singola immagine di riferimento.
Richiesta API: invio degli URL sorgente e polling
prompt e image_urls sono i due parametri obbligatori su openai/gpt-image-2.5-sunburst/edit-image. aspect_ratio (predefinito 1:1), resolution (predefinito 1K) e quality (predefinito high) sono facoltativi.
Ecco una chiamata curl che invia la modifica di un'etichetta di packaging a qualità xhigh e risoluzione 2K ($0.105):
curl -X POST https://api.e2x.ai/v1/jobs/submit \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "openai/gpt-image-2.5-sunburst/edit-image",
"input": {
"prompt": "Change the main label title on the amber glass jar to \"BERGAMOT & CEDAR SOY CANDLE\" in the same serif font and gold foil finish. Keep the apothecary jar shape, wooden lid, and linen backdrop unchanged.",
"image_urls": [
"https://example.com/assets/amber-jar-original.png"
],
"aspect_ratio": "4:5",
"resolution": "2K",
"quality": "xhigh"
}
}'
Di seguito è riportato un esempio completo in Node.js che compone due immagini di riferimento in 1K ($0.0525) ed esegue il polling del job fino al completamento:
const headers = {
Authorization: `Bearer ${process.env.E2X_API_KEY}`,
"Content-Type": "application/json",
};
const createJob = await fetch("https://api.e2x.ai/v1/jobs/submit", {
method: "POST",
headers,
body: JSON.stringify({
model: "openai/gpt-image-2.5-sunburst/edit-image",
input: {
prompt: "Place the titanium chronograph watch from image 1 onto the wet slate block in image 2. Match the cool side-lighting from image 2 and keep the sub-dial numerals sharp.",
image_urls: [
"https://example.com/assets/chronograph-front.png",
"https://example.com/assets/wet-slate-surface.jpg",
],
aspect_ratio: "1:1",
resolution: "1K",
quality: "max",
},
}),
}).then((res) => res.json());
const jobId = createJob.data.jobId;
while (true) {
await new Promise((r) => setTimeout(r, 3000));
const statusPayload = await fetch(`https://api.e2x.ai/v1/jobs/${jobId}`, {
headers,
}).then((res) => res.json());
const state = statusPayload.data.status;
if (state === "completed") {
console.log("Edited output URL:", statusPayload.data.outputs[0].url);
break;
}
if (state === "failed" || state === "cancelled") {
throw new Error(statusPayload.data.error?.message || `Edit job ${state}`);
}
}
Ogni URL presente in image_urls deve essere raggiungibile pubblicamente via HTTPS affinché i nostri worker possano scaricare il file sorgente. Puoi consultare la definizione completa dei parametri nella specifica dell'endpoint leggibile dalle macchine o effettuare l'integrazione tramite i nostri SDK ufficiali.
Confronto tra gli endpoint di modifica immagini su E2X
Scegli tra i nostri sei endpoint image-to-image in base al fatto che la modifica riguardi tipografia, scontorni trasparenti, identità dei ritratti o costi su alti volumi:
| Modello di editing | Prezzo 1K | Prezzo 4K | Risoluzione max | Vantaggio principale |
|---|
| GPT Image 2.5 Sunburst edit | $0.0525 | $0.1575 | 4K | Prompt da 50,000 caratteri, livelli di qualità xhigh e max senza costi extra, proporzioni auto |
| GPT Image 2 edit | $0.0525 | $0.1575 | 4K | Supporta background: "transparent" per scontorni PNG con canale alfa allo stesso prezzo |
| Nano Banana 2.1 edit | $0.0300 | $0.0900 | 4K | Prezzo di editing 4K più basso ($0.09) e 15 proporzioni fino a 8:1 |
| Nano Banana Pro edit | $0.0750 | $0.1500 | 4K | Migliore conservazione dell'identità facciale su più riferimenti personaggio |
| Nano Banana 2 edit | $0.0400 | $0.0800 | 4K | Sostituzioni rapide dello sfondo e correzioni colore per l'uso quotidiano |
| Nano Banana 2 Lite edit | $0.0238 | n/a | 1K | Costo fisso di editing 1K più basso per pipeline di cataloghi massivi |
Quando una modifica richiede uno sfondo PNG trasparente (background: "transparent"), usa GPT Image 2 edit-image alla stessa tariffa di $0.0525 (1K), poiché gpt-image-2.5-sunburst/edit-image non espone il campo background. Quando ti servono modifiche 4K economiche su larga scala ($0.09) o banner ultra-wide 8:1, usa Nano Banana 2.1 edit-image. Esplora tutti i modelli di modifica nella categoria image-to-image o nel catalogo completo dei modelli.
Scrivere prompt di modifica efficaci
Un prompt di modifica funziona al meglio quando descrive il cambiamento anziché ridescrivere da zero l'intera immagine di partenza:
- Specifica cosa cambia e cosa resta bloccato: Dichiara esplicitamente quali elementi devono rimanere intatti ("sostituisci il piano del tavolo in legno con marmo di Carrara levigato; mantieni invariati la tazza in ceramica, il vapore e l'angolazione del manico").
- Indicizza chiaramente più immagini di riferimento: Quando passi due o più URL in
image_urls, fai riferimento ad essi per posizione ("prendi la sneaker dall'immagine 1, posizionala sulla strada di asfalto bagnato nell'immagine 2 e adatta i riflessi al neon dell'immagine 3").
- Cita testualmente il testo sostitutivo: Inserisci il testo esatto da sostituire tra doppie virgolette e specifica come deve relazionarsi alla tipografia esistente ("sostituisci il testo del badge con "LIMITED EDITION 250ML" nello stesso font sans-serif condensato").
- Adatta le proporzioni alla sorgente o usa
auto: Impostare aspect_ratio: "auto" consente al modello di preservare l'inquadratura dell'immagine di input, mentre specificare 16:9 o 9:16 gli indica di reinquadrare o estendere la scena per adattarla alla nuova tela.
Per altri esempi di flussi di lavoro basati su riferimenti, leggi la nostra guida alla generazione coerente di immagini e il nostro confronto tra i modelli Nano Banana.
Domande frequenti
Quanto costa una singola modifica con GPT Image 2.5 Sunburst su E2X?
Dopo il nostro sconto del 75%, una modifica costa $0.0525 a resolution: "1K" (il valore predefinito), $0.105 a 2K e $0.1575 a 4K, sia che quality venga impostato su low, medium, high, xhigh o max.
Quali parametri sono obbligatori sull'endpoint edit-image?
Sono obbligatori solo prompt (fino a 50,000 caratteri) e image_urls (un array contenente almeno un URL di immagine pubblicamente accessibile). aspect_ratio, resolution e quality sono facoltativi e assumono come valori predefiniti "1:1", "1K" e "high".
In cosa differisce GPT Image 2.5 Sunburst edit-image da GPT Image 2 edit-image?
Entrambi gli endpoint condividono lo stesso listino prezzi ($0.0525 per 1K, $0.105 per 2K e $0.1575 per 4K). Su GPT Image 2.5 Sunburst, quality è facoltativo e aggiunge i livelli xhigh e max senza costi aggiuntivi, mentre aspect_ratio aggiunge "auto" oltre ai 15 rapporti fissi. Tuttavia, gpt-image-2.5-sunburst/edit-image non include il parametro di trasparenza background presente su gpt-image-2/edit-image.
Posso passare più immagini di riferimento in una singola richiesta?
Sì. image_urls accetta un array di URL sorgente in modo da poter combinare soggetti, sfondi e riferimenti di stile in un unico job. Fai riferimento a ciascuna immagine per numero nel prompt ("immagine 1", "immagine 2") affinché il modello sappia quale ruolo svolge ciascun file.
Perché qui il limite del prompt è di 50,000 caratteri invece di 32,000?
Le pipeline di editing basate su riferimenti iniettano spesso vincoli strutturati di layout, trascrizioni OCR di etichette esistenti e istruzioni di condizionamento per singola immagine. Il tetto di 50,000 caratteri accoglie questi payload automatizzati più lunghi senza troncamenti.
Come mantengo bassi i costi di iterazione durante la messa a punto di una modifica?
Mantieni resolution: "1K" mentre testi la formulazione del prompt e il posizionamento nella composizione a qualità high, xhigh o max. Ogni passaggio a 1K costa $0.0525 anziché $0.105 (2K) o $0.1575 (4K). Porta resolution a 2K o 4K solo per l'esportazione finale.
Quando dovrei scegliere Nano Banana Pro o Nano Banana 2.1 per l'editing?
Scegli Nano Banana Pro ($0.075 a 1K) quando la priorità assoluta è preservare la somiglianza facciale di una persona specifica su più angolazioni di riferimento. Scegli Nano Banana 2.1 ($0.03 per modifiche 1K e $0.09 per modifiche 4K) se hai bisogno della tariffa di editing 4K più bassa su E2X o di proporzioni estreme 8:1 e 1:8.