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
Output
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 →-
Confronto e valutazione
Mureka 9.5 vs MiniMax Music 2.6: con lo stesso testo, quale fa per te
Confronto voce per voce di campi di input, limite del testo, capacità vocali e strumentali, prezzo unitario e durata dell'output, con l'audio delle due versioni dello stesso testo sui due modelli.
-
Guida all'uso
Cos'è GPT Image 2.6? Modifica markup e specifiche note
Tutte le informazioni su GPT Image 2.6 nella specifica dell'API OpenAI, come usare il nuovo parametro di modifica markup, e cosa non è ancora stato annunciato.
-
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.
-
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.
-
Guida all'uso
Quanto costa l'API Qwen Image 2.1? Pro $0.05 per immagine
Il prezzo per immagine di Pro e Turbo, il budget per volumi diversi, il confronto con gli altri modelli di immagini della piattaforma e come scegliere tra i due livelli.
-
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
Quanto costa l'API Mureka 9.5? Una canzone a $0.3215
Prezzi dei due percorsi testo-a-canzone e strumentale, budget per diversi volumi di produzione, confronto con altri modelli musicali sul sito e come scegliere tra i due percorsi.
-
Tutoriale
Chiave API OpenAI non valida: 401, variabili d'ambiente e verifica della configurazione di progetto
Distingui gli errori 401, 403 e 429 di OpenAI, controlla variabili d'ambiente, impostazioni di organizzazione e progetto e verifica le credenziali con una richiesta in sola lettura.
-
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
Modelli correlati
Vedi tutti i modelli →Stesso tipo
-
FIBO 1.5 Bria $0.058 /immagine -
FLUX.1 Fill Pro Black Forest Labs $0.071 /immagine -
Wan 2.7 Image Alibaba $0.035 /immagine -
FLUX 1.1 Pro Black Forest Labs $0.050 /immagine -
FLUX.2 Klein 9B Black Forest Labs $0.0086 /immagine -
Nano Banana Google $0.011 /immagine -
Z-Image Alibaba $0.008 /immagine -
FLUX.2 Black Forest Labs $0.035 /immagine -
Muse Image 1.0 Meta $0.015 per task -
Nano Banana Pro Google $0.029 /immagine -
Recraft Crisp Upscale Recraft $0.004 /immagine -
BRIA Eraser Bria $0.058 /immagine