Skip to main content
POST
Alias de modèle compatible : cette API prend également en charge l’alias nano-banana-2-ext, équivalent à gemini-3.1-flash-image-preview ; les deux sont interchangeables et produisent des résultats identiques.

Autorisations

string
requis
Tous les points de terminaison de l’API nécessitent une authentification Bearer TokenObtenir votre clé API :Rendez-vous sur la page de gestion des clés API pour obtenir votre clé APIAjoutez-la à l’en-tête de la requête :

Body

string
défaut:"gemini-3.1-flash-image-preview"
requis
Nom du modèle de génération d’imagesModèles pris en charge :
  • gemini-3.1-flash-image-preview — Version standard (alias compatible nano-banana-2-ext)
  • gemini-3.1-flash-image-preview-official — Version officielle (alias compatible nano-banana-2)
Exemple : "gemini-3.1-flash-image-preview" ou "gemini-3.1-flash-image-preview-official"
Pour assurer la compatibilité avec les anciens appels, les alias nano-banana-2-ext (correspondant à gemini-3.1-flash-image-preview) et nano-banana-2 (correspondant à gemini-3.1-flash-image-preview-official) restent utilisables normalement.
boolean
défaut:"false"
Indique s’il faut modérer le contenu avant d’envoyer la tâche d’image.
  • true : vérifier les prompts et les images d’entrée avec omni-moderation-latest
  • false ou omis : ne pas envoyer de requête de modération, sans coût ni latence de modération supplémentaires (par défaut)
string
requis
Description textuelle pour la génération d’images
string
Ratio d’aspect de l’imageRatios pris en charge :
  • auto — Choix automatique du ratio d’aspect
  • 1:1 — Carré, avatars, réseaux sociaux
  • 3:2 / 2:3 — Photos standard
  • 4:3 / 3:4 — Ratio d’affichage traditionnel
  • 16:9 / 9:16 — Écran large / couvertures vidéo verticales
  • 5:4 / 4:5 — Images Instagram
  • 21:9 — Bannière ultra-large
  • 1:4 / 4:1 — Long poster / bannière
  • 1:8 / 8:1 — Images extrêmement longues / publicités bannière
Pour la génération texte-vers-image, lorsque size vaut auto, la valeur par défaut est 1:1 ou 16:9 ; pour la génération image-vers-image, le ratio d’aspect suit la réponse de la source en amont. Nous vous recommandons de spécifier explicitement un ratio d’aspect.
string
défaut:"1K"
Résolution de l’image de sortieValeurs prises en charge :
  • 0.5K — ~512px, aperçu basse résolution
  • 1K — ~1024px, résolution standard (par défaut)
  • 2K — ~2048px, haute résolution
  • 4K — ~4096px, résolution ultra-haute
Note : Les différentes résolutions ont des tarifs différents. La 4K coûte plus cher que la 1K.
integer
Nombre d’images à générerPlage : 1Par défaut : 1⚠️ Note : Doit être un nombre brut (par exemple 1), sans guillemets, sinon une erreur sera renvoyée
boolean
défaut:"false"
Utiliser ou non le canal officiel en repli
  • false : Ne pas utiliser (par défaut)
  • true : Utiliser le canal officiel
Lors de l’utilisation du canal officiel (gemini-3.1-flash-image-preview-official), ce paramètre ne peut pas être utilisé.
array
Liste des URL d’images de référence pour la génération image-vers-imageDeux formats sont pris en charge :1. URL d’image complète
  • URL d’image accessible publiquement (http:// ou https://)
  • Exemple : https://example.com/image.jpg
2. Format encodé en Base64
  • Le format Data URI complet doit être utilisé
  • Format : data:image/{format};base64,{base64data}
  • Formats d’image pris en charge : jpeg, png, webp
  • Exemple : data:image/jpeg;base64,/9j/4AAQSkZJRgABAQEAYABg...
  • ⚠️ Note : Le préfixe data:image/jpeg;base64, doit être inclus
Limitations :
  • Maximum 14 images de référence (recommandé : jusqu’à 10 références d’objets + 4 références de personnages)
  • Taille d’une image : ne dépassant pas 10 Mo
  • Formats pris en charge : jpeg, png, webp
Activer l’amélioration via la recherche textuelle Google
  • true : Le modèle recherchera des informations textuelles sur le Web pour aider à la génération d’images, adapté aux scénarios nécessitant des informations réelles
  • false : Désactivé (par défaut)
Activer l’amélioration via la recherche d’images Google
  • true : En plus de la recherche textuelle, des images de référence seront également recherchées pour aider à la génération, adapté aux scénarios nécessitant des références visuelles
  • false : Désactivé (par défaut)
Note : Doit être utilisé conjointement avec google_search: true

Response

integer
Code de statut de la réponse
array
Tableau de données de réponse