n8n-Integration

Bilder und Videos direkt in n8n Generieren, warten, herunterladen, veröffentlichen — in einem Workflow

Verbinde n8n mit einem einzigen API-Schlüssel mit BananaBanana und rufe Nano Banana, Veo, Gemini Omni, Wan, Grok Imagine, GPT Image, Qwen und Gemini TTS aus deinen Workflows auf. Zwei Wege: ein AI Agent mit der Node MCP Client Tool oder einfache HTTP Request Nodes ganz ohne Sprachmodell.

API-Schlüssel erstellenBilder ab $0.03, Video ab $0.06 — Bezahlung pro Generierung
01Das bekommst du

Was ein Workflow kann und was es kostet

Jede Generierung wird von deinem BananaBanana-Guthaben bezahlt, zu denselben Preisen wie auf der Website. Es gibt kein Abo und keine n8n-spezifische Gebühr. Teure Aufrufe (Video, mehrere Bilder auf einmal) liefern zuerst ein Preisangebot und berechnen nichts, bis du es bestätigst; fehlgeschlagene und gefilterte Generierungen werden automatisch erstattet.

AufrufPreis
Bild (generate_image, edit_image)$0.03–$0.20 pro Bild
Videoclip (generate_video, edit_video)$0.06–$6.00 pro Clip
Sprache (generate_speech)$0.01 pro angefangene 200 Zeichen
Status, Modelle, Konto (get_result, list_models, get_account)kostenlos

Den genauen Preis eines Modells, einer Auflösung und einer Dauer findest du in list_models und auf der Preisseite.

02Schritt 1

API-Schlüssel erstellen

  1. Registriere dich und lade dein Guthaben auf.
  2. Öffne Profil → API-Schlüssel und erstelle einen Schlüssel. Er beginnt mit bb_live_ und wird nur einmal angezeigt — kopiere ihn direkt in eine n8n-Credential.
  3. Lege für den Schlüssel ein tägliches Ausgabenlimit fest, das zu deinem Workflow passt, zum Beispiel die Kosten der Durchläufe, die du pro Tag erwartest. Eine außer Kontrolle geratene Schleife stoppt dann am Limit, statt das Guthaben aufzubrauchen.
  4. Erstelle in n8n eine Bearer Auth-Credential und füge den Schlüssel als Bearer Token ein. Beide Methoden unten nutzen diese eine Credential.
03Methode A

AI Agent + MCP Client Tool

Füge eine AI Agent-Node hinzu, hänge ein Chat-Modell an und die MCP Client Tool-Node mit diesen Einstellungen:

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

Der Agent braucht ein eigenes Sprachmodell (OpenAI, Anthropic, Gemini oder jedes von n8n unterstützte Modell) mit eigenem API-Schlüssel: BananaBanana erzeugt die Medien, das Modell entscheidet, welche Tools aufgerufen werden.

Preisbestätigung

Video- und Mehrbild-Aufrufe antworten zuerst mit status: confirmation_required und quoted_cost_usd und berechnen nichts. Das Geld wird erst abgebucht, wenn derselbe Aufruf mit confirm_cost in Höhe des Angebots erneut kommt. Sag dem Agenten in seiner System Message, was zu tun ist: anhalten und den Preis melden (wie unten) oder selbst bis zu einem von dir genannten Limit bestätigen.

System Message, die wir im fertigen Workflow verwenden

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.

Die Generierung läuft asynchron: generate_image liefert eine job_id, und get_result wartet pro Aufruf bis zu 30 Sekunden, bis die Datei fertig ist. Die Antwort enthält einen signierten Dateilink, den eine HTTP Request-Node nach dem Agenten als Datei herunterlädt.

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

HTTP Request Nodes, kein Sprachmodell

Der MCP-Endpunkt ist schlichtes JSON per POST, daher können normale HTTP Request-Nodes ihn direkt aufrufen. Das ist die günstigste und berechenbarste Variante: keine Modell-Tokens und kein Agent, der Parameter wählt.

  1. Bild generieren — sende per POST einen tools/call für generate_image. Verwende {{ $execution.id }} in idempotency_key: Wiederholt n8n die Node, liefert derselbe Schlüssel den ursprünglichen Job zurück, statt doppelt abzubuchen.
  2. Ergebnis abrufen — sende per POST get_result mit der job_id und wait_seconds: 30. Eine If-Node leitet status: processing an eine Wait-Node mit 5 Sekunden und zurück; bei completed geht es weiter.
  3. Datei herunterladen — GET auf files[0].url mit Response Format auf File. Die Binärdaten gehen weiter an Google Drive, S3, WordPress, YouTube, Social-Media-Posting — jede Node, die eine Datei akzeptiert.
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

