Intégration n8n

Images et vidéo directement dans n8n Générer, attendre, télécharger, publier — dans un seul workflow

Connectez n8n à BananaBanana avec une seule clé API et appelez Nano Banana, Veo, Gemini Omni, Wan, Grok Imagine, GPT Image, Qwen et Gemini TTS depuis vos workflows. Deux approches : un AI Agent avec le nœud MCP Client Tool, ou de simples nœuds HTTP Request sans aucun modèle de langage.

Créer une clé APIImages dès $0.03, vidéo dès $0.06 — paiement par génération
01Ce que vous obtenez

Ce qu'un workflow peut faire et ce que cela coûte

Chaque génération est payée depuis votre solde BananaBanana, aux mêmes prix que sur le site. Il n'y a ni abonnement ni frais propres à n8n. Les appels coûteux (vidéo, plusieurs images à la fois) renvoient d'abord un devis et ne facturent rien tant que vous ne l'avez pas confirmé ; les générations échouées ou filtrées sont remboursées automatiquement.

AppelPrix
Image (generate_image, edit_image)$0.03–$0.20 par image
Clip vidéo (generate_video, edit_video)$0.06–$6.00 par clip
Voix (generate_speech)$0.01 par tranche de 200 caractères entamée
Statut, modèles, compte (get_result, list_models, get_account)gratuit

Le prix exact d'un modèle, d'une résolution et d'une durée figure dans list_models et sur la page des tarifs.

02Étape 1

Créer une clé API

  1. Inscrivez-vous et créditez votre solde.
  2. Ouvrez Profil → API Keys et créez une clé. Elle commence par bb_live_ et n'est affichée qu'une fois — copiez-la directement dans un identifiant (credential) n8n.
  3. Définissez sur la clé un plafond de dépenses quotidien adapté à votre workflow, par exemple le coût des exécutions que vous attendez par jour. Une boucle qui dérape s'arrête alors au plafond au lieu de vider le solde.
  4. Dans n8n, créez un identifiant Bearer Auth et collez la clé comme Bearer Token. Les deux méthodes ci-dessous utilisent cet identifiant unique.
03Méthode A

AI Agent + MCP Client Tool

Ajoutez un nœud AI Agent, associez-lui un modèle de chat et rattachez le nœud MCP Client Tool avec ces paramètres :

Node: MCP Client Tool  (connect it to the AI Agent "Tool" input)
Endpoint URL:      https://bananabanana.pro/api/mcp
Server Transport:  HTTP Streamable
Authentication:    Bearer Auth → your BananaBanana credential
Tools to Include:  Selected → list_models, get_account, generate_image, get_result

L'agent a besoin de son propre modèle de langage (OpenAI, Anthropic, Gemini ou tout modèle pris en charge par n8n) avec sa propre clé API : BananaBanana génère les médias, le modèle décide quels outils appeler.

Confirmation du prix

Les appels vidéo et multi-images répondent d'abord par status: confirmation_required avec quoted_cost_usd et ne facturent rien. L'argent n'est prélevé que lorsque le même appel revient avec confirm_cost égal au devis. Indiquez à l'agent dans son message système quoi faire : s'arrêter et annoncer le prix (comme ci-dessous), ou confirmer lui-même jusqu'à une limite que vous fixez.

Message système utilisé dans le workflow prêt à l'emploi

You create images with the BananaBanana tools. Call generate_image with the user's
request (model nano-banana-2-lite unless the user names another model; list_models
shows models and prices). generate_image returns a job_id: call get_result with that
job_id and wait_seconds 30 until status is completed. If a tool answers status
confirmation_required, tell the user the quoted price and stop: never pass
confirm_cost on your own. Finish with the first file URL from get_result on its own line.

La génération est asynchrone : generate_image renvoie un job_id, et get_result attend jusqu'à 30 secondes par appel que le fichier soit prêt. La réponse contient un lien de fichier signé, qu'un nœud HTTP Request placé après l'agent télécharge comme fichier.

