88API88API
User GuideAI ApplicationsAPI ReferenceHelp & Support
Image

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 :

UsageMéthodePoint de terminaison
Texte vers imagePOST/v1/images/generations
Édition d’imagePOST/v1/images/edits

Modèles et capacités

ModèleRésolutionImages de référenceImages par requêteFacturation
gpt-image-21K (par défaut) / 2K / 4K
size en pixels
jusqu’à 4 (fichier local)toujours 1par image
gpt-image-2.5-flare1K (par défaut) / 2K / 4K
size en pixels
jusqu’à 10 (fichier local)toujours 1par image
gpt-image-2.5-sunburst1K (par défaut) / 2K / 4K
size en pixels
jusqu’à 10 (fichier local)toujours 1par image
az-gpt-image-21K (par défaut) / 2K / 4K
size en pixels
jusqu’à 10 (fichier local / data URI / URL publique)jusqu’à 10par token
az-gpt-image-2.5-flare1K (par défaut) / 2K / 4K
size en pixels
jusqu’à 10 (fichier local / data URI / URL publique)jusqu’à 10par token
az-gpt-image-2.5-sunburst1K (par défaut) / 2K / 4K
size en pixels
jusqu’à 10 (fichier local / data URI / URL publique)jusqu’à 10par 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èlequalitybackgroundoutput_formatresponse_format
gpt-image-2low / medium / highNon pris en chargeNon pris en chargeb64_json / url
gpt-image-2.5-flarelow / medium / highNon pris en chargeNon pris en chargeb64_json / url
gpt-image-2.5-sunburstlow / medium / highNon pris en chargeNon pris en chargeb64_json / url
az-gpt-image-2low / medium / high / autotransparent / opaque / autopng / webp / jpegb64_json / url
az-gpt-image-2.5-flarelow / medium / high / xhigh / max / autotransparent / opaque / autopng / webp / jpegb64_json / url
az-gpt-image-2.5-sunburstlow / medium / high / xhigh / max / autotransparent / opaque / autopng / webp / jpegb64_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 charge size et quality, 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 transparent background, le format de sortie output_format, plusieurs images par requête avec n (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/json

Tailles

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 :

Format1K2K4K
1:11024x10242048x20482880x2880
3:21536x10242400x16003504x2336
2:31024x15361600x24002336x3504
4:31152x8642048x15363264x2448
3:4864x11521536x20482448x3264
16:91280x7202560x14403840x2160
9:16720x12801440x25602160x3840
21:91344x5763024x12963840x1648
2:11408x7042880x14403840x1920
1:2704x14081440x28801920x3840

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ètreTypeObligatoireDescription
modelstringOuiNom du modèle d’image, par exemple gpt-image-2.
promptstringOuiDescription du contenu de l’image. Précisez le sujet, la composition, le style, l’éclairage et le format.
sizestringNonTaille en pixels ; voir les règles dans la section « Tailles » ci-dessus.
qualitystringNongpt-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.
nintegerNonNombre 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_formatstringNonb64_json (par défaut) ou url. Avec url, un lien d’image 88API est renvoyé.
backgroundstringNonaz-gpt-image-* uniquement : transparent, opaque, auto.
output_formatstringNonaz-gpt-image-* uniquement : png (par défaut), webp, jpeg.
output_compressionintegerNonaz-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"
  }'
  • jpeg ne prend pas en charge la transparence ; combiné à transparent, il renvoie une image opaque.
  • En édition, transparent permet de supprimer l’arrière-plan ; si l’image de référence est déjà transparente, la sortie conserve la transparence.
  • opaque ne 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 que az-gpt-image-2 (le niveau high de 2.5 correspond à peu près au medium de 2).
  • Les requêtes en échec ne sont pas facturées.

Limitations importantes

  • N’envoyez pas les requêtes de ces modèles à /v1/responses ni à /v1/chat/completions.
  • La retouche locale par mask n’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_fidelity n’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 max de az-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érifiez size selon les règles de la section « Tailles » ci-dessus.
  • Si vous obtenez This model does not support image generation. ou image_model_wrong_endpoint, la requête a été envoyée à la mauvaise interface.