OpenAI

GPT Image 2

gpt-image-2/image-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

Route

default ext beta

gpt-image-2/image-to-image gpt-image-2/text-to-image

Prova gpt-image-2/image-to-image

Input

Creazioni

Vedi tutte le creazioni

Output

image

Compila i parametri e genera: i risultati appariranno qui.

Prezzi

gpt-image-2/image-to-image per image

Specifiche	Prezzo unitario
1K	$0.030
2K	$0.040
4K	$0.060

Panoramica e posizionamento

gpt-image-2/image-to-image è la linea della famiglia di modelli di immagini OpenAI dedicata alla rigenerazione e alla modifica delle immagini: riceve da 1 a 16 immagini di riferimento e un prompt testuale, restituendo un'immagine ricostruita. È adatta agli scenari di sviluppo in cui occorre riscrivere, estendere, uniformare lo stile o sostituire il layout partendo da materiali già esistenti, e consente di scegliere il formato in base alle specifiche di pubblicazione e una risoluzione massima fino a 4K. Rispetto alla pura generazione da testo, il valore di questa linea sta nell'ancorare il risultato alle immagini di riferimento fornite dallo sviluppatore.

Punti salienti

Input con più immagini di riferimento — in una singola chiamata si possono inviare da 1 a 16 immagini di riferimento, usando l'insieme dei materiali come base della generazione anziché affidarsi solo alla descrizione testuale.
Formato scelto in base alle specifiche di pubblicazione — sono inclusi oltre dieci rapporti, da 1:1 e 16:9 fino a 21:9 e 9:21, allineabili direttamente a landing page, feed e materiali verticali.
Risoluzione massima fino a 4K — sono supportate tre fasce di output, 1K, 2K e 4K; il formato 1:1 non supporta il 4K, mentre l'alta risoluzione è utilizzabile per materiali di livello tipografico o per grandi schermi.
Supporto all'output con sfondo trasparente — a 1K è possibile scegliere la modalità di sfondo trasparente, opaca o automatica, per sovrapporre direttamente il risultato ad altri livelli di progettazione.

Descrizione delle capacità

Riscrittura dell'immagine guidata da riferimenti: genera una nuova immagine a partire da quella di input, adatta a sostituire lo stile, modificare la composizione o creare varianti basate su materiali esistenti; il risultato eredita gli indizi visivi delle immagini di riferimento.

Controllo combinato di formato e risoluzione: le specifiche di output sono determinate dai due parametri aspect_ratio e resolution; scegliendo auto o rapporti d'aspetto particolari il formato è limitato a 1K, quindi è necessario vincolare i parametri in anticipo.

Controllo della modalità di sfondo: il parametro background offre i valori auto, opaque e transparent, attivo solo alla risoluzione 1K, adatto a flussi successivi che richiedono rimozione dello sfondo o compositing a livelli.

Vincoli sui prompt lunghi: prompt ha un limite di 20000 caratteri, consentendo di inserire in un'unica soluzione più vincoli, indicazioni di layout e contenuti testuali, riducendo le descrizioni supplementari su più turni.

Unione di più materiali: input_urls consente di passare più immagini in una sola volta, fornendo separatamente soggetto, riferimenti di stile ed esempi di layout, che il modello combina in un'unica immagine di output.

Scenari d'uso

Estensione multi-formato del key visual da parte dei team di design — caricando il key visual e i requisiti dei diversi formati, si producono in batch versioni adatte a feed, schermate di avvio e verticali, che entrano direttamente nella libreria dei materiali pubblicitari.
Rigenerazione contestuale delle immagini prodotto per l'e-commerce — inviando foto reali dei prodotti, si generano immagini finite con sfondi e illuminazioni diverse, da usare per sostituire quelle nelle pagine di dettaglio e negli spazi pubblicitari.
Iterazione del layout testo-immagine nel design visivo — prendendo come riferimento un layout esistente, si sostituiscono tramite prompt i testi e gli elementi grafici, producendo una nuova versione del progetto da sottoporre a revisione.
Flussi di compositing che richiedono materiali con sfondo trasparente — abilitando l'output con sfondo trasparente a 1K, il risultato viene sovrapposto direttamente ad altri livelli o scene, eliminando la fase di scontorno manuale.

Limiti e consigli per la scelta

