88API88API
User GuideAI ApplicationsAPI ReferenceHelp & Support
Image

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.

Champ d’application

Cette page présente les modèles d’image Gemini. Pour les modèles d’image OpenAI, consultez API des modèles d’image OpenAI ; pour les modèles d’image Grok, consultez API des modèles d’image Grok.

Différence essentielle

Les modèles d’image Gemini ne sont pas des modèles de l’API OpenAI Images. Utilisez /v1/chat/completions ou le point de terminaison natif Gemini /v1beta/models/{model}:generateContent, et n’envoyez pas de requêtes à /v1/images/generations ni à /v1/images/edits.

Modèles et capacités

ModèleRésolutionImages de référenceImages par requêteFacturation
gemini-3.1-flash-image1K (par défaut) / 2K / 4K
image_config
jusqu’à 14 (data URI / URL publique)toujours 1par requête
gemini-nano-banana-2.11K (par défaut) / 2K / 4K
image_config
jusqu’à 6 (data URI / URL publique)toujours 1par requête
gemini-3-pro-image1K (par défaut) / 2K / 4K
image_config
jusqu’à 14 (data URI / URL publique)toujours 1par requête

Formats pris en charge : 1:1 / 2:3 / 3:2 / 3:4 / 4:3 / 4:5 / 5:4 / 9:16 / 16:9 / 21:9

  • Les trois modèles sont facturés à la requête, au même prix quels que soient la résolution et le nombre d’images de référence.
  • Chaque requête ne renvoie qu’une seule image ; n et candidateCount sont sans effet. Pour obtenir plusieurs images, envoyez plusieurs requêtes en parallèle.
  • Pour gemini-nano-banana-2.1, nous recommandons au maximum 6 images de référence par requête ; au-delà, les images supplémentaires risquent de ne pas être prises en compte.

Les modèles réellement disponibles sont ceux de la liste de modèles renvoyée par la console.

Protocoles pris en charge

ProtocolePoint de terminaisonCorps de la requêteCas d’usage
Compatible OpenAI (recommandé)POST /v1/chat/completionsmodel + messagesSDK OpenAI, clients unifiés et la plupart des applications
Natif GeminiPOST /v1beta/models/{model}:generateContentcontents + generationConfigUtilisation directe du SDK Gemini ou besoin des champs natifs

Authentification

Pour le protocole compatible OpenAI, utilisez :

Authorization: Bearer $API_KEY
Content-Type: application/json

Avec le protocole natif Gemini, vous pouvez aussi utiliser l’en-tête x-goog-api-key, comme le font habituellement les clients Gemini ; sa valeur reste votre jeton 88API. N’incluez jamais une vraie clé dans du code front-end, des journaux ou des exemples publics.

Format d’image et résolution

Le format d’image et la résolution se définissent via image_config :

  • aspect_ratio : voir le tableau des capacités ci-dessus.
  • image_size : 1K (par défaut), 2K ou 4K, avec un K majuscule.

Pixels de sortie pour chaque niveau :

Format1K2K4K
1:11024x10242048x20484096x4096
2:3848x12641696x25283392x5056
3:21264x8482528x16965056x3392
3:4896x12001792x24003584x4800
4:31200x8962400x17924800x3584
4:5928x11521856x23043712x4608
5:41152x9282304x18564608x3712
9:16768x13761536x27523072x5504
16:91376x7682752x15365504x3072
21:91584x6723168x13446336x2688
  • Sans format d’image indiqué, le modèle choisit le cadrage en fonction du prompt ; avec des images de référence, il reprend par défaut le format de la première image de référence. Si vous avez besoin d’une taille fixe, indiquez aspect_ratio explicitement.
  • La sortie peut être en JPEG ou en PNG. Enregistrez le fichier selon le type MIME renvoyé, sans présumer de l’extension.

Protocole compatible OpenAI (recommandé)

Texte vers image

curl https://api.88api.ai/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gemini-3-pro-image",
    "messages": [
      {
        "role": "user",
        "content": "Générer une image d’un chat roux assis près d’une fenêtre, lumière naturelle d’après-midi, style photographie réaliste"
      }
    ],
    "extra_body": {
      "google": {
        "image_config": {
          "aspect_ratio": "16:9",
          "image_size": "2K"
        }
      }
    }
  }'

Comment écrire image_config

Le format d’image et la résolution doivent figurer dans extra_body.google.image_config, avec les noms de champs en snake_case aspect_ratio et image_size. Les champs image_config, aspect_ratio ou size placés au niveau supérieur de la requête sont ignorés ; les écritures en camelCase comme imageConfig ou aspectRatio sont refusées.

Avec des images de référence

