Skip to main content
POST
Compatibilité des noms de modèle : gemini-3.1-flash-lite-image accepte l’alias nano-banana-2-lite, et gemini-3.1-flash-lite-image-ext accepte l’alias nano-banana-2-lite-ext ; chaque nom et son alias sont équivalents et interchangeables.

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-lite-image"
requis
Nom du modèle de génération d’imagesLes noms de modèle suivants sont pris en charge :
  • gemini-3.1-flash-lite-image (Nano Banana Lite, alias compatible nano-banana-2-lite)
  • gemini-3.1-flash-lite-image-ext (alias compatible nano-banana-2-lite-ext)
Les deux ont les mêmes paramètres et contraintes (uniquement 1K, google_search / official_fallback non pris en charge, jusqu’à 14 images de référence). Aucun des deux n’a de variante -official ni ne prend en charge le paramètre de repli official_fallback. La facturation dépend de la configuration back-office de chaque canal respectif.Les alias nano-banana-2-lite (correspondant à gemini-3.1-flash-lite-image) et nano-banana-2-lite-ext (correspondant à gemini-3.1-flash-lite-image-ext) sont équivalents à leurs noms d’origine respectifs et interchangeables.
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
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 :
  • 1K — ~1024px, résolution standard (Lite ne prend en charge que ce niveau)
Lite ne prend en charge que la 1K. Les valeurs 2K / 4K / 0.5K sont silencieusement rétrogradées en 1K, sans erreur et sans réellement produire une haute résolution. L’interface utilisateur front-end n’a pas besoin d’exposer d’option de résolution.
integer
défaut:"1"
Nombre d’images à générerPlage : 1 ~ 4, par défaut 1Lorsque n>1, le back-end envoie plusieurs requêtes simultanées à la source en amont et facture selon le nombre réel d’images générées avec succès. Il est recommandé que le front-end envoie toujours 1 (affichage de la progression image par image, facturation plus intuitive).⚠️ Note : Doit être un nombre brut (par exemple 1), sans guillemets, sinon une erreur sera renvoyée
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
string
Adresse de rappel de la tâche (base)En cas de succès / échec de la tâche, la plateforme appelle webhook + /callback (sans transmettre à la source en amont). Fournir ce paramètre réduit considérablement le polling ; il reste toutefois recommandé de conserver le polling comme solution de repli.
Points clés d’utilisation de Lite
  • Ne prend pas en charge google_search / google_image_search : Lite utilise le point de terminaison interactions de la Developer API, la source en amont n’a pas activé l’outil Search (renvoie “Search as tool is not enabled for this model”), et l’adaptateur de la plateforme ne transmet pas ce paramètre. Le fournir ne provoque pas d’erreur et l’image est générée normalement, mais sans aucun effet d’amélioration par la recherche. Pour une amélioration par la recherche, utilisez plutôt gemini-3.1-flash-image-preview.
  • Ne prend pas en charge la retouche locale via mask_url (la série Gemini utilise le ratio d’aspect + images de référence, et non les masques).
  • Facturation basée sur les tokens (à la différence du prix fixe par image de flash/pro) : entrée environ 0,25 /milliondetokens,sortiedimageenviron30/million de tokens, sortie d'image environ 30 /million de tokens, une image 1K ≈ 1120 tokens de sortie ≈ 0,0336 $/image. Le prix réel dépend de la configuration du multiplicateur dans le back-office.
  • Toutes les images générées contiennent le filigrane invisible SynthID de Google (comportement en amont, impossible à désactiver).

Response

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