Famille Nano Banana

Les modèles d’images Gemini de Google, au nombre de cinq. Nous recommandons de les appeler via l’endpoint natif Gemini, qui permet de contrôler précisément le format et la résolution ; l’endpoint compatible OpenAI fonctionne aussi, mais ne prend en charge qu’une partie des paramètres.

Tâches courantes

Définir le format et la résolution Images en paysage, en portrait, grandes images 4K : valeurs prises en charge par chaque modèle.Édition et fusion multi-image Téléverser des images et les modifier selon une consigne textuelle.Diagnostic des erreurs 400 invalid argument, format incorrect, pas d'image renvoyée, 410.

Choix du modèle

L'essentielNano Banana 2 pour l’usage courant ; Pro pour une sortie 4K ou une composition complexe ; 2 Lite pour générer en masse de petites images.

Nano Banana 2.1Le plus récent

Trois niveaux : 1K, 2K, 4K
Formats de 1:8 à 8:1 ; environ 2 minutes mesurées en 2K et 4K

gemini-nano-banana-2.1

Nano Banana 2Premier choix au quotidien

Quatre niveaux de résolution, de 512 à 4K
Le plus de formats pris en charge, dont 1:8 et 8:1

gemini-3.1-flash-image

Nano Banana ProPriorité à la qualité

Trois niveaux : 1K, 2K, 4K
Raisonne avant de générer, donc plus lent

gemini-3-pro-image

Nano Banana 2 LitePriorité à la vitesse

1K uniquement
Environ 5 secondes par image mesurées, sortie JPEG

gemini-3.1-flash-lite-image

Nano BananaGénération précédente

Environ 1K fixe, résolution non configurable
Utilisable pour les projets existants

gemini-2.5-flash-image

ID de modèle (à copier tel quel)

Nano Banana 2.1google/gemini-nano-banana-2.1Le plus récent

Nano Banana 2google/gemini-3.1-flash-imagePremier choix au quotidien

Nano Banana Progoogle/gemini-3-pro-image4K, composition complexe

Nano Banana 2 Litegoogle/gemini-3.1-flash-lite-image1K uniquement

Nano Bananagoogle/gemini-2.5-flash-imageGénération précédente

Pour les prix en vigueur, consultez les pages des modèles : Nano Banana 2 , Nano Banana Pro . Le montant réellement débité correspond au champ usageMetadata de la réponse.

Choix de l’endpoint

L'essentielPour contrôler le format et la résolution, utilisez l’endpoint natif Gemini.

	Endpoint natif Gemini (recommandé)	Endpoint compatible OpenAI
Adresse	`POST /gemini/v1beta/models/<ID du modèle>:generateContent`	`POST /v1/images/generations`, `/v1/images/edits`
Format	`imageConfig.aspectRatio`	`aspect_ratio` au premier niveau
Résolution	`imageConfig.imageSize` : 512, 1K, 2K, 4K	Non prise en charge ; `image_size` renvoie 400
`size: "LARGEURxHAUTEUR"`	Sans objet	Non pris en charge ; utilisez `aspect_ratio` pour le format
Plusieurs images avec `n`	Sans objet	Non pris en charge ; une image par requête
Édition	`inlineData` dans `parts`	Fichier téléversé sur `/v1/images/edits`
Images de référence `input_images`	Sans objet	Non pris en charge ; pour éditer, utilisez `/v1/images/edits`
Réponse	`candidates[0].content.parts[].inlineData.data`	`data[0].b64_json`

Latence et délai d’attente

L'essentielRéglez le délai d’attente du client sur 300 secondes ou plus.

L’API est synchrone. Nous avons mesuré environ 5 à 20 secondes en 1K et environ 30 secondes en 4K ; environ 2 minutes en 2K et 4K pour Nano Banana 2.1. Aux heures de pointe, c’est plus long. Pro raisonne avant de générer l’image (la réponse contient thoughtsTokenCount) et met donc plus de temps que Nano Banana 2 à résolution égale. Le délai par défaut courant de 60 secondes ne couvre pas les requêtes 4K ni celles aux heures de pointe ; si le client se déconnecte, la requête est tout de même facturée.