curl https://api.88api.ai/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gemini-3.1-flash-image",
    "messages": [
      {
        "role": "user",
        "content": [
          { "type": "text", "text": "En s’inspirant de la personne de la première image, créer une affiche de film avec cette même personne" },
          { "type": "image_url", "image_url": { "url": "data:image/png;base64,..." } }
        ]
      }
    ],
    "extra_body": {
      "google": { "image_config": { "aspect_ratio": "2:3", "image_size": "2K" } }
    }
  }'
  • image_url.url peut être une Data URI ou l’URL publique d’une image. Une Data URI doit comporter le préfixe complet du type de média, par exemple data:image/png;base64,....
  • Les formats PNG, JPEG, WebP et GIF sont pris en charge, mais pas BMP. Nous recommandons de ne pas dépasser 7 Mo par image.
  • Les images de référence sont prises dans l’ordre ; dans le prompt, vous pouvez y faire référence par « la première image », « la deuxième image », etc.

Champs de la requête

ChampTypeObligatoireDescription
modelstringOuiNom du modèle d’image Gemini.
messagesarrayOuiTableau de messages OpenAI Chat Completions, généralement un seul message user.
messages[].contentstring ou arrayOuiUne chaîne pour du texte seul ; un tableau de contenus pour combiner texte et images de référence.
content[].image_url.urlstringNonImage de référence, en Data URI ou URL publique.
extra_body.google.image_config.aspect_ratiostringNonFormat d’image.
extra_body.google.image_config.image_sizestringNon1K, 2K ou 4K.

Réponse

L’image est renvoyée sous forme d’image Markdown dans choices[0].message.content :

{
  "choices": [
    {
      "message": {
        "role": "assistant",
        "content": "![image](data:image/jpeg;base64,/9j/4AAQ...)"
      },
      "finish_reason": "stop"
    }
  ]
}

Extrayez la partie data:<mime>;base64,... de content pour obtenir l’image. N’analysez pas la réponse comme le tableau data de /v1/images/generations.

Protocole natif Gemini

Texte vers image

curl "https://api.88api.ai/v1beta/models/gemini-3-pro-image:generateContent" \
  -H "x-goog-api-key: $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "contents": [
      {
        "role": "user",
        "parts": [
          { "text": "Générer une image d’un chat roux assis près d’une fenêtre, lumière naturelle d’après-midi, style photographie réaliste" }
        ]
      }
    ],
    "generationConfig": {
      "responseModalities": ["TEXT", "IMAGE"],
      "imageConfig": { "aspectRatio": "16:9", "imageSize": "2K" }
    }
  }'

Images de référence

{
  "contents": [
    {
      "role": "user",
      "parts": [
        { "text": "En s’inspirant de cette image, créer une affiche de film avec la même personne" },
        { "inlineData": { "mimeType": "image/png", "data": "<BASE64_DATA>" } }
      ]
    }
  ],
  "generationConfig": {
    "imageConfig": { "aspectRatio": "2:3" }
  }
}

Les images publiques peuvent aussi être transmises avec fileData : { "fileData": { "mimeType": "image/jpeg", "fileUri": "https://..." } }.

Réponse

L’image se trouve dans candidates[0].content.parts[].inlineData : mimeType indique le type d’image et data contient les données en Base64.

Streaming et délais d’expiration

stream: true fonctionne, mais l’image est renvoyée en une seule fois dans un seul événement, sans aperçu progressif. Nous recommandons les requêtes sans streaming et un délai d’expiration client d’au moins 5 minutes : une image 4K prend généralement 30 à 60 secondes, et davantage aux heures de pointe.

À ne pas faire

# Erreur : n’utilisez pas le chemin de l’API OpenAI Images pour les modèles d’image Gemini
curl https://api.88api.ai/v1/images/generations \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gemini-3-pro-image",
    "prompt": "Un chat roux"
  }'

Ce type de requête renvoie 请使用 Gemini 原生接口调用 / please use the Gemini native API. Utilisez plutôt le format Chat Completions ou le format natif generateContent décrits sur cette page.

Erreurs courantes

ErreurCause
请使用 Gemini 原生接口调用 (veuillez utiliser l’API native Gemini)La requête a été envoyée à /v1/images/*.
extra_body.google.imageConfig is not supported, use extra_body.google.image_config insteadimage_config a été écrit en camelCase.
mime type is not supported by GeminiLe format de l’image de référence n’est pas pris en charge, par exemple BMP.
failed to download fileL’URL de l’image de référence n’a pas pu être téléchargée ; vérifiez que le lien est accessible publiquement.
Message d’échec de la modération du contenuLe prompt ou l’image de référence n’a pas passé le contrôle de sécurité, ou le modèle a répondu uniquement par du texte sans générer d’image. Modifiez le prompt puis réessayez.

Les requêtes en échec ci-dessus ne sont pas facturées.