OpenAI
GPT Image 2
gpt-image-2/text-to-image
Modello di generazione e modifica di immagini di OpenAI, incentrato sul fotorealismo, sul rendering testuale ad alta precisione e sull'output nativo in 4K, adatto a materiali commerciali e immagini di prodotto che contengono testo
Prova gpt-image-2/text-to-image
Input
Creazioni
Vedi tutte le creazioniOutput
imagePrezzi
gpt-image-2/text-to-image per image
| Specifiche | Prezzo unitario |
|---|---|
| 1K | $0.030 |
| 2K | $0.040 |
| 4K | $0.060 |
gpt-image-2/text-to-image @beta per image
| Specifiche | Prezzo unitario |
|---|---|
| With Reference Resources | $0.020 |
gpt-image-2/text-to-image @ext per image
Panoramica e posizionamento
gpt-image-2 è il modello di generazione di immagini da testo di OpenAI, pensato per gli sviluppatori che necessitano di produrre in modo stabile materiali visivi di livello commerciale. Eccelle nel rispettare i molteplici vincoli contenuti in prompt complessi, mantenendo una buona pulizia tipografica in poster, packaging e layout che includono testo, e supporta risoluzioni da 1K a 4K con diversi formati di immagine. Basta inviare un prompt tramite l'interfaccia unificata di HiAPI.ai per ottenere un'immagine: è la scelta ideale per i team che vogliono integrare la generazione di immagini in strumenti di design, pipeline di materiali marketing e back-end di produzione di contenuti.
Punti di forza principali
- Buona aderenza ai prompt complessi——eredita la capacità di comprensione semantica della serie GPT e riesce a generare immagini secondo le intenzioni anche con prompt che contengono contemporaneamente vincoli su soggetto, stile, testo e layout.
- Rendering più affidabile delle immagini con testo——offre buone prestazioni di riproduzione e impaginazione per contenuti testuali in insegne, packaging e layout, riducendo le correzioni manuali del testo dopo la generazione.
- Ampia copertura di risoluzioni e formati——supporta output 1K, 2K e 4K e oltre una decina di proporzioni da 1:1 a 21:9, adattandosi con un'unica integrazione a più specifiche di pubblicazione.
- Più versioni in una singola chiamata——è possibile generare più immagini in una volta, facilitando il confronto di proposte e l'esplorazione di stili con lo stesso prompt.
Descrizione delle capacità
Generazione di immagini da prompt testuale: basta inviare un prompt fino a 20000 caratteri per generare un'immagine, ideale per convertire direttamente descrizioni in linguaggio naturale in materiali visivi utilizzabili.
Output multi-risoluzione e multi-formato: è possibile scegliere tra 1K, 2K e 4K e selezionare il rapporto orizzontale o verticale in base al posizionamento; il rapporto auto e rapporti estremi come 9:21 e 3:1 sono limitati a 1K, mentre il formato 1:1 non supporta 4K.
Output con sfondo trasparente: background supporta le modalità auto, opaque e transparent; le immagini a sfondo trasparente possono essere utilizzate direttamente per compositing e sovrapposizioni. Questo parametro è efficace solo con 1K.
Resa di testo e layout: offre buone prestazioni di rendering e impaginazione per immagini con testo e grafica mista, adatte a visual commerciali dall'aspetto rifinito.
Restituzione di più risultati in una volta: un singolo prompt può produrre più immagini coerenti nello stile, facilitando il confronto rapido delle versioni e la selezione della migliore.
Scenari di utilizzo
- Team marketing: poster pubblicitari e key visual——inserendo il tema della campagna e i requisiti di layout si ottengono key visual di campagna pronti per la pubblicazione o per ritocchi successivi.
- E-commerce: immagini prodotto e rendering in stile fotografia di prodotto——con la descrizione del prodotto come input si generano immagini in stile fotografico da usare in pagine di dettaglio, immagini a scaffale e materiali social.
- Team di design: bozze di packaging e layout con testo——inserendo copy e relazioni testo-immagine si producono bozze di design di packaging, insegne e layout con testo multilingua.
- Piattaforme di contenuti: iterazione di più versioni di proposte——generazione in batch con lo stesso prompt per esplorare stili, sottoponendo le proposte candidate alla revisione prima della versione definitiva.
Limiti e consigli di selezione
Genera solo immagini e non supporta altre modalità come i video. La velocità di generazione è valutata media dall'ufficiale, quindi non è adatto a scenari interattivi in tempo reale estremamente sensibili alla latenza; l'alta risoluzione e la generazione in batch allungano contemporaneamente i tempi e aumentano i costi di chiamata, ed è necessario bilanciare in base alle specifiche di pubblicazione. Per le immagini con testo preciso si consiglia comunque una verifica manuale. Se le esigenze propendono per il ragionamento compositivo in scene complesse o per una velocità di generazione estrema, occorre valutare altri modelli; su HiAPI.ai è disponibile anche la linea image-to-image di questa serie, da utilizzare quando è necessario partire da un'immagine esistente. La fatturazione è a immagine; l'importo specifico è indicato nel pannello dei prezzi.
Novità
Vedi il changelog →- Modifica dei parametri gpt-image-2 aggiunge le risoluzioni 1K / 2K / 4K
Domande frequenti
Vedi tutte le domande →-
Che cos'è GPT Image 2?
GPT Image 2 è il modello text-to-image di OpenAI, adatto per poster, card informative, visual di prodotto e per la generazione di immagini con requisiti espliciti di testo e impaginazione.
-
GPT Image 2 e GPT Image 2.0 sono lo stesso modello?
GPT Image 2.0 è un'abbreviazione comunemente usata nelle ricerche; utilizza l'ID esatto del modello elencato nella pagina di GPT Image 2 e nella documentazione API.
-
Quale endpoint e ID modello utilizza l'API GPT Image 2?
Invia una richiesta a POST /v1/tasks, imposta model su gpt-image-2/text-to-image per la generazione di immagini da testo e passa prompt, aspect_ratio e resolution in input. L'API restituisce prima un taskId, poi recupera l'immagine finale tramite la query del task o il callback.
-
Come si usa GPT Image 2?
Nel Playground, specifica il soggetto, la scena, il layout e il testo che deve apparire, quindi seleziona il formato, la risoluzione e lo sfondo, fai clic su Esegui e visualizza il risultato.
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/text-to-image
routestringOpzionaleValore fisso attuale: default
inputobjectObbligatorio
Oggetto di parametri di business per gpt-image-2/text-to-image e la route default — vedi la tabella dei parametri sotto.
promptstringObbligatoriominLength 1maxLength 20000Prompt testuale, obbligatorio, lunghezza massima 20000 caratteri.
backgroundstringOpzionaleModalità sfondo, supportata solo con risoluzione 1K.
autoopaquetransparentresolutionstringOpzionalePredefinito: "1K"Risoluzione dell'immagine generata, predefinita 1K. Quando aspect_ratio è auto è supportata solo 1K, 1:1 non supporta 4K; quando aspect_ratio è 3:1/1:3/9:21 è supportata solo 1K; quando background è auto/opaque/transparent è supportata solo 1K.
1K2K4Kaspect_ratiostringOpzionalePredefinito: "auto"Proporzioni dell'immagine generata, predefinite auto. Se omesso o impostato su auto è supportata solo la risoluzione 1K.
auto1:13:22:34:33:45:44:5Mostra tutto (8)
16:99:162:11:23:11:321:99:21callbackobjectOpzionale
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.
temppersistentmodelstringObbligatorioValore fisso attuale: gpt-image-2/text-to-image
routestringOpzionaleValore fisso attuale: beta
inputobjectObbligatorio
Oggetto di parametri di business per gpt-image-2/text-to-image e la route beta — vedi la tabella dei parametri sotto.
sizestringOpzionalePredefinito: "auto"pattern ^(auto|[1-9][0-9]{2,4}x[1-9][0-9]{2,4})$Output image size. Use auto or a compliant WIDTHxHEIGHT value such as 2048x2048.
promptstringObbligatoriomaxLength 20000Text prompt describing the image to generate. Max 20000 characters.
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.
temppersistentmodelstringObbligatorioValore fisso attuale: gpt-image-2/text-to-image
routestringOpzionaleValore fisso attuale: ext
inputobjectObbligatorio
Oggetto di parametri di business per gpt-image-2/text-to-image e la route ext — vedi la tabella dei parametri sotto.
promptstringObbligatoriominLength 1maxLength 20000图像生成提示词 Max 20000 characters.
qualitystringObbligatorioPredefinito: "low"lowmediumhighresolutionstringObbligatorioPredefinito: "1K"1K2K4Kaspect_ratiostringOpzionalePredefinito: "1:1"输出画幅比例
auto1:13:22:34:33:45:44:5Mostra tutto (8)
16:99:162:11:23:11:321:99:21callbackobjectOpzionale
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/text-to-image",
"input": {
"prompt": "…",
"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/text-to-image",
input: {
"prompt": "…",
"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/text-to-image",
"input": {
"prompt": "…",
"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"
} # 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/text-to-image@beta",
"input": {
"size": "auto",
"prompt": "…"
}
}' 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/text-to-image@beta",
input: {
"size": "auto",
"prompt": "…"
}
}),
});
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/text-to-image@beta",
"input": {
"size": "auto",
"prompt": "…"
}
},
)
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"
} # 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/text-to-image@ext",
"input": {
"prompt": "…",
"quality": "low",
"resolution": "1K",
"aspect_ratio": "1:1"
}
}' 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/text-to-image@ext",
input: {
"prompt": "…",
"quality": "low",
"resolution": "1K",
"aspect_ratio": "1:1"
}
}),
});
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/text-to-image@ext",
"input": {
"prompt": "…",
"quality": "low",
"resolution": "1K",
"aspect_ratio": "1:1"
}
},
)
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
Come chiamare hailuo-2.3/text-to-video tramite l'API HiAPI: curl, Python ed esempi di richiesta eseguibili
-
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
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
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
-
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
-
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 kling-4.0/image-to-video su HiAPI: curl, Python e polling
-
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
-
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
-
Recraft Creative Upscale Recraft $0.357 /immagine -
Nano Banana Pro Google $0.057 /immagine -
FLUX.2 Klein 9B Black Forest Labs $0.0086 /immagine -
Krea 3 Krea $0.036 /immagine -
Qwen Image 3.0 Alibaba $0.036 /immagine -
851 Labs Background Remover 851 Labs $0.002 /immagine -
Wan 2.7 Image Alibaba $0.035 /immagine -
Ideogram V3 Character Ideogram $0.090 /immagine -
BRIA Product Shot Bria $0.058 /immagine -
GPT Image 2.5 OpenAI $0.017 /immagine -
FLUX.1 Kontext Max Black Forest Labs $0.071 /immagine -
Krea 2 Medium Turbo Krea $0.021 /immagine

