OpenAI
GPT Image 2.6
gpt-image-2.6-sunburst/image-to-image
Modello OpenAI di generazione e modifica delle immagini in due versioni: Flare punta sulla velocità, Sunburst sulla precisione; produce direttamente GIF animate e grafica vettoriale SVG e supporta la modifica parziale delle immagini
Prova gpt-image-2.6-sunburst/image-to-image
Input
Creazioni
Vedi tutte le creazioniOutput
imagePrezzi
gpt-image-2.6-sunburst/image-to-image per image
Panoramica e posizionamento
gpt-image-2.6-sunburst/image-to-image è un modello dedicato all'editing image-to-image: riceve in input una o più immagini sorgente più una descrizione dell'edit e restituisce l'immagine modificata. Il suo punto di forza è mantenere la coerenza dei dettagli attraverso più round di editing: quando si regolano ripetutamente lo stesso personaggio, prodotto o layout, i dettagli dell'immagine restano più stabili, il che lo rende adatto alla produzione di asset visivi che richiedono iterazioni continue. Gli sviluppatori possono richiamarlo tramite l'interfaccia unificata di HiAPI.ai, con fatturazione per immagine.
Punti di forza principali
- Coerenza dei dettagli su più round di editing——con i livelli di qualità medium o high mantiene la coerenza dei dettagli di personaggi, prodotti e layout tra un round di editing e l'altro, ideale per messe a punto ripetute.
- Editing locale tramite annotazioni——è possibile inviare un livello sovrapposto trasparente con cerchi o annotazioni come indicazione di modifica; le annotazioni stesse non vengono conservate nell'output.
- Composizione multi-sorgente e output in formato largo——supporta l'invio di fino a 16 immagini sorgente in una sola richiesta e offre rapporti d'aspetto da 3:1 a 1:3 e livelli di risoluzione da 1K a 4K.
Descrizione delle capacità
Editing di immagini basato su sorgente: con 1-16 immagini sorgente jpeg, png, webp in input, ridisegna o modifica l'immagine secondo una descrizione dell'edit lunga fino a 32000 caratteri; il tipo di output è indipendente dalla sorgente e può essere convertito direttamente nel formato di consegna desiderato.
Due modalità di localizzazione: maschera e annotazione: con mask_url si invia un PNG RGBA delle stesse dimensioni della prima immagine sorgente, usando i pixel trasparenti per marcare l'area da editare; con markup_url si usa un livello sovrapposto trasparente come indicazione tramite cerchi; le due modalità sono mutuamente esclusive.
Controllo stratificato di qualità e pianificazione: quality controlla il livello di rendering (da low a max), complexity controlla separatamente la profondità di pianificazione; con testi densi e layout complessi è possibile alzare il livello di pianificazione senza dover aumentare contemporaneamente il costo di rendering.
Formato di output e gestione dello sfondo: è possibile scegliere l'output in png, jpeg o webp; jpeg e webp supportano livelli di compressione da 0 a 100; lo sfondo trasparente è limitato a png o webp, ideale per materiali da sovrapporre direttamente a pagine o bozze di design.
Risoluzione e rapporto d'aspetto selezionabili: la risoluzione di output può essere 1K, 2K o 4K; il rapporto d'aspetto può seguire automaticamente l'immagine sorgente oppure essere specificato tra 16 preset da 1:1 a 21:9, così da corrispondere già alla prima generazione al formato di destinazione.
Scenari d'uso
- Team di design: iterazione di immagini di personaggi e serie di prodotti——con un'immagine esistente del personaggio più una descrizione delle modifiche si esegue un editing ripetuto, producendo asset visivi di serie con dettagli stabili, da usare per uniformare materiali di brand e immagini di prodotto.
- Team di marketing: revisione in batch di materiali per campagne——prendendo come sorgente la key visual esistente, si producono materiali in più formati con rapporti d'aspetto e risoluzioni diverse, pronti per la distribuzione e la pubblicazione sui social.
- Sviluppatori: modifiche locali guidate da annotazioni——si carica un livello sovrapposto con cerchi per indicare le aree da modificare e si ottiene l'immagine con le correzioni locali, integrandola nella pipeline di produzione dei contenuti per ridurre il lavoro manuale di rifacimento.
- Frontend e costruzione di pagine: generazione di immagini con sfondo trasparente——usando un'immagine di riferimento come sorgente si ottiene un png o webp con sfondo trasparente, da usare direttamente per elementi di pagina e materiali dei componenti.
Limiti e suggerimenti per la scelta
I limiti riguardano soprattutto i livelli di qualità e le forme di input: il vantaggio della coerenza dei dettagli tra i round vale solo con qualità medium o high e non è garantito con livelli di qualità bassi; maschera e annotazione non possono essere usate contemporaneamente, e la maschera marca solo l'area da editare mentre l'intera immagine può comunque essere ridisegnata; lo sfondo trasparente richiede output in png o webp, e i parametri di compressione hanno effetto solo su jpeg e webp. Se l'attività consiste principalmente nella generazione diretta da testo, senza vincoli di immagine sorgente, conviene passare alla linea text-to-image della stessa famiglia.
Domande frequenti
Vedi tutte le domande →-
Come funziona la fatturazione? Le richieste rifiutate comportano un addebito?
La fatturazione è per immagine e il prezzo unitario dipende dal livello di qualità e dalla risoluzione; consulta la tabella dei prezzi in questa pagina. Flare e Sunburst hanno lo stesso prezzo. Per l'immagine-a-immagine viene addebitato un supplemento di $0.012 per ogni immagine di riferimento. Le GIF sono fatturate separatamente in base al livello di qualità, indipendentemente dalla risoluzione. Le richieste con parametri non validi o con dimensioni GIF oltre il limite vengono rifiutate già in fase di invio; l'importo prerequisito viene restituito per intero, senza alcun addebito.
-
È possibile modificare solo una parte dell'immagine?
Sì, usando la modalità image-to-image, scegliendo una delle due opzioni. La prima è mask_url: invia un PNG RGBA delle stesse dimensioni della prima immagine sorgente; i pixel completamente trasparenti sono le aree da modificare. La seconda è markup_url: invia un'immagine PNG trasparente con annotazioni, indicando con cerchi o altri segni le posizioni da modificare; le annotazioni stesse non appariranno nel risultato. Non è possibile inviare entrambi contemporaneamente. Anche usando una maschera, il modello potrebbe comunque ridipingere leggermente l'intera immagine.
-
Qual è la differenza tra Flare e Sunburst e quale scegliere?
Entrambi hanno parametri, utilizzo e prezzo identici; la differenza sta nell'enfasi. Secondo la presentazione di OpenAI, Flare genera immagini più rapidamente, ed è adatto per iterazioni rapide e generazione in batch, ed è la scelta predefinita consigliata; Sunburst dà più peso ai dettagli e, quando si fanno più cicli di modifica con qualità medium o superiore, mantiene in modo più coerente i dettagli di personaggi, prodotti o layout. In generale conviene usare prima Flare; quando la stessa immagine deve essere modificata più volte e serve stabilità dei dettagli, passare a Sunburst e impostare quality su medium o superiore.
-
È possibile generare direttamente GIF animate o immagini vettoriali SVG?
Sì, nella linea text-to-image basta impostare output_format su gif o svg; la linea image-to-image supporta solo png, jpeg e webp. Il GIF è controllato da tre parametri: frame_size imposta la dimensione in pixel di ogni frame (predefinito 512x512, larghezza e altezza determinano anche le proporzioni del GIF), frame_count imposta il numero di frame (2–16, predefinito 9), frame_duration_ms imposta la durata di ogni frame (predefinito 200 millisecondi). Durante la generazione di un GIF, aspect_ratio va omesso oppure impostato su auto.
Crea un'attività di generazione
https://api.hiapi.ai/v1/tasks Header
AuthorizationstringObbligatorioChiave API dell'account. Obbligatoria in ogni richiesta. Esempio: Bearer YOUR_HIAPI_API_KEY. Ottieni una chiave API
Content-TypestringOpzionaleIl corpo della richiesta viene sempre interpretato come JSON; se inviato, è accettato solo application/json (charset facoltativo) — qualsiasi altro valore restituisce 415. Esempio: application/json.
Idempotency-KeystringOpzionaleChiave di idempotenza, fino a 255 byte. I retry con la stessa chiave dello stesso account creano l'attività una sola volta; i replay restituiscono il taskId originale.
In caso di timeout di rete o retry automatici del client, la stessa chiave crea l'attività una sola volta, senza doppi addebiti (ambito = l'account della chiave API). Usa un identificatore univoco di business (es. "order-42"); i replay restituiscono il taskId originale e le chiavi scadono 24 ore dopo la prima richiesta. La matrice completa degli scenari è nell'introduzione dell'API asincrona unificata.
Corpo
modelstringObbligatorioValore fisso attuale: gpt-image-2.6-sunburst/image-to-image
routestringOpzionaleValore fisso attuale: default
inputobjectObbligatorio
Oggetto di parametri di business per gpt-image-2.6-sunburst/image-to-image e la route default — vedi la tabella dei parametri sotto.
promptstringObbligatoriominLength 1maxLength 32000Descrivi le modifiche da apportare all'immagine di origine o la scena da generare basandoti sull'immagine di origine, massimo 32000 caratteri.
qualitystringOpzionalePredefinito: "high"Livello di qualità di rendering, valori possibili: low, medium, high, xhigh, max; se non specificato, il valore predefinito è high.
lowmediumhighxhighmaxmask_urlstringOpzionaleURL dell'immagine maschera: un PNG RGBA con le stesse dimensioni della prima immagine di origine, in cui i pixel completamente trasparenti indicano le aree da modificare; l'intera immagine potrebbe comunque essere ridisegnata leggermente. Non può essere inviato insieme a markup_url.
backgroundstringOpzionaleModalità sfondo, valori possibili: auto, opaque, transparent; transparent richiede un output in png o webp.
autoopaquetransparentcomplexitystringOpzionaleLivello di pianificazione, indipendente dalla qualità di rendering: low è adatto a modifiche locali e puntuali, high è adatto a testo denso e layout complessi; se non specificato, il valore predefinito è high.
lowmediumhighimage_urlsarrayObbligatoriominItems 1maxItems 16Array di URL delle immagini di origine, da 1 a 16 immagini http(s) accessibili pubblicamente, supporta jpeg, png, webp.
Array [ string ]
markup_urlstringOpzionaleURL dell'immagine di annotazione: un livello PNG trasparente che indica con cerchiature e altri segni le posizioni da modificare; le annotazioni stesse non appariranno nel risultato. Non può essere inviato insieme a mask_url.
moderationstringOpzionaleLivello di moderazione dei contenuti, valori possibili: auto o low; se non specificato, il valore predefinito è low.
autolowresolutionstringOpzionalePredefinito: "1K"Livello di risoluzione dell'output, valori possibili: 1K, 2K, 4K; se non specificato, il valore predefinito è 1K.
1K2K4Kaspect_ratiostringOpzionalePredefinito: "auto"Rapporto d'aspetto dell'output; se non specificato, il valore predefinito è auto, ovvero segue il rapporto dell'immagine di origine.
auto1:13:22:34:33:45:44:5Mostra tutto (8)
16:99:162:11:221:99:213:11:3output_formatstringOpzionalePredefinito: "png"Formato di output, valori possibili: png, jpeg, webp; se non specificato, il valore predefinito è png. Se viene inviato output_compression, è necessario inviare anche jpeg o webp.
pngjpegwebpoutput_compressionintegerOpzionalemin 0max 100Livello di compressione 0–100, utilizzabile solo con jpeg o webp; quando si invia questo parametro è necessario impostare anche output_format su jpeg o webp.
callbackobjectOpzionale
Configurazione di notifica dello stato terminale. Se omessa, nessun callback: interroga l'attività per conto tuo.
Fornisci callback.url in creazione e HiAPI invierà un POST al tuo servizio allo stato terminale, senza polling. Il corpo del callback replica la struttura del dettaglio attività; verifica firma, retry e idempotenza sono descritti nell'introduzione dell'API asincrona unificata.
urlstringObbligatorioObbligatoria se è presente callback. Allo stato terminale viene inviato un POST a questo URL; deve essere un URL http(s) valido.
whenstringOpzionalePredefinito: "final"Al momento è supportato solo final: notifica sia su success sia su fail.
finalstoragestringOpzionalePredefinito: "temp"Livello di archiviazione degli artefatti: temp (predefinito, ~7 giorni) o persistent (a lungo termine, fatturato per dimensione). Saldo insufficiente o superamento del limite ⇒ declassamento silenzioso a temp; il livello effettivo è visibile nella risposta di dettaglio.
temppersistentEsempi di richiesta
# Invia un'attività asincrona; restituisce subito un taskId (senza attendere la generazione)
curl -X POST "https://api.hiapi.ai/v1/tasks" \
-H "Authorization: Bearer $HIAPI_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "gpt-image-2.6-sunburst/image-to-image",
"input": {
"prompt": "…",
"quality": "high",
"image_urls": "…",
"resolution": "1K",
"aspect_ratio": "auto",
"output_format": "png"
}
}' const res = await fetch("https://api.hiapi.ai/v1/tasks", {
method: "POST",
headers: {
Authorization: `Bearer ${process.env.HIAPI_API_KEY}`,
"Content-Type": "application/json",
},
body: JSON.stringify({
model: "gpt-image-2.6-sunburst/image-to-image",
input: {
"prompt": "…",
"quality": "high",
"image_urls": "…",
"resolution": "1K",
"aspect_ratio": "auto",
"output_format": "png"
}
}),
});
const task = await res.json();
// { code: 200, message: "success", data: { taskId } } import os, requests
res = requests.post(
"https://api.hiapi.ai/v1/tasks",
headers={"Authorization": f"Bearer {os.environ['HIAPI_API_KEY']}"},
json={
"model": "gpt-image-2.6-sunburst/image-to-image",
"input": {
"prompt": "…",
"quality": "high",
"image_urls": "…",
"resolution": "1K",
"aspect_ratio": "auto",
"output_format": "png"
}
},
)
print(res.json()) # { code, message, data: { taskId } } 200 OK
{
"code": 200,
"message": "success",
"data": {
"taskId": "tk-hiapi-01HZTQ8BX2N3GM3YFK4Z9D7VQR"
}
} 400 Bad Request
{
"code": 400,
"message": "invalid request",
"data": null,
"error_code": "INVALID_REQUEST"
} Ottieni i dettagli dell'attività
https://api.hiapi.ai/v1/tasks/:id Campi della risposta
taskIdstringObbligatorioID attività, sempre con prefisso tk-hiapi-.
modelstringObbligatorioNome completo risolto del modello. Le attività inviate con il parametro route restituiscono base@route (es. gpt-image-2/text-to-image@ext); altrimenti coincide con il nome inviato.
routestringOpzionalePresente solo se è stato usato il parametro route esplicito; restituisce il valore inviato.
statusstringObbligatorioStato dell'attività.
queued In coda, non avviata.
handling In elaborazione.
archiving Elaborazione conclusa, preparazione artefatti.
success Terminale: completato, artefatti disponibili (restituisce output).
fail Terminale: errore (restituisce error).
Dopo l'invio, segui status: success e fail sono terminali, il resto no. Esegui polling ogni 1–3 s fino allo stato terminale. In caso di successo scarica gli artefatti da output[].url e trasferiscili prima di expireAt; per conservazione lunga usa storage: "persistent" in creazione.
creatednumberObbligatorioIstante di creazione dell'attività (secondi Unix).
completednumberObbligatorioSecondi Unix dello stato terminale; 0 finché non terminale.
outputarrayOpzionale
Presente solo con status == success. Elenco artefatti — sempre un array; un'attività può restituire più type contemporaneamente (es. video + first_frame).
Array [ object ]
Elementi dell'array
urlstringObbligatorioURL dell'artefatto, scaricabile direttamente.
typestringObbligatorioValori attualmente possibili: video, image, audio, first_frame, last_frame, thumbnail; potrebbero essere ampliati in futuro.
expireAtnumberObbligatorioSecondi Unix di disponibilità dell'artefatto; scarica o trasferisci prima della scadenza.
errorobjectOpzionale
Presente solo con status == fail.
codestringObbligatorioCodice errore di business.
messagestringObbligatorioDescrizione dell'errore.
Esempi di risposta
Successo
{
"code": 200,
"message": "success",
"data": {
"taskId": "tk-hiapi-01HZTQ8BX2N3GM3YFK4Z9D7VQR",
"model": "happyhorse-1-0",
"status": "success",
"created": 1777282033,
"completed": 1777282099,
"output": [
{
"url": "https://cdn.hiapi.ai/tasks/.../video.mp4",
"type": "video",
"expireAt": 1777886899
}
]
}
} In elaborazione (non terminale)
{
"code": 200,
"message": "success",
"data": {
"taskId": "tk-hiapi-...",
"model": "happyhorse-1-0",
"status": "archiving",
"created": 1777282033,
"completed": 0
}
} Non riuscito
{
"code": 200,
"message": "success",
"data": {
"taskId": "tk-hiapi-...",
"model": "happyhorse-1-0",
"status": "fail",
"created": 1777282033,
"completed": 1777282099,
"error": {
"code": "TASK_FAILED",
"message": "task failed"
}
}
} Articoli
Vedi tutti gli articoli →-
Tutoriale
Tutorial di integrazione delle API di GPT Image 2.6: scelta tra Flare e Sunburst, guida pratica all'output GIF e SVG
Dalla scelta dell'ID modello all'implementazione dei parametri per la generazione da testo e da immagine: in una guida chiara i parametri dei frame GIF e l'output SVG
-
Confronto e valutazione
GPT Image 2.6 vs 2.5: test pratico con lo stesso prompt, l'aggiornamento vale la pena?
Con lo stesso prompt del bancone da caffè, dove si vede davvero la differenza tra 0,049 e 0,025
-
Guida all'uso
Prezzi API di GPT Image 2.6: come si calcolano livelli di qualità, risoluzione e formato di output
-
Confronto e valutazione
gpt-image-2.6-sunburst/image-to-image confronto orizzontale: come scegliere un modello image-to-image e migrare
Dai confini di capacità al costo per immagine fino al costo di migrazione: la checklist di scelta per i team di ingegneria
-
Tutoriale
gpt-image-2.6-sunburst da immagine a immagine in pratica: 5 scenari di business ad alto valore e punti chiave di integrazione
Dalla scelta degli scenari alla stima dei costi: guida pratica alla generazione di immagini dal punto di vista dello sviluppatore
-
Tutoriale
GPT Image 2.6 in pratica: GIF in pixel art, loghi vettoriali SVG e ritocco localizzato con mask_url
Tre configurazioni di parametri da copiare direttamente: numero di fotogrammi e frame_size per le GIF, output SVG e relativi prezzi, ritocco localizzato con mask_url
-
Guida all'uso
Guida pratica a GPT-image-2.6-sunburst per image-to-image: limiti di capacità, fatturazione e pratiche ingegneristiche
Percorso pratico per sviluppatori dall'integrazione al go-live: capacità, parametri, costi e migliori pratiche
Modelli correlati
Vedi tutti i modelli →Stesso tipo
-
Ideogram V3 Character Ideogram $0.090 /immagine -
Nano Banana 2 Lite Google $0.033 /immagine -
Muse Image 1.0 Meta $0.015 per task -
FLUX.2 Klein 4B Black Forest Labs $0.0004 /immagine -
Ideogram V4 Ideogram $0.050 /immagine -
FLUX.1 Kontext Max Black Forest Labs $0.071 /immagine -
FLUX.1 Schnell Black Forest Labs $0.005 /immagine -
Nano Banana 2 Google $0.018 /immagine -
Recraft V4.1 Recraft $0.010 /immagine -
Nano Banana Pro Google $0.029 /immagine -
Qwen Image 2.0 Alibaba $0.042 /immagine -
Imagen 4 Google $0.030 /immagine














