Comment utiliser l'API Nano Banana Pro/Nano Banana 2 — Guide étape par étape pour les développeurs

Si vous avez recherché “ Nano Banana Pro API ”, la première source de confusion est le nom. Le nom du produit est Nano Banana Pro. Le nom de l'API que vous utilisez réellement dans le code est gemini-3-pro-image. Une fois que ce point est clair, le reste de la configuration est beaucoup moins mystérieux.

Utilisez Nano Banana Pro lorsque l'image doit former un tout cohérent : texte lisible, détails du produit, références à la marque, mises en page adaptées au marché local ou brief visuel comportant de nombreuses contraintes mineures. Si vous en êtes encore à tester dix versions d'une même idée, commencez d'abord par Nano Banana 2, puis passez à la version Pro lorsque la direction choisie mérite que l'on y consacre davantage de ressources.

Si votre équipe passe encore son temps à mettre au point des consignes plutôt qu'à lancer une application, L'espace de travail Nano Banana Pro de GlobalGPT C'est un outil pratique qui permet de comparer les résultats avant qu'un développeur ne se connecte à l'API officielle. Il s'agit d'un raccourci créatif dans le flux de travail, et non d'un substitut à la console API de Google, à la facturation, aux journaux ou aux contrôles d'entreprise.

Réponse rapide

Pour utiliser Nano Banana Pro via une API, créez un projet Google AI Studio ou Google Cloud, générez une clé API Gemini, installez le SDK Google Gen AI, puis appelez gemini-3-pro-image. Commencez par une requête « texte vers image » simple. Si vous vérifiez encore les droits d'accès avant de créer une API, le Guide pas à pas de la version d'essai gratuite de Gemini 3 Pro est un ouvrage complémentaire utile.

En quoi consiste réellement l'API Nano Banana Pro ?

Nano Banana Pro est le modèle haut de gamme de génération d'images natives de Google, issu de la famille de modèles Gemini. Dans la documentation destinée aux développeurs, Google le désigne sous le nom de Gemini 3 Pro Image. C'est pourquoi la référence du modèle diffère du nom commercial.

L'API est capable de générer une image à partir d'un texte, d'utiliser une ou plusieurs images de référence et de modifier une image existante selon des instructions écrites. Elle s'avère donc utile pour les maquettes de produits, les variantes publicitaires, les schémas, les créations localisées et les flux de travail liés aux images où le texte contenu dans l'image doit rester lisible ; pour l'exploration sans code, l' Générateur d'images GlobalGPT C'est l'endroit le plus simple pour tester d'abord l'orientation créative.

Nano Banana Pro vs Nano Banana 2

Le choix ne dépend pas tant du nom qui semble le plus récent que de l'étape à laquelle vous en êtes dans votre travail. « Pro » correspond à une passe minutieuse. « Nano Banana 2 » correspond à une boucle de brouillon désordonnée ; si c'est cette méthode plus rapide dont vous avez besoin, lisez le Guide d'essai gratuit Nano Banana 2 avant de concevoir l'ensemble du flux de travail autour de Pro.

Configurer l'API avec les points d'entrée réels

Pour un prototype, Google AI Studio est généralement la solution la plus rapide. Pour une application d'entreprise, utilisez l'infrastructure Google Cloud à laquelle votre équipe a déjà confiance, en particulier si vous avez besoin d'une facturation partagée, d'un contrôle d'accès, d'une journalisation ou d'une gouvernance Vertex AI. Si le choix de l'accès dépend essentiellement des niveaux de forfait Google, comparez les avantages et les inconvénients dans le Guide comparatif entre Google AI Plus et Pro avant de considérer la configuration de l'API comme le seul problème.

La documentation publique constitue le point de départ le plus clair. Elle vous permet de vérifier que vous vous trouvez bien sur la page de génération d'images Nano Banana, de vous assurer que la page utilise le chemin d'accès recommandé à l'API Interactions, et d'accéder directement à partir de là aux points d'entrée de la clé API ou d'AI Studio.

1. Créez ou ouvrez un projet Google AI Studio ou Google Cloud.
2. Créez une clé API Gemini.
3. Enregistrez la clé sous forme de variable d'environnement côté serveur.
4. Installez le SDK Google Gen AI dans votre projet backend.
5. Effectuez un test en basse résolution avant d'ajouter des images de référence ou des fonctionnalités destinées aux utilisateurs.

