Guida all'uso

Guida all'API GPT Image: ID modello, routing e migrazione

Una mappa valida nel tempo: dai vecchi nomi delle immagini OpenAI a GPT Image 2, con gli attuali ID modello HiAPI, le alternative Pro ritirate e quale pagina consultare per ogni prossimo passo.

Jun 24, 2026

Risposta breve

Per le nuove integrazioni dirette OpenAI di generazione immagini, l'ID modello attuale è gpt-image-2. Per le nuove integrazioni HiAPI, se l'attività parte da un prompt usa gpt-image-2/text-to-image; se parte da una o più immagini di riferimento usa gpt-image-2/image-to-image.

Questi nomi creano facilmente confusione, perché le persone usano "GPT-4o image", "ChatGPT image generation", "GPT Image API" e "GPT Image 2" per indicare interfacce di prodotto correlate ma diverse. L'approccio sicuro è stabilire prima quale API si intende chiamare, poi usare l'ID modello e il contratto di richiesta corrispondenti a quell'API.

Interfaccia	Modello o selettore attuale	Modalità di richiesta
OpenAI Image API	`gpt-image-2`	OpenAI `/v1/images/generations` o `/v1/images/edits`
OpenAI Responses API	Modelli principali supportati con lo strumento di generazione immagini	Lavoro conversazionale o multi-step sulle immagini tramite `/v1/responses`
HiAPI text-to-image	`gpt-image-2/text-to-image`	`POST https://api.hiapi.ai/v1/tasks`
HiAPI image-to-image	`gpt-image-2/image-to-image`	`POST https://api.hiapi.ai/v1/tasks`

HiAPI non fa da proxy al corpo delle richieste di OpenAI Image API. Espone le rotte di GPT Image tramite un contratto unificato di attività asincrone, quindi cambiare solo il nome host non basta per completare la migrazione.

La genealogia di GPT Image che gli sviluppatori devono conoscere

La genealogia utile è una mappa di migrazione operativa. Non tutti i nomi seguenti puntano a modelli API intercambiabili.

Nome che potresti trovare in vecchi codici o risultati di ricerca	Stato attuale	Cosa fare ora
"GPT-4o image generation" o "ChatGPT image generation"	Formulazione dell'interfaccia di prodotto o della UI, non un ID modello di immagini attuale da incollare in una nuova richiesta di immagini	Scegli prima un'interfaccia API, poi usa il suo modello e contratto di richiesta attuali
`chatgpt-4o-latest`	Alias del modello ChatGPT deprecato; la pagina dei modelli attuali di OpenAI elenca input di immagini, non output di immagini	Non usarlo come destinazione di migrazione per la generazione di immagini
`gpt-image-1`	OpenAI lo indica come modello di generazione immagini di generazione precedente e deprecato	Migra il nuovo lavoro sulle immagini a `gpt-image-2`
`gpt-image-1.5`	OpenAI lo indica come modello di generazione immagini di generazione precedente e deprecato	Migra il nuovo lavoro sulle immagini a `gpt-image-2`
`dall-e-2` o `dall-e-3`	Deprecati e rimossi dall'API OpenAI	OpenAI suggerisce `gpt-image-2` per la generazione e la modifica attuali
`gpt-image-2`	ID modello di immagini attuale per la connessione diretta OpenAI	Usalo con OpenAI Image API, oppure mappa l'attività sugli ID con slash di HiAPI indicati sotto

La documentazione attuale di OpenAI descrive gpt-image-2 come il suo modello di generazione immagini più avanzato e documenta la generazione text-to-image e la modifica delle immagini. La guida alla generazione di immagini di OpenAI distingue inoltre l'Image API one-shot dalla generazione conversazionale di immagini tramite Responses API. Le note sullo stato dei modelli sopra riportate provengono dalle seguenti pagine ufficiali: GPT Image 2, GPT Image 1.5, GPT Image 1, DALL-E 2, DALL-E 3 e ChatGPT-4o, verificate il 31 agosto 2026.

Passare dal flusso di lavoro della UI a quello dell'API

Le sessioni di immagini di ChatGPT nascondono dietro la conversazione la selezione del modello, lo stato, i tentativi e la gestione dei file. Un'integrazione API deve prendere queste decisioni in modo esplicito.

La guida ufficiale di OpenAI consiglia di usare la sua Image API per una singola generazione o modifica, e la Responses API per il lavoro conversazionale e multi-turno sulle immagini. HiAPI usa un terzo contratto: ogni attività sulle immagini è un'attività asincrona. Il tuo backend invia l'attività, memorizza il taskId restituito e riceve il risultato finale tramite callback o una successiva richiesta di dettaglio dell'attività.

Il brief creativo proveniente da una sessione UI resta un prompt di partenza utile, ma va inserito nello schema di richiesta reale dell'API e occorre testare l'output. Non copiare il nome del prodotto UI nel campo model dando per scontato che sia un ID API stabile.

Per HiAPI, mantieni la chiave API sul server e invia l'attività così:

curl -X POST "https://api.hiapi.ai/v1/tasks" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-image-2/text-to-image",
    "input": {
      "prompt": "A clean launch poster with the exact headline SUMMER DROP",
      "aspect_ratio": "4:5",
      "resolution": "1K"
    },
    "callback": {
      "url": "https://your-domain.com/hiapi/callback",
      "when": "final"
    }
  }'

L'oggetto callback deve trovarsi al livello superiore, accanto a model e input. Per il debug locale o la riconciliazione, esegui polling su GET https://api.hiapi.ai/v1/tasks/{taskId}. Dopo il successo dell'attività, scarica l'immagine da data.output[].url, senza trattare l'URL di output temporaneo come archivio permanente.

