n8n連携
画像と動画をn8nの中で生成 生成、待機、ダウンロード、公開まで1つのワークフローで
APIキー1つでn8nとBananaBananaを接続し、Nano Banana、Veo、Gemini Omni、Wan、Grok Imagine、GPT Image、Qwen、Gemini TTSをワークフローから呼び出せます。接続方法は2通り。MCP Client Toolノードを使ったAI Agent、または言語モデルを使わないHTTP Requestノードだけの構成です。
ワークフローでできることと料金
生成にかかる料金はすべてBananaBananaの残高から、ウェブサイトと同じ価格で引き落とされます。サブスクリプションもn8n専用の手数料もありません。高額な呼び出し(動画、複数枚の画像の同時生成)はまず見積りを返し、確認するまで課金されません。失敗した生成やフィルターで拒否された生成は自動で返金されます。
| 呼び出し | 料金 |
|---|---|
| 画像(generate_image、edit_image) | 1枚あたり $0.03~$0.20 |
| 動画クリップ(generate_video、edit_video) | 1クリップあたり $0.06~$6.00 |
| 音声(generate_speech) | 200文字ごと(端数切り上げ)に $0.01 |
| ステータス、モデル、アカウント(get_result、list_models、get_account) | 無料 |
モデル・解像度・長さごとの正確な料金は、list_modelsと料金ページで確認できます。
APIキーを作成する
- アカウントを登録して残高をチャージします。
- プロフィール → API Keysを開いてキーを作成します。キーは
bb_live_で始まり、表示されるのは一度だけです。そのままn8nのクレデンシャルにコピーしてください。 - ワークフローに見合った1日あたりの利用上限をキーに設定します。たとえば1日に想定される実行分の料金です。ループが暴走しても、残高が尽きる前に上限で止まります。
- n8nで
Bearer Authクレデンシャルを作成し、キーをBearer Tokenとして貼り付けます。以下の2つの方法は、どちらもこの1つのクレデンシャルを使います。
AI Agent + MCP Client Tool
AI Agentノードを追加し、チャットモデルとMCP Client Toolノードを接続して、次のように設定します。
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エージェントには、独自のAPIキーを持つ専用の言語モデル(OpenAI、Anthropic、Gemini、またはn8nが対応する任意のモデル)が必要です。メディアを生成するのはBananaBananaで、どのツールを呼ぶかを判断するのはそのモデルです。
料金の確認
動画や複数画像の呼び出しは、まずstatus: confirmation_requiredとquoted_cost_usdを返し、課金は行いません。見積りと同額のconfirm_costを付けて同じ呼び出しを再送したときにだけ、課金されます。エージェントのシステムメッセージで動作を指示してください。料金を報告して停止する(下記の例)か、指定した上限までは自分で確認して進めるか、のどちらかです。
用意済みワークフローで使っているシステムメッセージ
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.生成は非同期です。generate_imageはjob_idを返し、get_resultは1回の呼び出しで最大30秒、ファイルの準備ができるまで待機します。応答には署名付きのファイルリンクが含まれ、エージェントの後ろに置いたHTTP Requestノードでファイルとしてダウンロードします。
Node: HTTP Request (after the AI Agent)
Method: GET
URL: {{ $json.output.match(/https?:\/\/\S+?\/api\/files\/[^\s)"'\]]+/)[0] }}
Options → Response → Response Format: FileHTTP Requestノード(言語モデルなし)
MCPエンドポイントはPOSTで送るシンプルなJSONなので、通常のHTTP Requestノードから直接呼び出せます。モデルのトークン代がかからず、エージェントがパラメーターを選ぶこともないため、最も安価で挙動が予測しやすい方法です。
- 画像を生成 —
generate_imageのtools/callをPOSTします。idempotency_keyには{{ $execution.id }}を使ってください。n8nがノードを再試行しても、同じキーなら元のジョブが返り、二重課金されません。 - 結果を取得 —
job_idとwait_seconds: 30を付けてget_resultをPOSTします。Ifノードでstatus: processingを5秒のWaitに送って再度取得し、completedなら次へ進みます。 - ファイルをダウンロード — Response FormatをFileにして
files[0].urlをGETします。取得したバイナリは、Google Drive、S3、WordPress、YouTube、SNS投稿など、ファイルを受け取れるノードにそのまま渡せます。
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動画:見積り、確認、承認
generate_videoは2回送ります。1回目の応答にquoted_cost_usdが含まれます。Ifノードでそれを上限と比較し、問題なければ2回目の呼び出しでその値をconfirm_costとして返します。動画は1~10分かかるため、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)1分でワークフローをインポート
どちらのワークフローにも、キーやクレデンシャルは含まれていません。n8nでWorkflows → Import from Fileを選ぶ(またはJSONをエディターに貼り付ける)と、警告マークの付いたノードでご自身のクレデンシャルを選べます。
AI Agent + MCP Client Tool:Manual Trigger → AI Agent(OpenAI Chat Model、BananaBanana MCP)→ ファイルのダウンロード。ご自身のOpenAIクレデンシャルとBearer Authクレデンシャルを選択してください。
JSONをダウンロード · bananabanana-n8n-agent.jsonHTTP Request:Manual Trigger → リクエスト設定 → 画像を生成 → 結果を取得(待機ループ付き)→ ファイルのダウンロード。エラー時に停止する処理も含みます。3つのリクエストノードでBearer Authクレデンシャルを選択してください。
JSONをダウンロード · bananabanana-n8n-http.json
どちらのワークフローも、セルフホストのn8n 2.48.7でインポートし、最初から最後まで実行して確認済みです。デフォルトの画像は1回の実行あたり $0.03 です。
よくあるエラーと対処法
401— キーが未設定、入力ミス、または失効しています。クレデンシャルにはキー本体を入れてください。Bearerという語はn8nが付加します。INSUFFICIENT_BALANCE— 残高がこの呼び出しの料金に足りません。応答にチャージ用リンクが含まれます。課金は発生していません。confirmation_required— エラーではありません。この呼び出しにはconfirm_costが必要です(方法Aと動画のレシピを参照)。RATE_LIMITED— 1つのキーで毎分 20 回を超えるツール呼び出しがありました。Waitを追加するか、Retry On Failを有効にして間隔を空けてください。DAILY_CAP_EXCEEDED— キーが設定した1日の上限に達しました。プロフィールで上限を引き上げるか、次のUTC日まで待ってください。SAFETY_FILTERED— モデルのコンテンツフィルターがプロンプトまたは結果を拒否しました。課金は返金されます。プロンプトを言い換えてください。- ファイルリンクの有効期限は24時間です。同じ実行の中でファイルをダウンロードしてください。30日以内なら、
get_resultで新しいリンクを取得できます。
n8nとBananaBananaについてのよくある質問
n8nにBananaBananaのノードはありますか?
ノード一覧にはまだありません。ただし、n8nに標準搭載のMCP Client ToolノードとHTTP Requestノードで、BananaBananaのすべてのツールを利用できます。上の用意済みワークフローには、その設定が済んでいます。
OpenAIなどのモデル用キーは必要ですか?
必要なのは方法Aだけです。方法Aでは、AI Agentがどのツールを呼ぶかを判断します。HTTP Requestノードを使う方法Bなら、BananaBananaのキーだけで動きます。
ワークフローを1回実行すると、いくらかかりますか?
生成したものの料金そのままです。画像は $0.03 から、動画クリップは $0.06 から、音声は200文字ごと(端数切り上げ)に $0.01 です。ステータス確認とダウンロードは無料で、失敗した生成は返金されます。
再試行やループで二重に課金されることはありますか?
idempotency_keyを付けた呼び出しなら、ありません。同じキーで再送すると、新たな課金なしで元のジョブが返ります。キーに1日の上限を設定しておけば、ループが暴走したときの被害も抑えられます。
ワークフローではどのモデルを使えますか?
プラットフォームのすべてのモデルです。画像はNano Banana 2、2.1、Lite、Pro、GPT Image、Qwen、動画はVeo 3.1、Gemini Omni、Wan 3.0、Grok Imagine、音声はGemini TTSに対応しています。list_modelsで、最新の一覧と料金を取得できます。