La page des clés API est également accessible au public, mais la création ou la consultation d'une clé dépend de votre compte Google et des autorisations attribuées à votre projet. Le point essentiel : veillez à ne pas inclure cette clé dans le code JavaScript du front-end. Un navigateur ou une application mobile doit interroger votre backend, et votre backend doit interroger Gemini.

Une fois connecté, l'URL directe d'AI Studio s'affiche bien dans Playground avec Nano Banane Pro choisi comme gemini-3-pro-image. Dans cet article, AI Studio a également mis en évidence une contrainte pratique : Nano Banana Pro nécessite un abonnement Google AI ou une clé API pour pouvoir être exécuté dans Playground.

Le Obtenir le code Il vaut tout de même la peine de vérifier ce bouton à ce stade. Cela confirme que vous êtes bien dans le flux de travail des développeurs, mais si le modèle est verrouillé pour le compte, le panneau de code peut s'ouvrir sans contenir d'extrait de code complet et exécutable. Il s'agit d'un indicateur de configuration, et non d'un bug de l'interface.

export GEMINI_API_KEY="VOTRE_CLÉ_API"

Générer une première image

La première requête doit être volontairement simple. Vous vérifiez l'authentification, l'accès au modèle, la structure de la réponse et la gestion des fichiers. Les modifications sophistiquées de l'interface de ligne de commande peuvent attendre que tout soit au point.

from google import genai
from google.genai import types
import os

client = genai.Client(api_key=os.environ["GEMINI_API_KEY"])

response = client.models.generate_content(
    model="gemini-3-pro-image",
    contents=(
 "Créez une maquette de produit soignée représentant un mug de voyage en acier inoxydable "
 "posé sur un bureau blanc. Ajoutez l'étiquette lisible : MORNING LAB."
    ),
    config=types.GenerateContentConfig(
 response_modalities=["TEXT", "IMAGE"]
    ),
)

for part in response.candidates[0].content.parts:
    if part.text:
 print(part.text)
    elif part.inline_data :
 with open("nano-banana-pro-output.png", "wb") as f :
 f.write(part.inline_data.data)

Cette consigne demande de créer une maquette de produit simple avec un texte lisible. Cela vous donne un aperçu rapide de trois éléments essentiels dans la pratique professionnelle : le réalisme de l'objet, la composition et la capacité du modèle à rendre un texte court de manière nette et lisible. Pour adapter la consigne sans modifier les paramètres, essayez le même brief dans L'espace de travail Nano Banana Pro de GlobalGPT d'abord.

Modifier des images avec des références

C'est dans l'édition par référence que Nano Banana Pro commence à faire ses preuves. Au lieu de demander au modèle de créer une nouvelle image à partir de zéro, vous lui fournissez une image et lui indiquez précisément ce qui peut être modifié et ce qui doit rester inchangé.

Si vous n'êtes pas développeur, considérez ce bloc comme un exemple de workflow plutôt que comme quelque chose que vous devez exécuter. Le nom du fichier product-reference.png signifie tout simplement “ l'image de votre produit actuel ”. Si votre tâche principale consiste à comparer des modèles d'images, le concept plus large Test des alternatives au Gemini 3 Pro peut vous aider à déterminer si la version Pro vaut la peine de passer par une configuration supplémentaire.

from google import genai
from google.genai import types
from PIL import Image
import os

client = genai.Client(api_key=os.environ["GEMINI_API_KEY"])
reference = Image.open("product-reference.png")

response = client.models.generate_content(
    model="gemini-3-pro-image",
    contents=[
 reference,
 (
 "Conservez la forme de la tasse, son anse et l'emplacement du logo. "
            "Remplacez l'arrière-plan par un plan de travail de cuisine clair, ajoutez une lumière chaude du matin, "
 "et veillez à ce que tout le texte reste net et lisible."
 ),
    ],
    config=types.GenerateContentConfig(response_modalities=["TEXT", "IMAGE"]),
)

Une bonne consigne d'édition s'apparente presque à un retour d'expérience destiné à un graphiste : “ gardez ceci, modifiez cela, ne déplacez pas le logo, veillez à ce que le texte reste lisible ”. Les consignes vagues telles que « donnez-lui un aspect haut de gamme » ont tendance à entraîner un gaspillage de tirages, car elles laissent trop de place à l'interprétation de la part du modéliste.

Tarification et maîtrise des coûts

Consultez la page des tarifs de Google comme référence officielle avant de publier des chiffres de budget fixes. Comme cela a été vérifié le 21 juillet 2026, Google répertorie l’offre « Nano Banana Pro » sous la rubrique « Gemini 3 Pro Image » et distingue les coûts liés au texte et à la réflexion de ceux liés à la production d’images.