Node: HTTP Request  (after the AI Agent)
Method:  GET
URL:     {{ $json.output.match(/https?:\/\/\S+?\/api\/files\/[^\s)"'\]]+/)[0] }}
Options → Response → Response Format: File
04Méthode B

Nœuds HTTP Request, sans modèle de langage

Le endpoint MCP est du JSON simple en POST : de simples nœuds HTTP Request peuvent donc l'appeler directement. C'est l'option la moins chère et la plus prévisible : pas de tokens de modèle et pas d'agent qui choisit les paramètres.

  1. Générer l'image — envoyez en POST un tools/call pour generate_image. Utilisez {{ $execution.id }} dans idempotency_key : si n8n relance le nœud, la même clé renvoie la tâche d'origine au lieu de facturer deux fois.
  2. Récupérer le résultat — envoyez en POST get_result avec le job_id et wait_seconds: 30. Un nœud If envoie status: processing vers un Wait de 5 secondes puis revient ; completed poursuit.
  3. Télécharger le fichier — GET sur files[0].url avec Response Format réglé sur File. Le binaire part vers Google Drive, S3, WordPress, YouTube, la publication sur les réseaux sociaux — tout nœud qui accepte un fichier.
Node: HTTP Request "Generate image"
Method:          POST
URL:             https://bananabanana.pro/api/mcp
Authentication:  Generic Credential Type → Bearer Auth
Send Headers:    Accept = application/json, text/event-stream
Send Body:       JSON →
{{ JSON.stringify({ jsonrpc: "2.0", id: 1, method: "tools/call", params: {
     name: "generate_image",
     arguments: { prompt: $json.prompt, model: "nano-banana-2-lite",
                  aspect_ratio: "1:1", idempotency_key: "n8n-" + $execution.id } } }) }}

→ {{ $json.result.structuredContent.job_id }}   (status: "processing")
Node: HTTP Request "Get result"   (same URL, credential and headers)
{{ JSON.stringify({ jsonrpc: "2.0", id: 1, method: "tools/call", params: {
     name: "get_result",
     arguments: { job_id: $('Generate image').item.json.result.structuredContent.job_id,
                  wait_seconds: 30 } } }) }}

If  {{ $json.result.structuredContent.status }} is "processing"  → Wait 5 s → Get result
If  … is "completed"  → HTTP Request GET {{ $json.result.structuredContent.files[0].url }}
                        Options → Response → Response Format: File

Vidéo : devis, vérification, confirmation

Pour generate_video, envoyez l'appel deux fois : la première réponse contient quoted_cost_usd ; un nœud If le compare à votre limite, et seulement ensuite le second appel le renvoie sous la forme confirm_cost. Une vidéo prend de une à dix minutes, conservez donc la boucle get_result.

1. generate_video  { prompt, model: "veo-3.1-fast", duration: 8, resolution: "720p" }
   ← { status: "confirmation_required", quoted_cost_usd: 0.70 }      nothing charged
2. If  {{ $json.result.structuredContent.quoted_cost_usd }}  ≤  your limit
3. generate_video  { …same arguments…, confirm_cost: {{ $json.result.structuredContent.quoted_cost_usd }},
                     idempotency_key: "n8n-" + $execution.id }
   ← { job_id, status: "processing", cost_charged_usd: 0.70 }
4. get_result loop as above (videos take 1–10 minutes)
05Workflows prêts à l'emploi

Importer un workflow en une minute

Les deux workflows ne contiennent ni clés ni identifiants. Dans n8n, choisissez Workflows → Import from File (ou collez le JSON dans l'éditeur), puis sélectionnez vos identifiants dans les nœuds marqués d'un avertissement.

  • AI Agent + MCP Client Tool : Manual Trigger → AI Agent (OpenAI Chat Model, BananaBanana MCP) → Télécharger le fichier. Sélectionnez votre identifiant OpenAI et l'identifiant Bearer Auth.

    Télécharger le JSON · bananabanana-n8n-agent.json
  • HTTP Request : Manual Trigger → paramètres de la requête → Générer l'image → Récupérer le résultat (avec boucle d'attente) → Télécharger le fichier, plus des arrêts d'erreur explicites. Sélectionnez l'identifiant Bearer Auth dans les trois nœuds de requête.

    Télécharger le JSON · bananabanana-n8n-http.json

Les deux workflows ont été importés et exécutés de bout en bout sur n8n 2.48.7 auto-hébergé ; l'image par défaut coûte $0.03 par exécution.

06Dépannage

Erreurs courantes et que faire

  • 401 — la clé est absente, mal saisie ou révoquée. L'identifiant doit contenir la clé elle-même ; n8n ajoute le mot Bearer.
  • INSUFFICIENT_BALANCE — le solde ne couvre pas l'appel. La réponse contient un lien de recharge ; rien n'a été facturé.
  • confirmation_required — ce n'est pas une erreur : l'appel nécessite confirm_cost (voir la méthode A et la recette vidéo).
  • RATE_LIMITED — plus de 20 appels d'outils par minute sur une même clé. Ajoutez un Wait ou activez Retry On Fail avec une pause.
  • DAILY_CAP_EXCEEDED — la clé a atteint le plafond quotidien que vous avez défini. Relevez-le dans le profil ou attendez le prochain jour UTC.
  • SAFETY_FILTERED — le filtre de contenu du modèle a refusé le prompt ou le résultat ; le prélèvement est remboursé. Reformulez le prompt.
  • Les liens de fichiers expirent après 24 heures. Téléchargez le fichier dans la même exécution ; pendant 30 jours, get_result renvoie de nouveaux liens.
07FAQ

Questions sur n8n et BananaBanana

Existe-t-il un nœud BananaBanana dans n8n ?

Pas encore dans la liste des nœuds. Les nœuds MCP Client Tool et HTTP Request fournis avec n8n atteignent déjà tous les outils BananaBanana, et les workflows prêts à l'emploi ci-dessus les configurent pour vous.

Ai-je besoin d'une clé OpenAI ou d'un autre modèle ?

Uniquement pour la méthode A, où un AI Agent décide quel outil appeler. La méthode B avec des nœuds HTTP Request ne demande rien d'autre que la clé BananaBanana.

Combien coûte une exécution de workflow ?

Exactement le prix de ce qu'il génère : dès $0.03 pour une image, dès $0.06 pour un clip vidéo, $0.01 par tranche de 200 caractères de voix entamée. Les consultations de statut et les téléchargements sont gratuits, et les générations échouées sont remboursées.

Une relance ou une boucle peut-elle me facturer deux fois ?

Pas lorsque l'appel porte un idempotency_key : un appel répété avec la même clé renvoie la tâche d'origine sans nouvelle facturation. Un plafond quotidien sur la clé limite les dégâts d'une boucle qui s'emballe.

Quels modèles un workflow peut-il utiliser ?

Tous les modèles de la plateforme : Nano Banana 2, 2.1, Lite et Pro, GPT Image et Qwen pour les images ; Veo 3.1, Gemini Omni, Wan 3.0 et Grok Imagine pour la vidéo ; Gemini TTS pour la voix. list_models renvoie la liste à jour avec les prix.

Branchez la génération dans votre prochain workflow

Une clé, paiement par génération, devis avant chaque appel coûteux.

Créer une clé API