Guide d'utilisation

Guide de l'API GPT Image : ID de modèle, routage et migration

Une carte durable : des anciens noms d'image OpenAI vers GPT Image 2, couvrant les ID de modèle HiAPI actuels, les remplacements Pro retirés, et vers quelle page se tourner pour chaque prochaine étape.

Jun 24, 2026

Réponse courte

Pour une nouvelle intégration d'image OpenAI en direct, l'ID de modèle actuel est gpt-image-2. Pour une nouvelle intégration HiAPI, si la tâche part d'un prompt, utilisez gpt-image-2/text-to-image ; si la tâche part d'une ou plusieurs images de référence, utilisez gpt-image-2/image-to-image.

Ces noms portent facilement à confusion, car on emploie « GPT-4o image », « ChatGPT image generation », « GPT Image API » et « GPT Image 2 » pour désigner des interfaces produit apparentées mais distinctes. La démarche sûre consiste à d'abord déterminer quelle API vous appelez, puis à utiliser l'ID de modèle et le contrat de requête correspondant à cette API.

Interface	Modèle ou sélecteur actuel	Mode de requête
OpenAI Image API	`gpt-image-2`	OpenAI `/v1/images/generations` ou `/v1/images/edits`
OpenAI Responses API	Modèle principal pris en charge avec l'outil de génération d'images	Travail d'image conversationnel ou multi-étapes via `/v1/responses`
HiAPI texte-vers-image	`gpt-image-2/text-to-image`	`POST https://api.hiapi.ai/v1/tasks`
HiAPI image-vers-image	`gpt-image-2/image-to-image`	`POST https://api.hiapi.ai/v1/tasks`

HiAPI ne relaie pas les corps de requête de l'OpenAI Image API. Il expose les routes GPT Image via un contrat de tâche asynchrone unifié, si bien que changer seulement le nom d'hôte ne suffit pas à effectuer la migration.

La lignée GPT Image que les développeurs doivent connaître

La généalogie utile est une carte de migration exploitable. Les noms ci-dessous ne pointent pas tous vers des modèles d'API interchangeables.

Nom que vous avez peut-être vu dans d'anciens codes ou résultats de recherche	Statut actuel	Que faire maintenant
« GPT-4o image generation » ou « ChatGPT image generation »	Formulation d'interface produit ou d'UI, pas un ID de modèle d'image actuel que l'on colle dans une nouvelle requête d'image	Choisissez d'abord une interface API, puis utilisez son modèle et son contrat de requête actuels
`chatgpt-4o-latest`	Alias de modèle ChatGPT obsolète ; la page actuelle des modèles OpenAI liste l'entrée d'image, pas la sortie d'image	Ne l'utilisez pas comme cible de migration pour la génération d'images
`gpt-image-1`	OpenAI le désigne comme un modèle de génération d'images de précédente génération, obsolète	Migrez le nouveau travail d'image vers `gpt-image-2`
`gpt-image-1.5`	OpenAI le désigne comme un modèle de génération d'images de précédente génération, obsolète	Migrez le nouveau travail d'image vers `gpt-image-2`
`dall-e-2` ou `dall-e-3`	Obsolètes et retirés de l'API OpenAI	OpenAI recommande `gpt-image-2` pour la génération et l'édition actuelles
`gpt-image-2`	ID de modèle d'image direct actuel d'OpenAI	À utiliser avec l'OpenAI Image API, ou à mapper vers les ID à barre oblique HiAPI ci-dessous

La documentation actuelle d'OpenAI décrit gpt-image-2 comme son modèle de génération d'images le plus avancé, et documente la génération texte-vers-image ainsi que l'édition d'images. Le guide de génération d'images d'OpenAI distingue également l'Image API à usage unique de la génération d'images conversationnelle via la Responses API. Les statuts de modèles ci-dessus proviennent des pages officielles suivantes : GPT Image 2, GPT Image 1.5, GPT Image 1, DALL-E 2, DALL-E 3 et ChatGPT-4o, vérifiées le 31 août 2026.

Passer d'un workflow UI à un workflow API

Une session d'image ChatGPT masque derrière la conversation la sélection du modèle, l'état, les nouvelles tentatives et la gestion des fichiers. Une intégration API doit prendre ces décisions explicitement.

Le guide officiel d'OpenAI recommande d'utiliser son Image API pour une génération ou une édition unique, et la Responses API pour un travail d'image conversationnel et multi-tours. HiAPI utilise un troisième contrat : chaque tâche d'image est une tâche asynchrone. Votre backend soumet la tâche, stocke le taskId renvoyé, et reçoit le résultat final via un callback ou une requête ultérieure de détail de tâche.

Un brief créatif issu d'une session UI reste un prompt de départ utile, mais il faut le transposer dans le schéma de requête réel de l'API et tester la sortie. Ne copiez pas le nom du produit UI dans le champ model en supposant qu'il s'agit d'un ID d'API stable.

Pour HiAPI, conservez la clé API sur le serveur et soumettez la tâche ainsi :

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'objet callback doit se trouver au niveau supérieur, aux côtés de model et input. Pour le débogage local ou la réconciliation, interrogez GET https://api.hiapi.ai/v1/tasks/{taskId}. Une fois la tâche réussie, téléchargez l'image depuis data.output[].url, et ne traitez pas l'URL de sortie temporaire comme un stockage permanent.

