OpenAI
GPT Image 2.6
gpt-image-2.6-sunburst/text-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/text-to-image
Input
Output
imagePrezzi
gpt-image-2.6-sunburst/text-to-image per image
Panoramica della posizione
gpt-image-2.6-sunburst è la linea di text-to-image della famiglia di modelli di generazione di immagini OpenAI, pensata per gli sviluppatori che necessitano di produrre immagini in batch tramite l'interfaccia unificata di HiAPI.ai. Supporta la generazione diretta di immagini da prompt testuali, con formati di output che coprono i comuni formati bitmap, oltre a SVG vettoriale e GIF animate, e consente di controllare le specifiche del prodotto tramite parametri come qualità, risoluzione e rapporto d'aspetto. Sunburst, in particolare, nelle iterazioni multiple con qualità di rendering medium o superiore, mantiene meglio la coerenza dei dettagli dell'immagine, ed è adatto a flussi di lavoro di contenuti visivi che richiedono produzione continua e aggiustamenti ripetuti.
Punti di forza principali
- Coerenza dei dettagli più stabile tra le iterazioni——con qualità di rendering medium o high, durante generazioni o modifiche multiple, Sunburst mantiene meglio la coerenza dei dettagli dell'immagine.
- Formati di output estesi a vettoriale e animazioni——il text-to-image può produrre direttamente file SVG vettoriali e animazioni GIF, riducendo i passaggi di conversione di formato al di fuori dell'interfaccia.
- Qualità di generazione e di pianificazione regolabili separatamente——quality controlla la precisione del rendering, complexity controlla indipendentemente il livello di pianificazione, e può essere aumentato separatamente per testo denso e layout complessi.
- Rapporto d'aspetto che copre i formati commerciali comuni——aspect_ratio offre diverse proporzioni da 1:1 a 21:9, 3:1 e altre, consentendo di produrre in un'unica soluzione le dimensioni corrispondenti al canale di pubblicazione.
Descrizione delle capacità
Generazione di immagini da testo: basta inserire un prompt fino a 32000 caratteri per generare un'immagine; l'output predefinito è png, adatto alla generazione batch tramite script.
Controllo stratificato di qualità di rendering e pianificazione: quality offre cinque livelli di precisione di rendering da low a max, complexity controlla indipendentemente il livello di pianificazione; per layout complessi è possibile aumentare separatamente la pianificazione senza dover alzare complessivamente il livello di rendering.
Impostazione di risoluzione e rapporto d'aspetto: la risoluzione è selezionabile tra 1K, 2K e 4K e, abbinata ai vari rapporti d'aspetto, genera direttamente dimensioni finite conformi al formato desiderato.
Output multiformato e compressione: selezionabile tra png, jpeg, webp, gif, svg; jpeg e webp supportano livelli di compressione da 0 a 100, per bilanciare qualità e dimensione del file.
Sfondo trasparente e animazioni GIF: impostando background su transparent l'output è limitato a png o webp; per le GIF è possibile impostare numero di frame, dimensione dei frame e intervallo tra i frame, con frame rate e formato determinati direttamente dai parametri.
Scenari applicativi
- Produzione rapida di bozze creative per team di design——generare più versioni di bozze con prompt brevi, filtrarle per livello di qualità e rapporto d'aspetto prima di passare alla rifinitura, per confrontare le soluzioni in fase concettuale.
- Produzione continua di asset visivi di brand in serie——generare ripetutamente intorno allo stesso tema, con dettagli più stabili a qualità medio-alta, producendo materiali direttamente utilizzabili per siti web, pagine prodotto e altri contenuti che richiedono uniformità di stile.
- Materiali social e per eventi dei team operativi——generare immagini in batch con proporzioni 1:1, 9:16, 16:9 ecc., compresse per la pubblicazione sui social e sulle landing page degli eventi.
- Generazione di materiali vettoriali e animati per sviluppatori——scegliendo l'output svg o gif si ottengono direttamente grafiche vettoriali o animazioni frame-by-frame, per icone, illustrazioni e animazioni leggere.
Limiti e suggerimenti di scelta
Questa linea supporta solo la generazione di immagini da testo; qualora si necessiti di modificare localmente un'immagine esistente come input, occorre passare alla linea image-to-image. Il vantaggio di coerenza tra le iterazioni di Sunburst presuppone una qualità di rendering medium o high; con livelli di qualità bassi non ci si deve aspettare la stessa stabilità. L'output GIF non supporta il parametro del rapporto d'aspetto; la dimensione dei frame va specificata in pixel e deve rispettare il limite massimo di frame; lo sfondo trasparente è compatibile solo con png e webp. Per scenari con requisiti rigorosi sulla velocità di generazione e che non necessitano di dettagli stabili, si può valutare la linea Flare 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/text-to-image
routestringOpzionaleValore fisso attuale: default
inputobjectObbligatorio
Oggetto di parametri di business per gpt-image-2.6-sunburst/text-to-image e la route default — vedi la tabella dei parametri sotto.
promptstringObbligatoriominLength 1maxLength 32000Descrivi l'immagine da generare, massimo 32000 caratteri.
qualitystringOpzionalePredefinito: "high"Livello di qualità di rendering, valori possibili low, medium, high, xhigh, max; se omesso è high.
lowmediumhighxhighmaxbackgroundstringOpzionaleModalità sfondo, valori possibili auto, opaque, transparent; transparent richiede output png o webp.
autoopaquetransparentcomplexitystringOpzionaleLivello di pianificazione, indipendente dalla qualità di rendering: low è adatto a immagini semplici con un solo soggetto, high è adatto a testo denso e layout complessi; se omesso è high.
lowmediumhighframe_sizestringOpzionalepattern ^(auto|[0-9]+x[0-9]+)$Solo per GIF: larghezza x altezza in pixel di ogni frame, ad esempio 512x512; larghezza e altezza determinano anche le proporzioni della GIF. Entrambi i lati devono essere multipli di 16; non sono accettate notazioni di rapporto come 1:1; se omesso o impostato su auto è 512x512. Tutti i frame vengono uniti in un'unica immagine: ogni lato dell'immagine complessiva non deve superare 3840, il totale dei pixel non deve superare 8.294.400 e il rapporto d'aspetto non deve superare 3:1; in caso di superamento la richiesta viene rifiutata in fase di invio e non viene addebitato alcun costo. Con 512x512 sono supportati da 2 a 16 frame; con 768x768 massimo 12 frame.
moderationstringOpzionaleLivello di moderazione dei contenuti, valori possibili auto o low; se omesso è low.
autolowresolutionstringOpzionalePredefinito: "1K"Livello di risoluzione dell'output, valori possibili 1K, 2K, 4K; se omesso è 1K.
1K2K4Kframe_countintegerOpzionalePredefinito: 9min 2max 16Solo per GIF: numero di frame, intero da 2 a 16; se omesso è 9. Con dimensione frame 768x768 massimo 12 frame.
aspect_ratiostringOpzionalePredefinito: "auto"Rapporto d'aspetto dell'output; se omesso è auto. Non utilizzato per le GIF: se omesso o impostato su auto, usa frame_size per controllare dimensione e proporzioni di ogni frame.
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, gif, svg; se omesso è png. gif produce animazioni, svg produce file vettoriali; questi due formati supportano solo la generazione da testo. Se viene passato output_compression è necessario passare anche jpeg o webp; se viene passato uno qualsiasi tra frame_size, frame_count e frame_duration_ms è necessario passare gif.
pngjpegwebpgifsvgframe_duration_msintegerOpzionalePredefinito: 200min 20Solo per GIF: durata di visualizzazione di ogni frame in millisecondi, minimo 20, arrotondata a multipli di 10 ms; se omesso è 200.
output_compressionintegerOpzionalemin 0max 100Livello di compressione 0–100, utilizzato solo per jpeg o webp; quando si passa 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/text-to-image",
"input": {
"prompt": "…",
"quality": "high",
"resolution": "1K",
"frame_count": 9,
"aspect_ratio": "auto",
"output_format": "png",
"frame_duration_ms": 200
}
}' 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/text-to-image",
input: {
"prompt": "…",
"quality": "high",
"resolution": "1K",
"frame_count": 9,
"aspect_ratio": "auto",
"output_format": "png",
"frame_duration_ms": 200
}
}),
});
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/text-to-image",
"input": {
"prompt": "…",
"quality": "high",
"resolution": "1K",
"frame_count": 9,
"aspect_ratio": "auto",
"output_format": "png",
"frame_duration_ms": 200
}
},
)
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 →-
Guida all'uso
Ray 3.2 image-to-video: trasforma immagini statiche in brevi clip verticali
Trasforma le tue foto di prodotto e i ritratti in clip video 9:16, più un trucco verificato per il loop senza interruzioni con end_image_url
-
Confronto e valutazione
Recraft V4.1 vs Ideogram 4.5:come scegliere tra wordmark e poster?
Due serie di esempi di wordmark e poster con gli stessi prompt di invio, che illustrano le differenze tra interruttore di espansione, livelli di qualità e pixel, proporzioni e formato effettivi.
-
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
Vidu Q4 Preview vs Kling 3.0: come scegliere per il video da immagine?
Con audio di default, 16 secondi e 5 livelli di risoluzione scegli Vidu Q4 Preview; con primo e ultimo frame per bloccare l'immagine scegli Kling 3.0. In allegato due confronti con lo stesso prompt: idrovolante e barista.
-
Tutoriale
Casi di Recraft Creative Upscale: paesaggi e acquerelli ingranditi
Osserva le variazioni di texture su baita, lago e cittadina ad acquerello, distingui il risultato completo dall'anteprima e controlla i dettagli ridisegnati.
-
Guida all'uso
Quanto costa l'API di Vidu Q4 Preview? $0,0515 al secondo a 540p
Stesso prezzo per le due modalità, come viene fatturato con cinque livelli di risoluzione e durata da 3 a 16 secondi, quanti video si possono fare con $10 e il confronto prezzi con gli altri modelli video della piattaforma.
-
Notizie
Ondata di nuovi modelli a novembre: nella lista di voci circolanti ce ne sono 7, quali sono reali
Nella community circola la voce che una serie di nuovi modelli come Gemini 4 Carbon, Claude Fable 5.5, Qwen 4 e Grok 4.8 arriveranno la prossima settimana. Distinguiamo tra voci, confermati e già utilizzabili.
-
Confronto e valutazione
Recraft Creative Upscale vs Crisp Upscale: come scegliere per ingrandire le immagini?
Confronta il ridisegno dei dettagli, il budget e i limiti di input usando le stesse immagini originali per baita e lago; distingui chiaramente tra risultato completo e anteprima dimostrativa.
-
Confronto e valutazione
OmniHuman 1.5 vs HeyGen Avatar IV: come scegliere il parlato guidato dall'audio?
Scegli in base a quattro dimensioni: materiali di input, limite di durata, prezzo e scene con più persone.
Modelli correlati
Vedi tutti i modelli →Stesso tipo
-
BRIA Product Shot Bria $0.058 /immagine -
FLUX.2 Black Forest Labs $0.035 /immagine -
Krea 3 Krea $0.036 /immagine -
Qwen Image 2.0 Alibaba $0.042 /immagine -
Ideogram V3 Character Ideogram $0.090 /immagine -
Nano Banana 2 Lite Google $0.033 /immagine -
Qwen Image 3.0 Alibaba $0.036 /immagine -
Wan 2.7 Image Alibaba $0.035 /immagine -
GPT Image 2.6 OpenAI $0.023 /immagine -
Imagen 4 Google $0.030 /immagine -
Muse Image 1.0 Meta $0.015 per task -
Google Virtual Try-On Google $0.107 /immagine