Questa linea produce solo immagini e non riguarda altre modalità come video o testo. Risoluzione e formato sono vincolati tra loro: i rapporti automatici o particolari supportano solo 1K, il formato 1:1 non supporta il 4K e lo sfondo trasparente è disponibile solo a 1K, per cui tra specifiche elevate e controllo dello sfondo occorre operare scelte sui parametri. L'alta risoluzione e i riferimenti multipli aumentano i tempi di generazione e i costi di chiamata, rendendola inadatta a scenari interattivi in tempo reale con requisiti di latenza molto bassi; se serve solo generare da testo senza materiali di riferimento, conviene scegliere la linea di text-to-image della stessa famiglia.

Novità

Vedi il changelog →

Modifica dei parametri gpt-image-2 aggiunge le risoluzioni 1K / 2K / 4K Apr 30, 2026

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

POST https://api.hiapi.ai/v1/tasks

Header

AuthorizationstringObbligatorio

Chiave API dell'account. Obbligatoria in ogni richiesta. Esempio: Bearer YOUR_HIAPI_API_KEY. Ottieni una chiave API

Content-TypestringOpzionale

Il 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-KeystringOpzionale

Chiave 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.

Chiave di idempotenza

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

modelstringObbligatorio

Valore fisso attuale: gpt-image-2/image-to-image

routestringOpzionale

Valore fisso attuale: default

inputobjectObbligatorio

Oggetto di parametri di business per gpt-image-2/image-to-image e la route default — vedi la tabella dei parametri sotto.

promptstringObbligatoriominLength 1maxLength 20000

Prompt di testo, obbligatorio, lunghezza massima 20000 caratteri, utilizzato per descrivere il contenuto dell'immagine che si desidera generare.

backgroundstringOpzionale

Modalità sfondo, controlla il modo in cui viene gestito lo sfondo dell'immagine generata; questo parametro è supportato solo con risoluzione 1K.

Opzioni:autoopaquetransparent

input_urlsarrayObbligatoriominItems 1maxItems 16

Array di URL di immagini di riferimento, fornisce una o più immagini come riferimento per la generazione img2img; supporta da 1 a 16 immagini.

Array [ string ]

resolutionstringOpzionalePredefinito: "1K"

Risoluzione dell'immagine generata, predefinita 1K. Quando aspect_ratio è auto è necessario utilizzare 1K; 1:1 non supporta 4K; quando aspect_ratio è 3:1/1:3/9:21 è supportato solo 1K; quando background è auto/opaque/transparent è supportato solo 1K.

Opzioni:1K2K4K

aspect_ratiostringOpzionalePredefinito: "auto"

Rapporto larghezza-altezza dell'immagine generata, predefinito auto. Quando il valore è auto o omesso, è supportata solo la risoluzione 1K.

Opzioni:auto1:13:22:34:33:45:44:5

Mostra tutto (8)

16:99:162:11:23:11:321:99:21

callbackobjectOpzionale

Configurazione di notifica dello stato terminale. Se omessa, nessun callback: interroga l'attività per conto tuo.

Callback (Webhook)

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.

urlstringObbligatorio

Obbligatoria 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.

Opzioni:final

storagestringOpzionalePredefinito: "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.

Opzioni:temppersistent

Esempi 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/image-to-image",
  "input": {
    "prompt": "…",
    "input_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/image-to-image",
    input: {
      "prompt": "…",
      "input_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/image-to-image",
        "input": {
          "prompt": "…",
          "input_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"
}

# 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/image-to-image@ext",
  "input": {
    "prompt": "…",
    "quality": "low",
    "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/image-to-image@ext",
    input: {
      "prompt": "…",
      "quality": "low",
      "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/image-to-image@ext",
        "input": {
          "prompt": "…",
          "quality": "low",
          "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à

GET https://api.hiapi.ai/v1/tasks/:id

Campi della risposta

taskIdstringObbligatorio

ID attività, sempre con prefisso tk-hiapi-.

modelstringObbligatorio

Nome 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.

routestringOpzionale

Presente solo se è stato usato il parametro route esplicito; restituisce il valore inviato.

statusstringObbligatorio

Stato dell'attività.

Valori di stato

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.

creatednumberObbligatorio

Istante di creazione dell'attività (secondi Unix).

completednumberObbligatorio

Secondi 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

urlstringObbligatorio

URL dell'artefatto, scaricabile direttamente.

typestringObbligatorio

Valori attualmente possibili: video, image, audio, first_frame, last_frame, thumbnail; potrebbero essere ampliati in futuro.

expireAtnumberObbligatorio

Secondi Unix di disponibilità dell'artefatto; scarica o trasferisci prima della scadenza.

errorobjectOpzionale

Presente solo con status == fail.

codestringObbligatorio

Codice errore di business.

messagestringObbligatorio

Descrizione 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"
    }
  }
}