Cette page hub ne présente volontairement qu'une seule requête. Pour les champs propres au routage, les callbacks, l'interrogation et des exemples copiables-collables, consultez la documentation de l'API texte-vers-image ou la documentation de l'API image-vers-image.

Migrer d'anciens appels d'image OpenAI vers HiAPI

La migration de modèle OpenAI et la migration de contrat de fournisseur sont deux changements distincts. Choisissez d'abord la tâche d'image actuelle, puis réécrivez la requête pour l'API de tâches HiAPI.

Entrée héritée	Cible directe OpenAI actuelle	Cible HiAPI actuelle
Texte-vers-image avec `gpt-image-1`, `gpt-image-1.5` ou un ID DALL-E	Génération `gpt-image-2`	`gpt-image-2/text-to-image`
Édition d'image avec `gpt-image-1` ou `gpt-image-1.5`	Édition `gpt-image-2`	`gpt-image-2/image-to-image`
Workflow d'image ChatGPT ou GPT-4o uniquement via UI	Choisir l'OpenAI Image API ou la Responses API selon la conception de l'interaction	Choisir la route de tâche HiAPI texte-vers-image ou image-vers-image

Lors d'une migration vers HiAPI, remplacez la gestion de réponse synchrone ou propre à OpenAI par la persistance du taskId, le traitement des états terminaux et le téléchargement des sorties. Revalidez les prompts et les sorties, et ne promettez pas une identité pixel près des résultats entre interfaces.

Migrer d'anciens noms de modèle HiAPI

HiAPI utilise désormais des ID à barre oblique propres à chaque tâche et un sélecteur de route au niveau supérieur. Le nouveau code doit employer la forme de requête canonique ci-dessous.

Ancien nom HiAPI	Requête actuelle
`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"` plus `route: "beta"`
`gpt-image-2-ext`	`model: "gpt-image-2/text-to-image"` plus `route: "ext"`
`gpt-image-2-i2i-ext`	`model: "gpt-image-2/image-to-image"` plus `route: "ext"`

Les données tarifaires publiques peuvent écrire les entrées routées sous la forme gpt-image-2/text-to-image@ext ou gpt-image-2/image-to-image@ext. HiAPI accepte aussi la forme qualifiée par la route, mais la documentation des modèles utilise l'ID à barre oblique de base avec le champ route au niveau supérieur, car cela rend plus clair le schéma d'entrée propre à la route.

Remplacer les ID Pro HiAPI retirés

HiAPI a retiré deux anciens ID Pro le 2 juillet 2026. Ils n'apparaissent plus dans les données tarifaires publiques actuelles et ne doivent pas subsister dans les nouveaux exemples.

ID retiré	Remplacement
`gpt-image-2-pro`	`gpt-image-2/text-to-image`
`gpt-image-2-image-to-image-pro`	`gpt-image-2/image-to-image`

Cette migration de modèle ne garantit pas que chaque paramètre de l'ancien Pro produira exactement le même effet. Consultez le schéma de route actuel dans la documentation du modèle correspondant, puis exécutez un test représentatif avec un prompt et une image de référence avant de basculer en production.

Où aller ensuite

Cette page sert aux noms, à la généalogie et à la migration. Choisissez votre destination selon la question à laquelle vous voulez répondre :

Démarrage et intégration

Page du modèle GPT Image 2 pour le modèle actuel et le Playground.
Page du modèle GPT Image 2 image-vers-image pour l'édition avec image de référence dans le Playground.
Documentation texte-vers-image de GPT Image 2 pour les champs de requête standard, beta et ext.
Documentation image-vers-image de GPT Image 2 pour les champs d'édition standard et ext, y compris les différences de nommage des images de référence.
Tarification de l'API GPT Image 2 pour la table de routes actuelle, les suppléments liés aux images de référence et le calcul de budget.
Tarification en temps réel HiAPI pour le catalogue complet des modèles actuels.

Cas d'usage et preuves mesurées

Comparaisons et choix

Questions fréquentes

Quel est l'ID de modèle actuel de l'API GPT Image ?

Pour l'Image API directe d'OpenAI, c'est gpt-image-2. Pour HiAPI, utilisez gpt-image-2/text-to-image ou gpt-image-2/image-to-image selon que la tâche part de texte ou d'images de référence.

Puis-je envoyer le nom de modèle nu `gpt-image-2` à HiAPI ?

N'utilisez pas le nom nu dans le nouveau code HiAPI. Les ID canoniques actuels sont les noms à barre oblique propres à chaque tâche présentés ci-dessus, qui rendent aussi plus explicites la tarification, le schéma et le routage des pages de modèle.

HiAPI utilise-t-il le point de terminaison `/v1/images/generations` d'OpenAI ?

Non. Les modèles d'image HiAPI utilisent POST /v1/tasks, puis récupèrent le résultat via un callback final ou GET /v1/tasks/{taskId}. Les contrats de requête et de réponse de l'OpenAI Image API et de l'API de tâches HiAPI sont différents.

Où faut-il placer le callback ?

Placez callback au niveau supérieur du corps de la tâche, aux côtés de model et input. Utilisez callback.when: "final" et rendez le service récepteur idempotent par taskId, car les succès comme les échecs sont des résultats terminaux.

Qu'est-ce qui remplace `gpt-image-2-pro` ?

Utilisez gpt-image-2/text-to-image. Pour l'ancien ID Pro image-vers-image retiré, utilisez gpt-image-2/image-to-image. Consultez le schéma d'entrée actuel et testez une tâche représentative avant de basculer.

TagsAPI d'image Migration