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

Autorisations

string
requis
Toutes les API nécessitent une authentification à l’aide d’un Bearer TokenObtenir la clé API :Rendez-vous sur la page de gestion des clés API pour obtenir votre clé APIÀ ajouter dans l’en-tête de la requête :

Body

string
défaut:"gemini-3-pro-image-preview"
requis
Nom du modèle de génération d’imagesModèles pris en charge :
  • gemini-3-pro-image-preview — Version standard (alias compatible nano-banana-pro-ext)
  • gemini-3-pro-image-preview-official — Version officielle (alias compatible nano-banana-pro)
Exemple : "gemini-3-pro-image-preview" ou "gemini-3-pro-image-preview-official"
Pour assurer la compatibilité avec les anciens appels, les alias nano-banana-pro-ext (correspondant à gemini-3-pro-image-preview) et nano-banana-pro (correspondant à gemini-3-pro-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
Taille de l’image généréeFormats pris en charge :
  • Ratios : auto, 1:1, 2:3, 3:2, 3:4, 4:3, 4:5, 5:4, 9:16, 16:9, 21:9
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.
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
string
Résolution de l’image de sortieValeurs prises en charge :
  • 1K — Résolution 1K (par défaut)
  • 2K — Résolution 2K
  • 4K — Résolution 4K
⚠️ Note : La génération d’images 4K au format base64 nécessite un temps de traitement plus long
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-pro-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-image ou l’édition d’images💡 Saisie rapide (zone « Try it ») :
  1. Cliquez sur « + Add an item » pour ajouter une URL d’image
  2. Saisissez l’URL complète de l’image ou les données base64
Limite : Maximum 14 images

Response

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