Integrasi n8n

Gambar dan video langsung di n8n Buat, tunggu, unduh, publikasikan — dalam satu workflow

Hubungkan n8n ke BananaBanana dengan satu API key dan panggil Nano Banana, Veo, Gemini Omni, Wan, Grok Imagine, GPT Image, Qwen, dan Gemini TTS dari workflow Anda. Ada dua cara: AI Agent dengan node MCP Client Tool, atau node HTTP Request biasa tanpa model bahasa sama sekali.

Buat API keyGambar mulai dari $0.03, video mulai dari $0.06 — bayar per pembuatan
01Yang Anda dapatkan

Apa yang bisa dilakukan workflow dan berapa biayanya

Setiap pembuatan dibayar dari saldo BananaBanana Anda dengan harga yang sama seperti di situs web. Tidak ada langganan dan tidak ada biaya khusus n8n. Panggilan mahal (video, beberapa gambar sekaligus) lebih dulu mengembalikan penawaran harga dan tidak memungut biaya sampai Anda mengonfirmasinya; pembuatan yang gagal atau terkena filter dikembalikan (refund) secara otomatis.

PanggilanHarga
Gambar (generate_image, edit_image)$0.03–$0.20 per gambar
Klip video (generate_video, edit_video)$0.06–$6.00 per klip
Ucapan (generate_speech)$0.01 per 200 karakter yang dimulai
Status, model, akun (get_result, list_models, get_account)gratis

Harga pasti untuk model, resolusi, dan durasi tertentu ada di list_models dan di halaman harga.

02Langkah 1

Buat API key

  1. Daftar lalu isi saldo Anda.
  2. Buka Profil → API Keys dan buat kunci. Kunci diawali bb_live_ dan hanya ditampilkan sekali — salin langsung ke credential n8n.
  3. Atur batas pengeluaran harian pada kunci sesuai workflow Anda, misalnya biaya proses yang Anda perkirakan per hari. Jika sebuah loop salah jalan, ia berhenti di batas itu dan tidak menguras saldo.
  4. Di n8n buat credential Bearer Auth dan tempel kunci sebagai Bearer Token. Kedua metode di bawah memakai satu credential ini.
03Metode A

AI Agent + MCP Client Tool

Tambahkan node AI Agent, sambungkan model chat, lalu sambungkan node MCP Client Tool dengan pengaturan berikut:

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

Agen membutuhkan model bahasa sendiri (OpenAI, Anthropic, Gemini, atau model apa pun yang didukung n8n) dengan API key sendiri: BananaBanana membuat medianya, sedangkan model memutuskan tool mana yang dipanggil.

Konfirmasi harga

Panggilan video dan multi-gambar pertama-tama menjawab status: confirmation_required beserta quoted_cost_usd dan tidak memungut biaya. Uang baru diambil ketika panggilan yang sama datang kembali dengan confirm_cost yang sama dengan penawaran. Beri tahu agen lewat system message apa yang harus dilakukan: berhenti dan melaporkan harga (seperti di bawah), atau mengonfirmasi sendiri sampai batas yang Anda tentukan.

System message yang kami pakai di workflow siap pakai

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.

Pembuatan bersifat asinkron: generate_image mengembalikan job_id, dan get_result menunggu hingga 30 detik per panggilan sampai file siap. Jawabannya berisi tautan file bertanda tangan, yang diunduh sebagai file oleh node HTTP Request setelah agen.

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

Node HTTP Request, tanpa model bahasa

Endpoint MCP adalah JSON biasa lewat POST, sehingga node HTTP Request biasa bisa memanggilnya langsung. Ini opsi termurah dan paling dapat diprediksi: tanpa token model dan tanpa agen yang memilih parameter.

  1. Buat gambar — POST tools/call untuk generate_image. Gunakan {{ $execution.id }} di idempotency_key: jika n8n mengulang node, kunci yang sama mengembalikan job asli, bukan menagih dua kali.
  2. Ambil hasil — POST get_result dengan job_id dan wait_seconds: 30. Node If mengirim status: processing ke Wait 5 detik lalu kembali; completed lanjut ke langkah berikutnya.
  3. Unduh file — GET files[0].url dengan Response Format diatur ke File. Binary diteruskan ke Google Drive, S3, WordPress, YouTube, posting media sosial — node apa pun yang menerima file.
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: penawaran, pengecekan, konfirmasi

