API des modèles d’image OpenAI
Points de terminaison, tailles, niveaux de qualité, images de référence et arrière-plans transparents pour les familles de modèles d’image gpt-image-2, gpt-image-2.5 et az-gpt-image.
Champ d’application
Cette page présente les interfaces d’image des modèles d’image OpenAI (gpt-image-* et az-gpt-image-*). Pour les modèles d’image Gemini, consultez API des modèles d’image Gemini ; pour les modèles d’image Grok, consultez API des modèles d’image Grok.
Documentation officielle
Choix de l’interface
Les modèles d’image OpenAI utilisent uniquement les interfaces d’image. N’utilisez pas /v1/chat/completions ni /v1/responses à leur place :
| Usage | Méthode | Point de terminaison |
|---|---|---|
| Texte vers image | POST | /v1/images/generations |
| Édition d’image | POST | /v1/images/edits |
Modèles et capacités
| Modèle | Résolution | Images de référence | Images par requête | Facturation |
|---|---|---|---|---|
gpt-image-2 | 1K (par défaut) / 2K / 4Ksize en pixels | jusqu’à 4 (fichier local) | toujours 1 | par image |
gpt-image-2.5-flare | 1K (par défaut) / 2K / 4Ksize en pixels | jusqu’à 10 (fichier local) | toujours 1 | par image |
gpt-image-2.5-sunburst | 1K (par défaut) / 2K / 4Ksize en pixels | jusqu’à 10 (fichier local) | toujours 1 | par image |
az-gpt-image-2 | 1K (par défaut) / 2K / 4Ksize en pixels | jusqu’à 10 (fichier local / data URI / URL publique) | jusqu’à 10 | par token |
az-gpt-image-2.5-flare | 1K (par défaut) / 2K / 4Ksize en pixels | jusqu’à 10 (fichier local / data URI / URL publique) | jusqu’à 10 | par token |
az-gpt-image-2.5-sunburst | 1K (par défaut) / 2K / 4Ksize en pixels | jusqu’à 10 (fichier local / data URI / URL publique) | jusqu’à 10 | par token |
Formats pris en charge : 1:1 (par défaut) / 3:2 / 2:3 / 4:3 / 3:4 / 16:9 / 9:16 / 21:9 / 2:1 / 1:2
| Modèle | quality | background | output_format | response_format |
|---|---|---|---|---|
gpt-image-2 | low / medium / high | Non pris en charge | Non pris en charge | b64_json / url |
gpt-image-2.5-flare | low / medium / high | Non pris en charge | Non pris en charge | b64_json / url |
gpt-image-2.5-sunburst | low / medium / high | Non pris en charge | Non pris en charge | b64_json / url |
az-gpt-image-2 | low / medium / high / auto | transparent / opaque / auto | png / webp / jpeg | b64_json / url |
az-gpt-image-2.5-flare | low / medium / high / xhigh / max / auto | transparent / opaque / auto | png / webp / jpeg | b64_json / url |
az-gpt-image-2.5-sunburst | low / medium / high / xhigh / max / auto | transparent / opaque / auto | png / webp / jpeg | b64_json / url |
Les deux groupes de modèles s’appellent de la même façon ; ils diffèrent par les paramètres disponibles et par le mode de facturation :
gpt-image-2,gpt-image-2.5-flare,gpt-image-2.5-sunburst: facturés à l’image, au même prix quels que soient la taille et le niveau de qualité. Ils prennent en chargesizeetquality, et renvoient 1 image par requête.az-gpt-image-2,az-gpt-image-2.5-flare,az-gpt-image-2.5-sunburst: prennent en charge l’ensemble des paramètres OpenAI Images, notamment l’arrière-plan transparentbackground, le format de sortieoutput_format, plusieurs images par requête avecn(jusqu’à 10), l’aperçu en streaming et les requêtes d’édition au format JSON. Facturés au token, le coût varie selon la taille et le niveau de qualité.
Les modèles réellement disponibles sont ceux de la liste de modèles renvoyée par la console.
Authentification
Toutes les requêtes doivent inclure votre jeton d’accès 88API :
Authorization: Bearer $API_KEY
Content-Type: application/jsonTailles
size doit être indiqué en pixels sous la forme LARGEURxHAUTEUR ; les chaînes comme 1K, 2K ou 4K ne sont pas acceptées. Une taille valide doit respecter toutes les conditions suivantes :
- la largeur et la hauteur sont des multiples de 16 ;
- le côté le plus long ne dépasse pas 3840 ;
- le rapport entre le grand côté et le petit côté ne dépasse pas 3:1 ;
- le nombre total de pixels est compris entre 655 360 (environ 816×816) et 8 294 400 (3840×2160).
Le tableau ci-dessous indique les tailles recommandées pour chaque niveau. Elles sont valables pour tous les modèles :
| Format | 1K | 2K | 4K |
|---|---|---|---|
| 1:1 | 1024x1024 | 2048x2048 | 2880x2880 |
| 3:2 | 1536x1024 | 2400x1600 | 3504x2336 |
| 2:3 | 1024x1536 | 1600x2400 | 2336x3504 |
| 4:3 | 1152x864 | 2048x1536 | 3264x2448 |
| 3:4 | 864x1152 | 1536x2048 | 2448x3264 |
| 16:9 | 1280x720 | 2560x1440 | 3840x2160 |
| 9:16 | 720x1280 | 1440x2560 | 2160x3840 |
| 21:9 | 1344x576 | 3024x1296 | 3840x1648 |
| 2:1 | 1408x704 | 2880x1440 | 3840x1920 |
| 1:2 | 704x1408 | 1440x2880 | 1920x3840 |
Si vous ne transmettez pas size ou si vous indiquez auto, le modèle choisit lui-même la taille. Les tailles qui ne respectent pas les règles ci-dessus peuvent être refusées ou ajustées automatiquement ; vérifiez-les avant d’envoyer la requête.
Texte vers image
Requête
curl https://api.88api.ai/v1/images/generations \
-H "Authorization: Bearer $API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "gpt-image-2",
"prompt": "Un chat roux assis près d’une fenêtre, lumière naturelle d’après-midi, style photographie réaliste",
"size": "2048x2048",
"quality": "medium"
}'Paramètres de la requête
| Paramètre | Type | Obligatoire | Description |
|---|---|---|---|
model | string | Oui | Nom du modèle d’image, par exemple gpt-image-2. |
prompt | string | Oui | Description du contenu de l’image. Précisez le sujet, la composition, le style, l’éclairage et le format. |
size | string | Non | Taille en pixels ; voir les règles dans la section « Tailles » ci-dessus. |
quality | string | Non | gpt-image-* prend en charge low, medium, high. az-gpt-image-2 prend en charge low, medium, high, auto ; az-gpt-image-2.5-* accepte en plus xhigh et max. Par défaut, la génération se fait en low. |
n | integer | Non | Nombre d’images. az-gpt-image-* accepte de 1 à 10 ; gpt-image-* renvoie 1 image par requête, envoyez plusieurs requêtes si vous en voulez davantage. |
response_format | string | Non | b64_json (par défaut) ou url. Avec url, un lien d’image 88API est renvoyé. |
background | string | Non | az-gpt-image-* uniquement : transparent, opaque, auto. |
output_format | string | Non | az-gpt-image-* uniquement : png (par défaut), webp, jpeg. |
output_compression | integer | Non | az-gpt-image-* uniquement, de 0 à 100 ; ne s’applique qu’à jpeg et webp. |
Exemple de réponse
{
"created": 1760000000,
"data": [
{
"b64_json": "iVBORw0KGgo..."
}
]
}Par défaut, la réponse contient data[].b64_json ; si vous indiquez "response_format": "url" dans la requête, elle contient data[].url.
Édition d’image
L’édition d’image utilise /v1/images/edits. Pour envoyer des images locales, utilisez multipart/form-data et répétez image[] pour chaque image de référence. Jusqu’à 10 images sont acceptées (4 au maximum pour gpt-image-2), aux formats PNG, JPEG et WebP.
curl https://api.88api.ai/v1/images/edits \
-H "Authorization: Bearer $API_KEY" \
-F "model=gpt-image-2" \
-F "image[]=@person.png" \
-F "image[]=@product.png" \
-F "prompt=Faire tenir à la personne de la première image le produit de la deuxième image, en conservant l’apparence de la personne et du produit" \
-F "size=1536x1024"Les images de référence sont numérotées dans l’ordre d’envoi ; dans le prompt, vous pouvez y faire référence par « la première image », « la deuxième image », etc.
Requête d’édition JSON (az-gpt-image-* uniquement)
az-gpt-image-* accepte aussi les requêtes d’édition au format JSON ; les images de référence peuvent être des Data URI ou des URL publiques :
curl https://api.88api.ai/v1/images/edits \
-H "Authorization: Bearer $API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "az-gpt-image-2.5-flare",
"prompt": "Remplacer l’arrière-plan par un studio photo bleu clair",
"images": [
{ "image_url": "data:image/png;base64,..." },
{ "image_url": "https://example.com/reference.png" }
],
"size": "1024x1024"
}'Pour gpt-image-*, utilisez l’envoi multipart.
Arrière-plan transparent (az-gpt-image-* uniquement)
Pour des autocollants, des icônes ou des détourages qui nécessitent un fond transparent, définissez background sur transparent et utilisez une sortie png ou webp :
curl https://api.88api.ai/v1/images/generations \
-H "Authorization: Bearer $API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "az-gpt-image-2",
"prompt": "Un autocollant de panda tenant une pancarte « Courage ! », contour net",
"size": "1024x1024",
"background": "transparent",
"output_format": "png"
}'jpegne prend pas en charge la transparence ; combiné àtransparent, il renvoie une image opaque.- En édition,
transparentpermet de supprimer l’arrière-plan ; si l’image de référence est déjà transparente, la sortie conserve la transparence. opaquene garantit pas totalement un résultat opaque : si le prompt demande explicitement un « autocollant » ou « sans arrière-plan », une image transparente peut tout de même être renvoyée.
Aperçu en streaming (az-gpt-image-* uniquement)
Définissez "stream": true et "partial_images" entre 1 et 3 : l’interface renvoie alors en SSE des aperçus intermédiaires image_generation.partial_image, et le dernier événement, image_generation.completed, contient l’image finale et l’utilisation. Pour les requêtes d’édition, les événements s’appellent image_edit.*.
Facturation
gpt-image-*est facturé au nombre d’images renvoyées avec succès, quels que soient la taille et le niveau de qualité.az-gpt-image-*est facturé au token : l’entrée texte, l’entrée image (images de référence) et la sortie image sont tarifées séparément. Les tokens de sortie dépendent uniquement de la taille et du niveau de qualité, et un niveau plus élevé coûte plus cher. À niveau de même nom,az-gpt-image-2.5-*consomme moins de tokens queaz-gpt-image-2(le niveauhighde 2.5 correspond à peu près aumediumde 2).- Les requêtes en échec ne sont pas facturées.
Limitations importantes
- N’envoyez pas les requêtes de ces modèles à
/v1/responsesni à/v1/chat/completions. - La retouche locale par
maskn’est pas prise en charge : un masque transmis ne limite pas la modification à cette zone. Pour modifier une partie de l’image, décrivez l’emplacement dans le prompt. - Le paramètre
input_fidelityn’est pas pris en charge. - Les images de référence GIF sont déconseillées ; convertissez-les d’abord en PNG.
- Les niveaux de qualité élevés et les tailles 4K peuvent prendre 1 à 2 minutes, et le niveau
maxdeaz-gpt-image-2.5-*jusqu’à environ 2 min 30. Réglez le délai d’expiration de votre client sur au moins 5 minutes. - Si vous obtenez
Invalid size ..., vérifiezsizeselon les règles de la section « Tailles » ci-dessus. - Si vous obtenez
This model does not support image generation.ouimage_model_wrong_endpoint, la requête a été envoyée à la mauvaise interface.
Recherche web DeepSeek
Faites rechercher des informations en temps réel sur le web par DeepSeek V4.1 Flash, avec les sources citées, grâce à l'outil web_search de l'API Responses.
API des modèles d’image Gemini
Formats de requête de Gemini 3.1 Flash Image, Nano Banana 2.1 et Gemini 3 Pro Image via le protocole compatible OpenAI et le protocole natif Gemini, avec les formats d’image, résolutions et images de référence.