Video: Angebot, Prüfung, Bestätigung

Sende den Aufruf für generate_video zweimal: Die erste Antwort enthält quoted_cost_usd; eine If-Node vergleicht den Wert mit deinem Limit, und erst dann gibt der zweite Aufruf ihn als confirm_cost zurück. Videos brauchen eine bis zehn Minuten, behalte also die get_result-Schleife bei.

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)
05Fertige Workflows

Einen Workflow in einer Minute importieren

Beide Workflows enthalten keine Schlüssel oder Credentials. Wähle in n8n Workflows → Import from File (oder füge das JSON in den Editor ein) und wähle dann in den mit einer Warnung markierten Nodes deine Credentials aus.

  • AI Agent + MCP Client Tool: Manual Trigger → AI Agent (OpenAI Chat Model, BananaBanana MCP) → Datei herunterladen. Wähle deine OpenAI-Credential und die Bearer Auth-Credential aus.

    JSON herunterladen · bananabanana-n8n-agent.json
  • HTTP Request: Manual Trigger → Anfrage-Einstellungen → Bild generieren → Ergebnis abrufen (mit Warteschleife) → Datei herunterladen, dazu klare Fehlerabbrüche. Wähle die Bearer Auth-Credential in den drei Request-Nodes aus.

    JSON herunterladen · bananabanana-n8n-http.json

Beide Workflows wurden auf selbst gehostetem n8n 2.48.7 importiert und vollständig ausgeführt; das Standardbild kostet $0.03 pro Durchlauf.

06Fehlerbehebung

Häufige Fehler und was zu tun ist

  • 401 — der Schlüssel fehlt, ist falsch geschrieben oder wurde widerrufen. Die Credential muss den Schlüssel selbst enthalten; das Wort Bearer ergänzt n8n.
  • INSUFFICIENT_BALANCE — das Guthaben reicht für den Aufruf nicht aus. Die Antwort enthält einen Aufladelink; es wurde nichts abgebucht.
  • confirmation_required — kein Fehler: Der Aufruf braucht confirm_cost (siehe Methode A und das Video-Rezept).
  • RATE_LIMITED — mehr als 20 Tool-Aufrufe pro Minute mit einem Schlüssel. Füge eine Wait-Node hinzu oder aktiviere Retry On Fail mit Pause.
  • DAILY_CAP_EXCEEDED — der Schlüssel hat das von dir gesetzte Tageslimit erreicht. Erhöhe es im Profil oder warte auf den nächsten UTC-Tag.
  • SAFETY_FILTERED — der Inhaltsfilter des Modells hat den Prompt oder das Ergebnis abgelehnt; die Abbuchung wird erstattet. Formuliere den Prompt um.
  • Dateilinks laufen nach 24 Stunden ab. Lade die Datei im selben Durchlauf herunter; innerhalb von 30 Tagen liefert get_result neue Links.
07FAQ

Fragen zu n8n und BananaBanana

Gibt es eine BananaBanana-Node in n8n?

Noch nicht in der Node-Liste. Die in n8n enthaltenen Nodes MCP Client Tool und HTTP Request erreichen aber bereits alle BananaBanana-Tools, und die fertigen Workflows oben richten sie für dich ein.

Brauche ich einen Schlüssel von OpenAI oder einem anderen Modell?

Nur für Methode A, bei der ein AI Agent entscheidet, welches Tool aufgerufen wird. Methode B mit HTTP Request Nodes braucht nichts außer dem BananaBanana-Schlüssel.

Was kostet ein Workflow-Durchlauf?

Genau den Preis dessen, was er erzeugt: ab $0.03 für ein Bild, ab $0.06 für einen Videoclip, $0.01 pro angefangene 200 Zeichen Sprache. Statusabfragen und Downloads sind kostenlos, fehlgeschlagene Generierungen werden erstattet.

Kann mich ein Retry oder eine Schleife doppelt belasten?

Nicht, wenn der Aufruf einen idempotency_key enthält: Ein wiederholter Aufruf mit demselben Schlüssel liefert den ursprünglichen Job ohne neue Abbuchung. Ein Tageslimit für den Schlüssel begrenzt den Schaden einer außer Kontrolle geratenen Schleife.

Welche Modelle kann ein Workflow nutzen?

Alle Modelle der Plattform: Nano Banana 2, 2.1, Lite und Pro, GPT Image und Qwen für Bilder; Veo 3.1, Gemini Omni, Wan 3.0 und Grok Imagine für Video; Gemini TTS für Sprache. list_models liefert die aktuelle Liste mit Preisen.

Binde die Generierung in deinen nächsten Workflow ein

Ein Schlüssel, Bezahlung pro Generierung, Preisangebot vor jedem teuren Aufruf.

API-Schlüssel erstellen