Questa pagina hub mostra di proposito una sola richiesta. Per i campi specifici delle rotte, le callback, il polling e gli esempi copiabili e incollabili, consulta la documentazione dell'API text-to-image o la documentazione dell'API image-to-image.

Migrare le vecchie chiamate OpenAI per le immagini a HiAPI

La migrazione del modello OpenAI e la migrazione del contratto del provider sono due modifiche distinte. Prima scegli l'attività sulle immagini attuale, poi riscrivi la richiesta per l'API delle attività di HiAPI.

Input precedente	Destinazione attuale con connessione diretta OpenAI	Destinazione attuale HiAPI
Text-to-image con `gpt-image-1`, `gpt-image-1.5` o ID DALL-E	Generazione con `gpt-image-2`	`gpt-image-2/text-to-image`
Modifica di immagini con `gpt-image-1` o `gpt-image-1.5`	Modifica con `gpt-image-2`	`gpt-image-2/image-to-image`
Flusso di lavoro sulle immagini solo UI di ChatGPT o GPT-4o	Scegli OpenAI Image API o Responses API in base al progetto di interazione	Scegli la rotta di attività HiAPI text-to-image o image-to-image

Quando migri a HiAPI, sostituisci la gestione sincrona o specifica di OpenAI con la persistenza del taskId, la gestione dello stato terminale e il download dell'output. Verifica di nuovo prompt e output senza promettere risultati identici a livello di pixel tra interfacce diverse.

Migrare i vecchi nomi dei modelli HiAPI

HiAPI ora usa ID con slash specifici per attività e selettori di rotta di livello superiore. Il nuovo codice deve usare la forma di richiesta canonica indicata sotto.

Vecchio nome HiAPI	Richiesta attuale
`gpt-image-2`	`model: "gpt-image-2/text-to-image"`
`gpt-image-2-image-to-image`	`model: "gpt-image-2/image-to-image"`
`gpt-image-2-beta`	`model: "gpt-image-2/text-to-image"` più `route: "beta"`
`gpt-image-2-ext`	`model: "gpt-image-2/text-to-image"` più `route: "ext"`
`gpt-image-2-i2i-ext`	`model: "gpt-image-2/image-to-image"` più `route: "ext"`

I dati di prezzo pubblici potrebbero riportare le voci con rotta come gpt-image-2/text-to-image@ext o gpt-image-2/image-to-image@ext. HiAPI accetta anche la forma qualificata dalla rotta, ma la documentazione dei modelli usa l'ID base con slash più il campo route di livello superiore, perché così è più facile vedere lo schema di input specifico della rotta.

Sostituire gli ID Pro HiAPI ritirati

HiAPI ha ritirato due vecchi ID Pro il 2 luglio 2026. Non compaiono più nei dati di prezzo pubblici attuali e non vanno mantenuti nei nuovi esempi.

ID ritirato	Alternativa
`gpt-image-2-pro`	`gpt-image-2/text-to-image`
`gpt-image-2-image-to-image-pro`	`gpt-image-2/image-to-image`

Questa migrazione dei modelli non garantisce che ogni parametro del vecchio Pro produca esattamente lo stesso effetto. Consulta lo schema di rotta attuale nella documentazione del modello corrispondente, poi esegui un test con un prompt e un'immagine di riferimento rappresentativi prima del passaggio in produzione.

Dove guardare dopo

Questa pagina serve per nomi, genealogia e migrazione. Scegli la destinazione in base alla domanda a cui vuoi rispondere:

Per iniziare e integrare

Pagina del modello GPT Image 2 per il modello attuale e il Playground.
Pagina del modello GPT Image 2 image-to-image per la modifica con immagini di riferimento nel Playground.
Documentazione GPT Image 2 text-to-image per i campi di richiesta standard, beta ed ext.
Documentazione GPT Image 2 image-to-image per i campi di modifica standard ed ext, incluse le differenze nella denominazione delle immagini di riferimento.
Prezzi dell'API GPT Image 2 per la tabella attuale delle rotte, i costi aggiuntivi delle immagini di riferimento e il calcolo del budget.
Prezzi HiAPI in tempo reale per il catalogo completo dei modelli attuali.

Casi d'uso e prove misurate

Confronti e scelta

Domande frequenti

Qual è l'ID modello attuale dell'API GPT Image?

Per la Image API con connessione diretta di OpenAI è gpt-image-2. Per HiAPI, usa gpt-image-2/text-to-image o gpt-image-2/image-to-image a seconda che l'attività parta da testo o da immagini di riferimento.

Posso inviare a HiAPI il nome del modello nudo `gpt-image-2`?

Non usare il nome nudo nel nuovo codice HiAPI. Gli ID canonici attuali sono i nomi con slash specifici per attività mostrati sopra, che rendono anche più chiari il prezzo, lo schema e il routing delle pagine del modello.

HiAPI usa l'endpoint `/v1/images/generations` di OpenAI?

No. I modelli di immagini di HiAPI usano POST /v1/tasks, poi ottengono il risultato tramite callback finale o GET /v1/tasks/{taskId}. I contratti di richiesta e risposta di OpenAI Image API e dell'API delle attività di HiAPI sono diversi.

Dove va inserita la callback?

Metti callback al livello superiore del corpo dell'attività, accanto a model e input. Usa callback.when: "final" e mantieni idempotente il servizio ricevente in base a taskId, perché sia il successo sia il fallimento sono risultati terminali.

Cosa sostituisce `gpt-image-2-pro`?

Usa gpt-image-2/text-to-image. Per l'ID Pro image-to-image ritirato, usa gpt-image-2/image-to-image. Prima di passare, consulta lo schema di input attuale e prova un'attività rappresentativa.

TagAPI per immagini Migrazione