Google vient de lancer **Nano Banana Pro**, le nom de code officiel de **Gemini 3 Pro Image**, un modèle multimodal de pointe qui excelle dans la génération de texte en image, l'édition d'images et le contrôle avancé de la composition. Les développeurs accèdent désormais à cet outil puissant de manière programmatique via l'API Gemini. De petits détails de configuration déterminent souvent si votre intégration réussit ou échoue rapidement.
bouton
Ce guide vous accompagne à chaque étape pour accéder et utiliser efficacement l'API Nano Banana Pro.
Qu'est-ce que Nano Banana Pro et pourquoi utiliser son API ?
Google DeepMind a construit Nano Banana Pro sur la base de Gemini 3 Pro. Il fournit des sorties d'image de qualité studio que les modèles précédents ne pouvaient pas égaler. Premièrement, il rend le texte à l'intérieur des images avec une précision exceptionnelle — pensez aux logos lisibles, aux panneaux multilingues ou à la calligraphie stylisée qui s'aligne parfaitement avec la scène. Ensuite, il prend en charge jusqu'à 14 images d'entrée pour le mélange tout en maintenant la cohérence sur jusqu'à cinq sujets. De plus, les développeurs contrôlent les angles de caméra, l'éclairage, la profondeur de champ, l'étalonnage des couleurs et même la résolution jusqu'à 4K.
De plus, le modèle base les générations sur des données Google Search en temps réel lorsque vous activez cette fonctionnalité. Cela garantit l'exactitude factuelle pour les diagrammes, les infographies ou les maquettes de produits. Chaque sortie est marquée d'un filigrane SynthID pour le suivi de la provenance.
Vous accédez à Nano Banana Pro via l'API Gemini standard, mais vous sélectionnez l'identifiant de modèle spécifique (gemini-3-pro-image-preview ou son successeur stable). Cette approche maintient votre code compatible avec d'autres variantes de Gemini tout en débloquant des capacités d'image de niveau professionnel.
Étape par étape : Obtenez votre clé API Gemini
Suivez ces étapes pour obtenir vos identifiants :
Allez sur Google AI Studio et connectez-vous avec votre compte Google.
Cliquez sur le bouton "Obtenir une clé API" dans la barre latérale gauche.
Créez une nouvelle clé ou utilisez-en une existante.
Alternativement, dans Vertex AI :
- Ouvrez le tableau de bord Vertex AI Studio.
- Sélectionnez "IA Générative" → "Model Garden".
- Recherchez Nano Banana Pro (listé comme Gemini 3 Pro Image).
- Cliquez sur "Activer l'API" et générez les identifiants.
Stockez la clé en toute sécurité dans des variables d'environnement. Ne la codez jamais en dur dans les fichiers source.
Appeler l'API Nano Banana Pro depuis Google AI Studio (Démarrage rapide)
Vous commencez souvent dans Google AI Studio pour une expérimentation rapide. D'abord, visitez ai.studio/banana-pro. Sélectionnez "Nano Banana Pro" dans le menu déroulant des modèles.
Ensuite, passez à l'onglet "API" pour afficher les exemples curl automatiquement remplis avec votre clé.
Voici une requête curl de base :
curl https://generativelanguage.googleapis.com/v1beta/models/gemini-3-pro-image-preview:generateContent \
-H 'Content-Type: application/json' \
-H "x-goog-api-key: YOUR_API_KEY" \
-d '{
"contents": [{
"role": "user",
"parts": [{
"text": "Generate a 4K photorealistic image of a yellow banana floating in space with Earth in the background, add text overlay: \"Nano Banana Pro\""
}]
}],
"generationConfig": {
"responseModal": "IMAGE"
}
}'
Ce point de terminaison reste le même que pour les autres modèles Gemini — seul le nom du modèle change.
Utiliser le SDK Python officiel pour Nano Banana Pro
La plupart des développeurs préfèrent la bibliothèque client Python car elle gère automatiquement les tentatives, le streaming et les types MIME. Installez-la d'abord :
pip install -U google-generativeai
Configurez la bibliothèque et générez une image :
import google.generativeai as genai
genai.configure(api_key="YOUR_API_KEY")
model = genai.GenerativeModel('models/gemini-3-pro-image-preview')
response = model.generate_content(
"A futuristic cityscape at golden hour with flying cars and the text 'Welcome to 2042' on a billboard, 4K resolution",
generation_config=genai.types.GenerationConfig(
response_mime_type="image/png"
)
)
response.candidates[0].content.parts[0].inline_data.data # base64 image
Enregistrez la sortie comme ceci :
with open("output.png", "wb") as f:
f.write(response.candidates[0].content.parts[0].inline_data.data)
Le SDK abstrait les détails de bas niveau, vous permettant ainsi de vous concentrer sur l'ingénierie des invites.
Gérer l'édition d'images et les entrées multi-images
Nano Banana Pro excelle dans les tâches d'édition. Téléchargez des images dans le cadre de l'invite. Par exemple :
import PIL.Image
img = PIL.Image.open("reference.jpg")
response = model.generate_content(
[img, "Edit this photo: change daytime to dramatic sunset, add bokeh effect, keep the subject unchanged"]
)
Vous combinez plusieurs images et du texte de manière transparente. Le modèle maintient la cohérence du sujet à travers les références.
Fonctionnalités avancées : Ancrage, paramètres de sécurité et contrôles
Activez l'ancrage à Google Search pour injecter des faits en temps réel :
"systemInstruction": {
"parts": [{"text": "Use search grounding for factual elements"}]
}
Ajustez les paramètres de sécurité pour bloquer ou autoriser des catégories :
model = genai.GenerativeModel(
'models/gemini-3-pro-image-preview',
safety_settings=[
{"category": "HARM_CATEGORY_DANGEROUS_CONTENT", "threshold": "BLOCK_NONE"}
]
)
Spécifiez le rapport d'aspect et la qualité :
generation_config=genai.types.GenerationConfig(
candidate_count=1,
temperature=0.7,
extra_params={
"aspect_ratio": "16:9",
"quality": "highest"
}
)
Tester et déboguer les appels API Nano Banana Pro avec Apidog
Les commandes curl manuelles fonctionnent pour des tests ponctuels, mais Apidog transforme votre flux de travail. Importez la spécification OpenAPI officielle de Gemini dans Apidog, et il génère automatiquement tous les points de terminaison, y compris les variantes de Nano Banana Pro.
Voici comment vous en bénéficiez :
- Visualisez les schémas JSON pour les requêtes generateContent.
- Enregistrez les environnements (clés dev/staging/prod).
- Enchaînez les requêtes et vérifiez les réponses.
- Simulez l'API localement pour développer hors ligne.
- Générez du code client dans plus de 20 langages instantanément.
Par exemple, créez une nouvelle requête dans Apidog, collez le point de terminaison Gemini, ajoutez votre clé API en tant qu'en-tête, et envoyez des charges utiles multi-parties complexes avec des images téléchargées en quelques secondes. Apidog valide les champs requis avant même que vous n'appuyiez sur "Envoyer", évitant ainsi les erreurs 400 courantes.
De nombreuses équipes signalent des cycles d'itération 50 à 70 % plus rapides après être passées à Apidog pour les tests d'API Gemini.
Déployer Nano Banana Pro sur Vertex AI pour la production
Les utilisateurs d'entreprise évoluent avec Vertex AI. Créez un point de terminaison personnalisé :
- Allez dans Vertex AI → Model Garden.
- Déployez "Gemini 3 Pro Image (Nano Banana Pro)".
- Configurez le type de machine et l'autoscaling.
- Appelez le point de terminaison de prédiction avec le SDK Vertex.
Ce chemin offre des points de terminaison privés, la journalisation et l'intégration de la surveillance avec Cloud Operations.
Tarification, limites de débit et bonnes pratiques
Nano Banana Pro coûte plus cher que les modèles plus légers en raison de ses exigences de calcul plus élevées. Vérifiez les derniers tarifs sur la page de tarification de l'API Gemini car ils peuvent être ajustés pendant la prévisualisation.
Mettez en œuvre une temporisation exponentielle pour les nouvelles tentatives. Mettez en cache les invites courantes lorsque cela est possible. De plus, ne regroupez les requêtes non liées que si votre cas d'utilisation le permet — la génération d'images ne prend pas encore en charge le véritable traitement par lots.
Incluez toujours des invites claires et structurées. Référez-vous au guide officiel des invites pour Nano Banana Pro afin de maximiser la qualité.
Dépannage des problèmes courants
Vous rencontrerez des erreurs "modèle introuvable" si vous utilisez le mauvais identifiant. Confirmez que vous ciblez gemini-3-pro-image-preview pendant la phase de prévisualisation payante.
Pour les échecs d'authentification, régénérez votre clé et vérifiez qu'il n'y a pas d'espaces de fin. Si les images apparaissent filigranées de manière inattendue, rappelez-vous que seuls certains niveaux suppriment l'effet visible.
Lorsque les sorties semblent censurées, ajustez explicitement les seuils de sécurité.
Conclusion
Vous possédez maintenant toutes les connaissances pour accéder et intégrer efficacement l'API Nano Banana Pro. Commencez avec Google AI Studio pour des résultats instantanés, passez au SDK Python pour le scripting, et tirez parti d'Apidog pour rationaliser les tests et le débogage.
La combinaison des capacités de Gemini 3 Pro Image sous la bannière Nano Banana Pro ouvre de nouvelles possibilités pour la conception automatisée, les supports marketing personnalisés et les outils de visualisation de données. Mettez en œuvre ces étapes, expérimentez audacieusement et regardez vos applications produire des visuels qui rivalisent avec les studios professionnels.
Téléchargez Apidog dès aujourd'hui et accélérez votre développement Nano Banana Pro — la différence de productivité deviendra évidente après votre première session.
bouton