OpenAI
GPT Image 2.5
gpt-image-2.5-sunburst/image-to-image
Modello OpenAI di generazione e modifica delle immagini a due livelli, Flare punta sulla velocità, Sunburst sulla precisione, con supporto sia per la generazione di immagini da testo sia per modifiche iterative
Prova gpt-image-2.5-sunburst/image-to-image
Input
Creazioni
Vedi tutte le creazioniOutput
imagePrezzi
gpt-image-2.5-sunburst/image-to-image per image
| Specifiche | Prezzo unitario |
|---|---|
| 1K | $0.050 |
| 2K | $0.080 |
| 4K | $0.120 |
Panoramica della posizione
La linea di editing delle immagini di gpt-image-2.5-sunburst è pensata per gli sviluppatori che necessitano di modifiche e ampliamenti ad alta fedeltà su immagini esistenti. Riceve da una a sedici immagini di riferimento e un'istruzione di editing, restituisce immagini con risoluzione 1K, 2K o 4K e supporta proporzioni personalizzate e sfondo trasparente; è adatta a flussi di lavoro di rifinitura progettuale in cui si vuole mantenere la coerenza del soggetto attraverso più iterazioni. Sunburst scambia tempi di elaborazione più lunghi con una maggiore precisione nel ripristino dei dettagli.
Punti di forza principali
- Linea di editing orientata alla precisione — la variante Sunburst scambia tempi di elaborazione singola più lunghi con un ripristino dei dettagli più fine, adatta alle attività di editing sensibili alla qualità del risultato finale.
- Fino a sedici immagini di riferimento in input congiunto — in una singola richiesta è possibile inviare da una a sedici immagini sorgente o di riferimento, per affidare al modello le informazioni su soggetto, stile e impaginazione insieme.
- Quattro opzioni di formato e risoluzione — l'output supporta tre livelli di risoluzione (1K, 2K, 4K) e tredici proporzioni, per adattarsi direttamente alle specifiche del prodotto finito e ridurre i ritagli successivi.
- Sfondo trasparente disponibile a 1K — la modalità sfondo trasparente è limitata alla risoluzione 1K; i materiali trasparenti generati possono entrare direttamente nel flusso di compositing successivo.
Descrizione delle capacità
Editing condizionato da più immagini di riferimento: tramite image_urls si inviano da una a sedici immagini JPEG, PNG o WebP, insieme a un'istruzione di editing fino a ventimila caratteri, per riscrivere, sostituire ed estendere materiali esistenti.
Controllo di risoluzione e formato: resolution seleziona il livello di output 1K, 2K o 4K; aspect_ratio supporta tredici proporzioni da 1:1 a 21:9; il valore predefinito auto è deciso dal modello.
Generazione con sfondo trasparente: background può essere impostato su transparent, opaque o auto; la modalità trasparente è disponibile solo a risoluzione 1K, per produrre direttamente materiali senza necessità di scontorno.
Ripristino fine dei dettagli: la variante Sunburst privilegia la fedeltà ai dettagli, avvicinandosi maggiormente all'immagine di riferimento per texture, illuminazione e struttura dell'impaginazione, ed è adatta ai cicli di editing con requisiti elevati sul risultato finale.
Casi d'uso
- Revisione in blocco di materiali di brand esistenti da parte dei team di design — si inviano le bozze visive del brand come immagini di riferimento, si sostituiscono testi e colori con istruzioni uniformi e si producono set completi di materiali per le campagne.
- Rifinitura di immagini prodotto e di scena per l'e-commerce — con foto reali del prodotto come input si generano immagini finite con sfondo o scena diversi, da usare direttamente nelle pagine di dettaglio prodotto e nei materiali pubblicitari.
- Iterazioni multiple sulla stessa immagine da parte dei creativi — si continua a usare il risultato corrente come input aggiungendo istruzioni, convergendo gradualmente verso la versione definitiva e ottenendo immagini di design consegnabili direttamente.
- Necessità di grafica con fondo trasparente nella produzione di materiali — con immagine di riferimento e istruzione di editing si genera un'immagine 1K con sfondo trasparente, da usare come livello nei successivi compositing e impaginazione.
Limiti e suggerimenti per la scelta
Sunburst privilegia la precisione e richiede tempi più lunghi per singola richiesta, quindi non è adatto a scenari di generazione con bassa latenza o concorrenza molto elevata; gli output 2K e 4K aumentano ulteriormente i costi di calcolo e i tempi di attesa; lo sfondo trasparente è limitato a 1K. Le impaginazioni con molti caratteri piccoli o legende complesse restano soggette a errori: si consiglia una verifica manuale dopo l'output. Se servono distribuzione locale, fine-tuning autonomo o inferenza offline, questo modello closed-source non può soddisfare tali esigenze e occorre scegliere un'altra soluzione. Per una generazione rapida in blocco si può considerare la linea Flare della stessa famiglia.
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.5-sunburst/image-to-image
routestringOpzionaleValore fisso attuale: default
inputobjectObbligatorio
Oggetto di parametri di business per gpt-image-2.5-sunburst/image-to-image e la route default — vedi la tabella dei parametri sotto.
promptstringObbligatoriominLength 1maxLength 20000Istruzione di generazione o modifica, utilizzata per descrivere il contenuto da generare o modificare in base all'immagine di origine, in forma di stringa, con una lunghezza massima di 20000 caratteri.
backgroundstringOpzionaleModalità sfondo, in forma di stringa; supportata solo alla risoluzione 1K, con 2K/4K omettere questo parametro.
transparentopaqueautoimage_urlsarrayObbligatoriominItems 1maxItems 16Array di immagini di origine o di riferimento, i cui elementi sono immagini in formato JPEG, PNG o WebP, in numero da 1 a 16.
Array [ string ]
resolutionstringOpzionalePredefinito: "1K"Livello di risoluzione dell'output, in forma di stringa, predefinito 1K; quando background è auto/opaque/transparent è supportata solo la risoluzione 1K.
1K2K4Kaspect_ratiostringOpzionalePredefinito: "auto"Rapporto larghezza/altezza dell'output, in forma di stringa, predefinito auto; se omesso viene anch'esso trattato come auto.
auto1:13:22:34:33:416:99:16Mostra tutto (5)
21:927:1616:279:88:9callbackobjectOpzionale
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.5-sunburst/image-to-image",
"input": {
"prompt": "…",
"image_urls": "…",
"resolution": "1K",
"aspect_ratio": "auto"
}
}' 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.5-sunburst/image-to-image",
input: {
"prompt": "…",
"image_urls": "…",
"resolution": "1K",
"aspect_ratio": "auto"
}
}),
});
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.5-sunburst/image-to-image",
"input": {
"prompt": "…",
"image_urls": "…",
"resolution": "1K",
"aspect_ratio": "auto"
}
},
)
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
recraft-v4.1-flash text-to-image in pratica: 5 scenari di business ad alto valore e punti chiave di integrazione
Partendo da un costo di $0,01 per immagine, pianificare l'implementazione della generazione di immagini nei processi di business reali
-
Tutoriale
Come chiamare hailuo-2.3-fast/image-to-video tramite l'API HiAPI: pratica con curl e Python
La prima richiesta funzionante per il livello image-to-video veloce ed economico — dall'ID del modello al download di un MP4
-
Confronto e valutazione
Confronto orizzontale di Recraft v4.1 Flash per la generazione di immagini da testo: guida alla scelta e alla migrazione per gli sviluppatori
Con un costo di $0,01 per immagine e la capacità di generazione puramente testuale, valuta se è adatto alla tua pipeline di generazione di immagini
-
Tutoriale
Come chiamare hailuo-2.3/text-to-video tramite l'API HiAPI: curl, Python ed esempi di richiesta eseguibili
-
Tutoriale
Come chiamare kling-4.0/image-to-video su HiAPI: curl, Python e polling
-
Confronto e valutazione
hailuo-2.3-fast/image-to-video confronto orizzontale: come scegliere un modello image-to-video e i punti chiave per la migrazione
-
Tutoriale
Tutorial su kandinsky-6.0-pro/image-to-video tramite HiAPI: curl + Python
Avvia una richiesta funzionante di image-to-video su HiAPI: dal caricamento del primo fotogramma al polling asincrono fino al download finale
-
Tutoriale
Come usare kling-4.0/text-to-video tramite l'API HiAPI: curl, Python e un esempio di richiesta funzionante
Guida pratica per sviluppatori: prompt cinematografici, audio sincronizzato, polling asincrono e download dell'output
-
Tutoriale
Utilizzare Kandinsky 6.0 Pro su HiAPI per la generazione di video da testo: tutorial con curl e Python
Dimostrazione pratica guidata dalla richiesta: costruire la chiamata da prompt a clip video, inviare la richiesta, monitorare lo stato di completamento e scaricare il risultato
Modelli correlati
Vedi tutti i modelli →Stesso tipo
-
Nano Banana 2 Google $0.036 /immagine -
Qwen Image 2.0 Alibaba $0.042 /immagine -
Muse Image 1.0 Meta $0.015 per task -
FLUX.1 Schnell Black Forest Labs $0.005 /immagine -
851 Labs Background Remover 851 Labs $0.002 /immagine -
Qwen Image 3.0 Alibaba $0.036 /immagine -
Ideogram V4.5 Ideogram $0.011 /immagine -
Ideogram V4 Ideogram $0.050 /immagine -
FLUX.1 Kontext Max Black Forest Labs $0.071 /immagine -
Grok Imagine Image 2.0 xAI $0.052 /immagine -
FLUX.2 Black Forest Labs $0.035 /immagine -
Wan 2.7 Image Alibaba $0.035 /immagine







