Pour les développeurs
Serveur MCP Nano Banana Pro
Confiez à votre assistant IA la création d’images et de vidéos. Ajoutez une adresse de serveur à un client compatible avec le Model Context Protocol, connectez-vous à votre compte dans le navigateur, puis décrivez votre besoin avec vos propres mots.
Fonctionnement
Ajouter l’adresse du serveur
Collez l’adresse ci-dessous dans votre client, au moyen de sa commande, de son fichier de configuration ou de son champ de connecteur personnalisé.
Adresse du serveur MCP
https://preview.bananapro.site/api/mcpSe connecter et autoriser l’accès
Le client ouvre une fenêtre de navigateur. Connectez-vous à votre compte Nano Banana Pro et cliquez sur Autoriser. Aucune clé d’API n’est à saisir.
Décrire votre besoin
Demandez une image ou une vidéo dans la conversation. L’assistant choisit un outil, lance la tâche et renvoie les liens du résultat.
Configuration selon le client
Choisissez votre client. Les noms des menus peuvent différer légèrement d’une version à l’autre.
Claude Code
- 1Exécutez la commande ci-dessous dans un terminal pour ajouter le serveur.
- 2Dans Claude Code, ouvrez /mcp, sélectionnez nanobanana et terminez la connexion dans le navigateur.
claude mcp add --transport http nanobanana https://preview.bananapro.site/api/mcpCodex
- 1Exécutez la première commande dans un terminal pour ajouter le serveur.
- 2Exécutez la seconde commande. Une fenêtre de navigateur s’ouvre.
- 3Connectez-vous à votre compte et cliquez sur Autoriser.
codex mcp add nanobanana --url https://preview.bananapro.site/api/mcpcodex mcp login nanobananaCursor et clients JSON
- 1Ajoutez ce qui suit au fichier de configuration MCP du client, par exemple mcp.json dans Cursor.
- 2Redémarrez le client si nécessaire. À la première utilisation, une fenêtre de navigateur s’ouvre : connectez-vous et cliquez sur Autoriser.
{
"mcpServers": {
"nanobanana": {
"url": "https://preview.bananapro.site/api/mcp"
}
}
}Connecteur personnalisé
- 1Ouvrez les paramètres du client et repérez le champ prévu pour un connecteur personnalisé ou un serveur MCP distant.
- 2Collez l’adresse du serveur affichée ci-dessous, puis enregistrez.
- 3Choisissez Connecter, connectez-vous à votre compte et cliquez sur Autoriser.
https://preview.bananapro.site/api/mcpClé d’API
- 1N’utilisez cette méthode que pour les clients qui ne peuvent pas ouvrir de navigateur.
- 2Créez une clé sur la page des clés d’API. Transmettez-la dans l’en-tête du premier champ ou, dans une configuration JSON, ajoutez-la sous headers comme dans le second champ.
- 3Conservez la clé dans les paramètres d’identifiants du client et ne la communiquez à personne.
Authorization: Bearer YOUR_API_KEY{
"mcpServers": {
"nanobanana": {
"url": "https://preview.bananapro.site/api/mcp",
"headers": {
"Authorization": "Bearer YOUR_API_KEY"
}
}
}
}Ce que l'assistant peut faire
Le serveur expose six outils. Quatre se contentent de consulter des informations et sont gratuits ; deux lancent une génération et consomment des crédits.
| Outil | Fonction | Consomme des crédits |
|---|---|---|
| list_models | Liste les modèles d'image et de vidéo disponibles pour votre compte, ainsi que les types de requêtes acceptés par chacun. | Non |
| get_balance | Indique le nombre de crédits restants sur le compte. | Non |
| generate_image | Lance la génération ou la retouche d'une image à partir d'un prompt et, en option, d'images de référence. | Oui |
| generate_video | Lance la génération d'une vidéo à partir d'un prompt, d'images ou d'autres médias de référence. | Oui |
| get_task | Vérifie l'état d'une génération et renvoie les liens des résultats une fois celle-ci terminée. | Non |
| list_tasks | Liste les générations récentes, ce qui est utile si l'identifiant d'une tâche a été perdu. | Non |
Outil en ligne de commande
La commande nanobanana crée des images et des vidéos depuis un terminal, des scripts et des applications d’IA capables d’exécuter des commandes sur votre ordinateur.
Nécessite Node.js 22 ou une version ultérieure, sous macOS ou Linux.
Installer la CLI
Installez le paquet @nanobanana-pro/cli avec npm.
npm install -g @nanobanana-pro/cliSe connecter
Exécutez la commande, puis connectez-vous à votre compte dans la fenêtre du navigateur et cliquez sur Autoriser.
nanobanana auth loginVérifier le compte et les modèles
Cette commande affiche votre solde de crédits. La commande nanobanana models liste les modèles disponibles.
nanobanana accountCréer
Enregistrez dans request.json une requête contenant le modèle et le prompt, puis exécutez la commande. L’option --wait la maintient active jusqu’à la fin de la tâche.
nanobanana create --input request.json --waitTélécharger le résultat
Remplacez TASK_ID par l’identifiant de tâche renvoyé par la commande précédente.
nanobanana download TASK_ID --output result.png
Voir le résultat à l’œuvre
Demandez une image en une seule phrase. Votre application d’IA rédige la requête, crée l’image et enregistre le fichier.
$ nanobanana create --input request.json --wait
Task TASK_ID submitted; waiting for the result…
{ "status": "completed" }
$ nanobanana download TASK_ID --output result.png
{ "files": ["result.png"] }
Modèles
L’assistant peut utiliser les modèles d’image et de vidéo que votre compte peut employer sur le site et dans l’API.
- Demandez à l’assistant d’appeler list_models pour obtenir la liste actuelle des modèles et les types de requêtes acceptés par chacun.
- Chaque modèle offre les mêmes options que le site. Un réglage non pris en charge par un modèle est refusé avec une explication.
- Les images et vidéos de référence doivent être des liens https publics. Il n’est pas possible d’envoyer des fichiers via MCP.
Crédits et facturation
- La connexion et les outils gratuits (list_models, get_balance, get_task, list_tasks) ne coûtent rien.
- generate_image et generate_video consomment les mêmes crédits que le site et l’API, prélevés sur le solde de votre compte.
- Une tâche qui échoue est remboursée automatiquement.
- L’abonnement à l’assistant IA lui-même est distinct et facturé par cet assistant.
Exemples de demandes
Une fois connecté, envoyez l’une de ces demandes à votre assistant.
- Quels modèles d’image et de vidéo puis-je utiliser ? Présente-les sous forme de courte liste.
- Crée une photo produit en 16:9 d’une tasse en céramique posée sur une table en bois.
- Transforme cette photo de paysage en une vidéo de cinq secondes : https://example.com/photo.jpg
- Vérifie l’état de ma dernière tâche et envoie-moi le lien du résultat.
Questions fréquentes
Ai-je besoin d’une clé d’API ?
Pas avec les clients capables d’ouvrir un navigateur : il suffit de se connecter et de cliquer sur Autoriser. Une clé n’est requise que pour les clients qui ne le peuvent pas, comme indiqué sous Clé d’API.
Où voir ou supprimer une connexion ?
Ouvrez la page des clés d’API. Chaque connexion y figure sous le nom de son client ; la supprimer met fin à l’accès de ce client.
Combien coûte une génération ?
Les mêmes crédits que sur le site et dans l’API. Une tâche qui échoue est remboursée automatiquement.
Puis-je utiliser mes propres images ou vidéos comme références ?
Oui, sous forme de liens https publics. Il n’y a pas d’envoi de fichiers : placez le fichier à un endroit accessible et indiquez son adresse.
La connexion fonctionne, mais les outils n’apparaissent pas. Que faire ?
Vérifiez que la connexion a bien abouti et que le client affiche le serveur comme connecté. Ouvrez ensuite une nouvelle conversation, car certains clients ne chargent les outils qu’au début.
Où trouver les résultats ?
L’assistant renvoie les liens du résultat dans la conversation. Les tâches précédentes peuvent être listées de nouveau avec list_tasks.
Vous préférez appeler l'API vous-même ?
Le serveur MCP repose sur l'API publique. La documentation recense chaque point d'accès, chaque paramètre et chaque modèle.