OpenAI
GPT Image 2.6
gpt-image-2.6-flare/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-flare/image-to-image
Input
Output
imagePrezzi
gpt-image-2.6-flare/image-to-image per image
Panoramica
Il modello image-to-image gpt-image-2.6-flare è pensato per gli sviluppatori che necessitano di modificare, estendere e ricreare materiali esistenti. Prende in input un'immagine sorgente e usa il prompt come istruzione di modifica, accettando fino a 16 immagini di riferimento per singola richiesta; supporta inoltre il ritocco locale tramite maschera, i suggerimenti con annotazioni e output a risoluzione da 1K a 4K. È adatto per integrare capacità di editing delle immagini in flussi automatizzati quali produzione di contenuti, materiali per e-commerce e generazione di immagini per il marketing.
Punti di forza
- Fino a 16 immagini sorgente per richiesta — più immagini di riferimento possono fungere contemporaneamente da base per l'editing, riducendo le chiamate frazionate e la ricomposizione dei risultati.
- Due modalità di controllo locale: maschera e annotazione — la maschera designa l'area da ridisegnare, l'immagine annotata serve a evidenziare i suggerimenti e non viene mantenuta nell'output; le due modalità non possono essere usate contemporaneamente.
- Qualità e complessità regolabili separatamente — qualità di rendering e complessità di pianificazione hanno livelli distinti, consentendo di scegliere in base alla difficoltà del compito senza dover alzare o abbassare l'intera configurazione.
- Risoluzione e formato specificabili in base all'output — supporta 1K, 2K, 4K e vari rapporti d'aspetto, oppure può seguire l'immagine sorgente o essere deciso automaticamente dal modello.
Descrizione delle capacità
Editing guidato da istruzioni basato sull'immagine sorgente: descrive l'intento di modifica tramite prompt e completa l'editing con 1-16 immagini sorgente jpeg, png o webp; è adatto a interventi mirati sull'immagine originale anziché alla generazione da zero.
Ritocco locale con maschera: si passa una maschera RGBA PNG della stessa dimensione della prima immagine sorgente, in cui i pixel trasparenti indicano l'area da modificare; anche le aree esterne alla maschera possono subire lievi variazioni.
Annotazioni per localizzare le modifiche: si usa un PNG trasparente con annotazioni quali cerchiature come suggerimento ausiliario per guidare il modello verso l'area di interesse; l'annotazione non compare nell'output.
Controllo del formato di output e dello sfondo: è possibile scegliere output png, jpeg o webp; jpeg e webp supportano livelli di compressione da 0 a 100; per uno sfondo trasparente il formato di output è limitato a png o webp.
Livelli di qualità, complessità e moderazione dei contenuti: la qualità di rendering ha cinque livelli e la complessità di pianificazione tre, adattabili rispettivamente a ritocchi accurati e a compiti con testo fitto e layout complessi; la moderazione dei contenuti può essere automatica o bassa.
Scenari d'uso
- Iterazioni multiple dei team di design su materiali esistenti — si inseriscono bozze visive già esistenti e note di modifica, regolando composizione e dettagli turno dopo turno per produrre asset pronti per la revisione.
- Ricreazione di materiali per team e-commerce e brand — usando immagini prodotto o key visual come sorgente, si sostituiscono sfondi, si estendono scene o si correggono dettagli per ottenere immagini di prodotti e campagne pubblicabili.
- Flussi di compositing e ritocco locale — con maschere o annotazioni si individua l'area da modificare, intervenendo solo sulla parte designata per produrre grafiche da impiegare in poster, pagine di dettaglio e altri layout.
- Esigenze di consegna ad alta risoluzione — si specificano direttamente risoluzione 2K o 4K e rapporto d'aspetto desiderato, riducendo le fasi successive di ingrandimento e ritaglio.
Limiti e consigli per la scelta
Questo è un modello di editing image-to-image e non dispone della capacità di generare immagini da testo; per creare un'immagine da zero occorre passare alla linea text-to-image della stessa famiglia. Il controllo locale dipende da maschere o annotazioni e anche le aree esterne alla maschera possono subire lievi variazioni. L'output con sfondo trasparente è vincolato al formato e va abbinato a png o webp; i livelli di compressione valgono solo per jpeg e webp. Quando è necessario mantenere la coerenza dei dettagli attraverso più turni di editing, si può scegliere la linea Sunburst 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-flare/image-to-image
routestringOpzionaleValore fisso attuale: default
inputobjectObbligatorio
Oggetto di parametri di business per gpt-image-2.6-flare/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 l'immagine da generare a partire da essa, fino a un massimo di 32000 caratteri.
qualitystringOpzionalePredefinito: "high"Livello di qualità di rendering; valori ammessi: low, medium, high, xhigh, max; se omesso è high.
lowmediumhighxhighmaxmask_urlstringOpzionaleURL della 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 ammessi: auto, opaque, transparent; transparent richiede un output png o webp.
autoopaquetransparentcomplexitystringOpzionaleLivello di pianificazione, indipendente dalla qualità di rendering: low è adatto a modifiche locali e puntuali, high a testi densi e layout complessi; se omesso è high.
lowmediumhighimage_urlsarrayObbligatoriominItems 1maxItems 16Array di URL delle immagini di origine: da 1 a 16 immagini http(s) accessibili pubblicamente, nei formati jpeg, png, webp.
Array [ string ]
markup_urlstringOpzionaleURL dell'immagine di annotazione: un livello PNG trasparente che indica con cerchi e altri contrassegni le posizioni da modificare; le annotazioni non compaiono nel risultato. Non può essere inviato insieme a mask_url.
moderationstringOpzionaleLivello di moderazione dei contenuti; valori ammessi: auto o low; se omesso è low.
autolowresolutionstringOpzionalePredefinito: "1K"Livello di risoluzione dell'output; valori ammessi: 1K, 2K, 4K; se omesso è 1K.
1K2K4Kaspect_ratiostringOpzionalePredefinito: "auto"Proporzioni dell'output; se omesso è auto, ovvero segue le proporzioni 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 ammessi: png, jpeg, webp; se omesso è png. Se viene inviato output_compression, occorre inviare anche jpeg o webp.
pngjpegwebpoutput_compressionintegerOpzionalemin 0max 100Livello di compressione da 0 a 100, valido solo per jpeg o webp; quando si invia questo parametro occorre 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-flare/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-flare/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-flare/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
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
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.
-
Confronto e valutazione
Wan 2.6 Flash vs Wan 2.7: conviene aggiornare?
Budget 720P e risultati 1080P di volpe e auto; condizioni audio e livello effettivo indicati per ogni gruppo.
-
Confronto e valutazione
Qwen Image 3.0 vs Nano Banana 2: prezzi, risoluzione, immagini di riferimento e come scegliere
Prezzi unitari 1K/2K/4K, fatturazione delle immagini di riferimento, differenze nei campi delle richieste, più tre serie di test pratici con lo stesso prompt, per aiutarti a scegliere l'API di immagini giusta su HiAPI.
-
Confronto e valutazione
Alternativa a Replicate: confronto hiapi vs Replicate per la generazione di immagini e video (2026)
Cosa cambia nelle chiamate di prediction, nei webhook e nella fatturazione quando si migra da Replicate a hiapi, con una checklist di migrazione in 10 passaggi.
-
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.
-
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
Prezzo API Recraft Creative Upscale: $0.3575 per immagine
Calcola il budget di ingrandimento per immagine, distinguendo limiti di input, miniature di anteprima e risultati completi per comprendere la ridisegnatura dei dettagli.
Modelli correlati
Vedi tutti i modelli →Stesso tipo
-
Ideogram V4 Ideogram $0.050 /immagine -
Wan 2.7 Image Alibaba $0.035 /immagine -
Nano Banana Google $0.011 /immagine -
Seedream 4.5 ByteDance $0.045 /immagine -
FLUX.1 Schnell Black Forest Labs $0.005 /immagine -
Qwen Image 3.0 Alibaba $0.036 /immagine -
Krea 2 Medium Turbo Krea $0.021 /immagine -
Muse Image 1.0 Meta $0.015 per task -
GPT Image 2.5 OpenAI $0.017 /immagine -
Recraft V4.1 Recraft $0.010 /immagine -
Nano Banana 2 Google $0.018 /immagine -
FLUX.2 Klein 9B Black Forest Labs $0.0086 /immagine