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ノードだけの構成です。

APIキーを作成画像 $0.03 から、動画 $0.06 から。生成ごとの従量課金
01できること

ワークフローでできることと料金

生成にかかる料金はすべて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と料金ページで確認できます。

02ステップ1

APIキーを作成する

  1. アカウントを登録して残高をチャージします。
  2. プロフィール → API Keysを開いてキーを作成します。キーはbb_live_で始まり、表示されるのは一度だけです。そのままn8nのクレデンシャルにコピーしてください。
  3. ワークフローに見合った1日あたりの利用上限をキーに設定します。たとえば1日に想定される実行分の料金です。ループが暴走しても、残高が尽きる前に上限で止まります。
  4. n8nでBearer Authクレデンシャルを作成し、キーをBearer Tokenとして貼り付けます。以下の2つの方法は、どちらもこの1つのクレデンシャルを使います。
03方法A

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: File
04方法B

HTTP Requestノード(言語モデルなし)

MCPエンドポイントはPOSTで送るシンプルなJSONなので、通常のHTTP Requestノードから直接呼び出せます。モデルのトークン代がかからず、エージェントがパラメーターを選ぶこともないため、最も安価で挙動が予測しやすい方法です。

  1. 画像を生成 — generate_imageのtools/callをPOSTします。idempotency_keyには{{ $execution.id }}を使ってください。n8nがノードを再試行しても、同じキーなら元のジョブが返り、二重課金されません。
  2. 結果を取得 — job_idとwait_seconds: 30を付けてget_resultをPOSTします。Ifノードでstatus: processingを5秒のWaitに送って再度取得し、completedなら次へ進みます。
  3. ファイルをダウンロード — 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)
05用意済みワークフロー

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.json
  • HTTP Request:Manual Trigger → リクエスト設定 → 画像を生成 → 結果を取得(待機ループ付き)→ ファイルのダウンロード。エラー時に停止する処理も含みます。3つのリクエストノードでBearer Authクレデンシャルを選択してください。

    JSONをダウンロード · bananabanana-n8n-http.json

どちらのワークフローも、セルフホストのn8n 2.48.7でインポートし、最初から最後まで実行して確認済みです。デフォルトの画像は1回の実行あたり $0.03 です。

06トラブルシューティング

よくあるエラーと対処法

  • 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で新しいリンクを取得できます。
07FAQ

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で、最新の一覧と料金を取得できます。

次のワークフローに画像・動画生成を組み込もう

キー1つ、生成ごとの従量課金、高額な呼び出しの前には必ず見積りを表示。

APIキーを作成