Untuk generate_video kirim panggilan dua kali: jawaban pertama membawa quoted_cost_usd; node If membandingkannya dengan batas Anda, dan baru setelah itu panggilan kedua mengirimkannya kembali sebagai confirm_cost. Video butuh satu hingga sepuluh menit, jadi pertahankan loop 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)
05Workflow siap pakai

Impor workflow dalam satu menit

Kedua workflow tidak berisi kunci atau credential. Di n8n pilih Workflows → Import from File (atau tempel JSON ke editor), lalu pilih credential Anda pada node yang ditandai peringatan.

  • AI Agent + MCP Client Tool: Manual Trigger → AI Agent (OpenAI Chat Model, BananaBanana MCP) → Download file. Pilih credential OpenAI dan credential Bearer Auth Anda.

    Unduh JSON · bananabanana-n8n-agent.json
  • HTTP Request: Manual Trigger → pengaturan request → Generate image → Get result (dengan loop tunggu) → Download file, plus penghentian error yang jelas. Pilih credential Bearer Auth di ketiga node request.

    Unduh JSON · bananabanana-n8n-http.json

Kedua workflow sudah diimpor dan dijalankan dari awal sampai akhir di n8n 2.48.7 self-hosted; gambar default berharga $0.03 per eksekusi.

06Pemecahan masalah

Error umum dan cara mengatasinya

  • 401 — kunci tidak ada, salah ketik, atau sudah dicabut. Credential harus berisi kunci itu sendiri; n8n menambahkan kata Bearer.
  • INSUFFICIENT_BALANCE — saldo tidak cukup untuk panggilan ini. Jawaban menyertakan tautan isi saldo; tidak ada biaya yang ditagih.
  • confirmation_required — bukan error: panggilan membutuhkan confirm_cost (lihat Metode A dan resep video).
  • RATE_LIMITED — lebih dari 20 panggilan tool per menit pada satu kunci. Tambahkan Wait atau aktifkan Retry On Fail dengan jeda.
  • DAILY_CAP_EXCEEDED — kunci mencapai batas harian yang Anda atur. Naikkan batasnya di profil atau tunggu hari UTC berikutnya.
  • SAFETY_FILTERED — filter konten model menolak prompt atau hasilnya; biaya dikembalikan (refund). Ubah redaksi prompt.
  • Tautan file kedaluwarsa setelah 24 jam. Unduh file dalam proses yang sama; dalam 30 hari get_result mengembalikan tautan baru.
07FAQ

Pertanyaan tentang n8n dan BananaBanana

Apakah ada node BananaBanana di n8n?

Belum ada di daftar node. Node MCP Client Tool dan HTTP Request bawaan n8n sudah menjangkau semua tool BananaBanana, dan workflow siap pakai di atas menyiapkannya untuk Anda.

Apakah saya perlu key OpenAI atau model lain?

Hanya untuk Metode A, di mana AI Agent memutuskan tool mana yang dipanggil. Metode B dengan node HTTP Request tidak membutuhkan apa pun selain key BananaBanana.

Berapa biaya satu kali eksekusi workflow?

Tepat sebesar harga yang dibuat: mulai dari $0.03 untuk gambar, mulai dari $0.06 untuk klip video, $0.01 per 200 karakter ucapan yang dimulai. Pengecekan status dan unduhan gratis, dan pembuatan yang gagal dikembalikan (refund).

Bisakah retry atau loop menagih saya dua kali?

Tidak, jika panggilan membawa idempotency_key: panggilan berulang dengan key yang sama mengembalikan job asli tanpa tagihan baru. Batas harian pada kunci membatasi kerugian akibat loop yang lepas kendali.

Model apa saja yang bisa dipakai workflow?

Semua model di platform: Nano Banana 2, 2.1, Lite, dan Pro, GPT Image dan Qwen untuk gambar; Veo 3.1, Gemini Omni, Wan 3.0, dan Grok Imagine untuk video; Gemini TTS untuk suara. list_models mengembalikan daftar terbaru beserta harganya.

Pasang pembuatan media di workflow berikutnya

Satu kunci, bayar per pembuatan, penawaran harga sebelum setiap panggilan mahal.

Buat API key