Coûts liés à la génération d'images via l'API, vérifiés le 21 juillet 2026

Le modèle de coûts concret est simple : réaliser des ébauches à moindre coût, puis peaufiner avec soin. Confiez les premières itérations à Nano Banana 2, puis transmettez les consignes et les références les plus pertinentes à Nano Banana Pro pour les images finales. Limitez également la résolution en fonction du niveau d’abonnement de l’utilisateur et évitez les générations répétées lorsque la consigne n’a pas changé ; si vous souhaitez mettre en place une filière d’ébauche côté produit, Nano Banana 2 en GlobalGPT C'est l'option la plus légère, celle qu'il faut tester en premier.

Notes de production

Une fois que les utilisateurs peuvent générer des images à partir de votre produit, vous devez mettre en place des mesures de contrôle. Les API d'images peuvent rapidement devenir coûteuses, et les échecs doivent pouvoir être expliqués sans dévoiler les détails bruts du fournisseur. Les équipes qui sont encore en train de déterminer qui a besoin d'un accès payant à l'IA peuvent également comparer les workflows de type abonnement dans le ChatGPT Guide de rédaction d'un plan d'affaires.

• Conserver les clés côté serveur : Ne transmettez pas la clé API Gemini via un navigateur ou un client mobile.
• Enregistrer suffisamment d'informations pour permettre le débogage : ID du modèle, hachage de la prompt, taille de la sortie, latence, ID de l'utilisateur et statut du résultat.
• Définir des quotas : limiter le nombre d'images par utilisateur, par espace de travail et par période de facturation.
• Réessayez avec précaution : Réessayer en cas d'échecs temporaires, mais ne pas réessayer en boucle en cas d'erreurs liées à la politique ou au quota.
• Définir les règles de stockage : Sachez combien de temps vous conservez les images générées et les références téléchargées.
• Générer des messages d'erreur utiles : indiquer à l'utilisateur si le problème est lié à l'accès, au format de fichier, au quota ou à la politique d'invite.

Le rôle de GlobalGPT

GlobalGPT s'intègre parfaitement avant ou à côté de la compilation de l'API. Un concepteur peut comparer Nano Banana Pro avec Nano Banane 2, GPT Image, Flux et d'autres modèles d'images dans un seul espace de travail, puis transmettre au développeur le modèle de prompt le plus performant.

Pour les clés API officielles, la facturation, les journaux, l'accès entreprise ou le routage Vertex AI, restez sur la plateforme pour développeurs de Google. Pour comparer plus rapidement les créations et réduire le nombre d'onglets ouverts lors du développement de prompts, L'espace de travail du générateur d'images de GlobalGPT peut rendre les premières étapes moins laborieuses.

FAQ

L'API Nano Banana Pro est-elle identique à l'image Gemini 3 Pro ?

Pour le travail de développement, oui. Google désigne le Nano Banana Pro sous le nom de « Gemini 3 Pro Image », et l'identifiant du modèle dans l'API est gemini-3-pro-image.

Dois-je utiliser le Nano Banana Pro ou le Nano Banana 2 ?

Utilisez Nano Banana Pro pour les images finales qui nécessitent un contrôle plus rigoureux, un texte lisible, des références ou une cohérence de marque. Utilisez Nano Banana 2 pour des ébauches plus rapides et des itérations moins coûteuses.

Puis-je appeler Nano Banana Pro directement depuis le JavaScript du front-end ?

Non. Conservez la clé API côté serveur, acheminez les requêtes via votre backend et appliquez les quotas utilisateur avant d'envoyer les requêtes à l'API Gemini.

Est-ce que GlobalGPT remplace l'API officielle de Google ?

Le n° GlobalGPT est utile pour effectuer des tests rapides et comparer différentes créations, mais les clés API officielles, la facturation, les journaux et les contrôles d'entreprise relèvent de la plateforme pour développeurs de Google.

Comment puis-je estimer les coûts liés à l'API Nano Banana Pro ?

Utilisez la page actuelle de Google consacrée aux tarifs de l’API Gemini et effectuez une estimation en fonction du modèle, de la résolution de sortie et du volume d’images. Une stratégie courante de maîtrise des coûts consiste à réaliser d’abord les ébauches avec le modèle le moins cher, puis à utiliser Nano Banana Pro pour certains éléments finaux sélectionnés.