Famille GPT Image
Les modèles de génération d’images d’OpenAI : gpt-image-2.5-flare, gpt-image-2.5-sunburst et gpt-image-2. Tous trois s’appellent via l’API compatible OpenAI.
Tout ce qui figure dans ces pages a été mesuré sur l’API en production, et chaque exemple de code a été exécuté tel quel. Dernière vérification : 2026-09-30.
Que souhaitez-vous faire ?
La structure de requête et les champs de réponse communs à ces endpoints sont décrits dans Images API.
Quel modèle utiliser
- Génération courante et par lots ; rapide
- 6 niveaux de qualité : de low à max
- Édition et combinaison d'images ; fidélité supérieure
- 6 niveaux de qualité : de low à max
- Convient aux projets existants
- 4 niveaux de qualité ; pas de xhigh ni de max
En passant de gpt-image-2 à 2.5, choisissez de nouveau le niveau de qualité ; voir Qualité et prix ci-dessous. Les deux fournisseurs prennent en charge le texte vers image et l’édition, et la passerelle achemine les requêtes automatiquement.
openai/gpt-image-2.5-flareGénération courante et par lots ; rapideopenai/gpt-image-2.5-sunburstÉdition et combinaison d'images ; fidélité supérieureopenai/gpt-image-2Pas de niveaux xhigh ni maxQualité (quality) et prix
quality est le paramètre qui influe le plus sur le prix. Les niveaux supérieurs coûtent plus cher et prennent plus de temps.
Prix de référence officiels d’OpenAI (par image, image de sortie uniquement ; consigne et images de référence non comprises) :
OpenAI n’a pas publié de grille de prix par image pour les deux modèles 2.5. Elle indique à la place des prix unitaires : $30 par million de tokens d’image en sortie, $8 par million de tokens d’image de référence en entrée et $5 par million de tokens de texte en entrée. Exemple de calcul d’OpenAI : une image 1024×1024 en low produit 196 tokens de sortie, soit environ $0.00588. Pour les autres niveaux et tailles, faites une estimation avec le calculateur officiel .
Ce sont les chiffres officiels d’OpenAI ; le montant réellement facturé correspond au champ usage de chaque réponse. Les prix en vigueur d’OfoxAI (remises comprises) figurent sur la page du modèle .
Niveaux pris en charge par chaque modèle :
standard et hd (anciennes valeurs de DALL·E) ne sont pas pris en charge et renvoient 400.
Latence et délais d’attente (timeout)
L’API est synchrone : la réponse n’est renvoyée qu’une fois l’image générée. Si le client se déconnecte avant, l’image est perdue mais la requête est tout de même facturée.
Réglez le délai d’attente du client sur 600 secondes. La latence varie selon le modèle, la qualité et la taille ; les requêtes de haute qualité, de grande taille et d’édition peuvent prendre plusieurs minutes, et les délais par défaut courants de 60 ou 120 secondes ne suffisent pas.
Taille (size)
size accepte une valeur LARGEURxHAUTEUR personnalisée, à condition que les quatre règles ci-dessous soient toutes respectées ; si l’une d’elles ne l’est pas, la requête renvoie 400.
- Largeur et hauteur divisibles par 16
- Aucun côté ne dépasse 3840
- Entre 1:3 et 3:1
- Au moins 655 360 pixels au total
Omis ou auto : le modèle choisit la taille. Rien ne garantit qu’elle soit de 1024×1024, ni qu’elle corresponde à votre image de référence. Lors de nos tests, le texte vers image comme l’édition ont renvoyé 1254×1254. Indiquez une taille explicitement si vous avez besoin d’une taille fixe.
Le maximum documenté est de 3840×2160 ; tout ce qui dépasse 2560×1440 est indiqué comme expérimental.
Caractéristiques techniques
Sélectionner un fournisseur
En général, ce n’est pas nécessaire. Sélectionnez-en un si vous avez des exigences en matière de modération du contenu : les fournisseurs appliquent des seuils de modération différents ; par exemple, gpt-image-2 est plus strict sur Azure et comparativement plus permissif sur OpenAI.
La passerelle choisit automatiquement un fournisseur disponible entre Azure et OpenAI.
Les requêtes sont envoyées uniquement à ce fournisseur ; s'il est indisponible, elles ne basculent pas vers un autre fournisseur.
X-OfoxAI-Provider-Type: openaiFonctionne pour le texte vers image comme pour l'édition ; valeurs : azure_foundry, openai"extra_body": { "provider": { "type": "openai" } }Texte vers image uniquement ; l'édition est un téléversement multipart et n'accepte que l'en-têteDétails complets : Routage des fournisseurs.
Erreurs courantes
Référence complète des erreurs : Gestion des erreurs.
Messages d’erreur exacts
Les messages complets que nous avons mesurés, pour que vous puissiez les rechercher ou les comparer :
Invalid size '1000x1000'. Width and height must both be divisible by 16.
Invalid size '4096x4096'. The longest edge must be less than or equal to 3840.
Invalid size '3200x1024'. The maximum supported aspect ratio is 3:1.
Invalid size '768x768'. Requested resolution is below the current minimum pixel budget.
The model 'gpt-image-2' does not support quality 'xhigh'.
Invalid value: 'standard'. Supported values are: 'low', 'medium', 'high', and 'auto'.
Invalid 'n': integer above maximum value. Expected a value <= 10, but got 11 instead.
Unknown parameter: 'style'.
The model 'gpt-image-2.5-sunburst' does not support the 'input_fidelity' parameter.
Transparent background is not supported for JPEG output format
Invalid file 'image[0]': unsupported mimetype ('text/plain; charset=utf-8'). Supported file formats are 'image/jpeg', 'image/png', and 'image/webp'.
unknown provider type in X-OfoxAI-Provider-Type header
Model 'GPT-Image-2' not found
Invalid image file or mode for image 1Notez que la liste des valeurs prises en charge dans Invalid value: 'standard' est incomplète : les modèles 2.5 acceptent également xhigh et max. Référez-vous au tableau des niveaux de cette page.
Paramètres sans effet
Ces paramètres ne provoquent pas d’erreur, mais n’ont aucun effet pour cette famille. La requête aboutit et est facturée normalement :
L’absence d’erreur ne signifie pas que le paramètre a fonctionné : style, par exemple, est rejeté d’emblée, tandis que ceux ci-dessus sont ignorés silencieusement.
Documentation officielle
La documentation d’OpenAI décrit le comportement lors d’un appel direct à OpenAI. Lorsque vous passez par OfoxAI, les résultats mesurés dans ces pages font foi. Par exemple, la facturation suit le champ usage de la réponse et les pages des modèles.
- Guide de génération d’images d’OpenAI
- Guide de génération d’images d’OpenAI · Limitations
- Référence de l’Images API d’OpenAI
- Page du modèle chez OpenAI : gpt-image-2.5-flare
- Page du modèle chez OpenAI : gpt-image-2.5-sunburst
- Page du modèle chez OpenAI : gpt-image-2
FAQ
GPT Image 2.5 accepte-t-il n'importe quelle taille ?
Il accepte des tailles personnalisées à condition que quatre règles soient respectées : largeur et hauteur divisibles par 16, côté le plus long de 3840 au maximum, rapport d'aspect entre 1:3 et 3:1, et au moins 655 360 pixels au total. Si l'une d'elles n'est pas respectée, la requête renvoie 400. Par exemple, 768x768 compte trop peu de pixels et est rejeté, tandis que 1024x768 fonctionne.
Quelle taille obtient-on si l'on omet size ?
Le modèle décide. Ce n'est pas forcément 1024x1024 et cela ne correspond pas forcément à l'image de référence. Lors de nos tests, le texte vers image comme l'édition ont renvoyé 1254x1254. Indiquez une taille explicitement si vous avez besoin d'une taille fixe.
gpt-image-2 prend-il en charge les qualités xhigh et max ?
Non, les deux renvoient 400. xhigh et max ne sont pris en charge que par gpt-image-2.5-flare et gpt-image-2.5-sunburst. gpt-image-2 accepte low, medium, high et auto.
La qualité de GPT Image 2.5 peut-elle être hd ou standard ?
Non, ces valeurs renvoient 400. Les valeurs valides sont low, medium, high, xhigh, max et auto. Si le paramètre est omis, le modèle choisit lui-même un niveau (low lors de nos tests) ; indiquez-le donc explicitement pour obtenir une qualité constante.
Quel délai d'attente faut-il régler pour l'API gpt-image-2 / GPT Image 2.5 ?
Réglez le délai d'attente du client sur 600 secondes. La latence varie selon le modèle, la qualité et la taille ; les requêtes de haute qualité, de grande taille et d'édition peuvent prendre plusieurs minutes.
Comment corriger l'erreur GPT Image moderation_blocked (Your request was rejected by the safety system) ?
La consigne ou l'image de référence a été bloquée par le système de sécurité du fournisseur en amont, généralement en raison de personnes réelles, de personnages protégés par le droit d'auteur ou de contenus sensibles. Modifiez la consigne ou l'image de référence puis réessayez ; réessayer sans changement donne le même résultat. Le champ error.moderation_details de la réponse indique si le blocage a eu lieu en entrée ou en sortie. Les fournisseurs appliquent des seuils de modération différents ; envisagez donc de sélectionner un fournisseur si vous avez des exigences de modération.
Comment corriger l'erreur GPT Image Unknown parameter: response_format ?
response_format est un ancien paramètre de DALL·E. GPT Image ne renvoie que du base64 (data[0].b64_json) et ne fournit pas d'URL d'image. Supprimez response_format et utilisez output_format pour choisir png, jpeg ou webp. Via OfoxAI, le paramètre est ignoré et ne provoque pas d'erreur.
Que faire face au message « Your organization must be verified » lors d'un appel à gpt-image ?
Il s'agit de la vérification d'organisation exigée par OpenAI pour un accès direct. Via OfoxAI, vous n'avez pas besoin de faire vérifier d'organisation : une clé d'API OfoxAI peut appeler gpt-image-2.5-flare, gpt-image-2.5-sunburst et gpt-image-2.
Que faire lorsque les requêtes GPT Image dépassent le délai d'attente ou renvoient 504 ou 524 ?
L'API est synchrone, et les requêtes de haute qualité, de grande taille et d'édition peuvent prendre plusieurs minutes. Réglez le délai d'attente du client sur 600 secondes et vérifiez les délais des proxys intermédiaires tels que Nginx, Vercel ou Cloudflare, dont les valeurs par défaut ne sont souvent que de 60 à 100 secondes.
Comment corriger l'erreur GPT Image does not support the input_fidelity parameter ?
GPT Image 2.5 et gpt-image-2 traitent toujours les images de référence en haute fidélité ; l'endpoint d'édition n'accepte donc pas input_fidelity. Supprimez-le ; ce paramètre ne s'applique qu'à gpt-image-1.5.
Comment corriger l'erreur GPT Image Invalid size ?
La taille enfreint l'une des quatre règles, et le message indique laquelle : divisible by 16 signifie que la largeur ou la hauteur n'est pas un multiple de 16 ; longest edge signifie que le côté le plus long dépasse 3840 ; aspect ratio signifie que le rapport dépasse 3:1 ; minimum pixel budget signifie moins de 655 360 pixels, p. ex. 768x768. Utilisez une taille qui respecte les quatre, comme 1024x768, 1024x1024 ou 1536x1024.
Combien coûte une image GPT Image ?
La facturation se fait au token, et le niveau de qualité est le facteur principal. Prix de référence officiels d'OpenAI pour une image 1024x1024 avec gpt-image-2 : environ $0.006 en low, $0.053 en medium et $0.211 en high. Pour les deux modèles 2.5, les tokens d'image en sortie coûtent $30 par million ; une image 1024x1024 en low revient donc à environ $0.006. Le montant réellement facturé correspond au usage de la réponse ; les prix en vigueur d'OfoxAI figurent sur les pages des modèles.
Faut-il épingler un fournisseur pour l'édition avec GPT Image 2.5 ?
Non. Azure comme OpenAI servent l'endpoint d'édition de 2.5, et la passerelle achemine les requêtes automatiquement.