Structure de la réponse

200 OK (endpoint natif, data tronqué)


{
  "candidates": [{
    "content": {
      "parts": [{ "inlineData": { "mimeType": "image/png", "data": "iVBORw0KGgo…" } }],
      "role": "model"
    },
    "finishReason": "STOP"
  }],
  "modelVersion": "google/gemini-3-pro-image",
  "usageMetadata": {
    "promptTokenCount": 7,
    "candidatesTokenCount": 2000,
    "candidatesTokensDetails": [{ "modality": "IMAGE", "tokenCount": 2000 }],
    "thoughtsTokenCount": 211,
    "totalTokenCount": 2218
  }
}

L’image se trouve dans l’élément de parts qui contient inlineData, pas forcément le premier : du texte peut le précéder. Parcourez parts pour la trouver.
Le nombre indiqué pour l’élément IMAGE de candidatesTokensDetails correspond aux tokens de l’image produite. Nous avons mesuré 1 120 en 1K et 2 000 en 4K avec Pro.
thoughtsTokenCount n’apparaît que dans les réponses de Pro et correspond aux tokens de raisonnement avant la génération de l’image.

Documentation officielle

La documentation officielle décrit le comportement en appel direct à Google ; via OfoxAI, les résultats mesurés sur cette page font foi.

FAQ

Comment générer une image 4K avec Nano Banana Pro ?

Utilisez l'endpoint natif Gemini en passant imageSize: "4K" dans generationConfig.imageConfig, et indiquez le format avec aspectRatio. Nous avons mesuré une sortie 4K en 16:9 de 5504x3072, environ 16 Mo, en 33 secondes environ. L'endpoint compatible OpenAI ne prend pas en charge imageSize, et image_size renvoie 400.

Quels formats Nano Banana 2 prend-il en charge ?

Dix formats courants : 1:1, 2:3, 3:2, 3:4, 4:3, 4:5, 5:4, 9:16, 16:9, 21:9 ; plus quatre formats très larges ou très hauts : 1:4, 4:1, 1:8, 8:1. Un format absent de cette liste renvoie 400 Request contains an invalid argument.

Nano Banana Pro prend-il en charge 1:8 ou 4:1 ?

Non. Les quatre formats 1:4, 4:1, 1:8 et 8:1 ne sont pris en charge que par Nano Banana 2.1, Nano Banana 2 et Nano Banana 2 Lite ; pour des images très hautes ou très larges, utilisez l'un de ces trois modèles.

Faut-il écrire 4K ou 4k dans imageSize ?

Nous recommandons les majuscules 1K, 2K, 4K, comme dans la documentation officielle de Google. D'après nos tests, OfoxAI accepte aussi les minuscules. Le niveau 512 s'écrit sans K et n'est pris en charge que par Nano Banana 2.

Comment définir le format de Nano Banana avec l'endpoint compatible OpenAI ?

Utilisez aspect_ratio au premier niveau, par exemple "16:9". Cet endpoint ne prend pas en charge de paramètre de résolution ; pour du 2K ou du 4K, utilisez imageConfig.imageSize sur l'endpoint natif Gemini.

Nano Banana peut-il générer plusieurs images à la fois ?

Non, une requête génère une seule image. Pour en obtenir plusieurs, envoyez plusieurs requêtes en parallèle, en tenant compte des limites de débit.

Quel délai d'attente régler pour Nano Banana ?

300 secondes ou plus. Nous avons mesuré environ 5 à 20 secondes en 1K, environ 30 secondes en 4K et environ 2 minutes en 2K et 4K pour Nano Banana 2.1 ; c'est plus long aux heures de pointe. Pro raisonne avant de générer et met plus de temps que Nano Banana 2.