n8n entegrasyonu

Görsel ve video doğrudan n8n içinde Üretin, bekleyin, indirin, yayınlayın — tek bir iş akışında

n8n'i tek bir API anahtarıyla BananaBanana'ya bağlayın ve Nano Banana, Veo, Gemini Omni, Wan, Grok Imagine, GPT Image, Qwen ile Gemini TTS'yi iş akışlarınızdan çağırın. İki yol var: MCP Client Tool düğümüyle bir AI Agent ya da dil modeli gerektirmeyen sade HTTP Request düğümleri.

API anahtarı oluşturunGörseller $0.03'dan, videolar $0.06'dan başlayan fiyatlarla — üretim başına ödeme
01Neler elde edersiniz

Bir iş akışı neler yapabilir ve maliyeti nedir

Her üretim, sitedeki fiyatlarla BananaBanana bakiyenizden ödenir. Abonelik ve n8n'e özel bir ücret yoktur. Pahalı çağrılar (video, birden fazla görsel) önce bir fiyat teklifi döndürür ve siz onaylayana kadar hiçbir şey tahsil etmez; başarısız olan ve filtreye takılan üretimler otomatik olarak iade edilir.

ÇağrıFiyat
Görsel (generate_image, edit_image)Görsel başına $0.03–$0.20
Video klip (generate_video, edit_video)Klip başına $0.06–$6.00
Ses (generate_speech)Başlanan her 200 karakter için $0.01
Durum, modeller, hesap (get_result, list_models, get_account)ücretsiz

Bir modelin, çözünürlüğün ve sürenin kesin fiyatı list_models çıktısında ve fiyatlandırma sayfasında yer alır.

02Adım 1

Bir API anahtarı oluşturun

  1. Kaydolun ve bakiye yükleyin.
  2. Profil → API Anahtarları bölümünü açıp bir anahtar oluşturun. Anahtar bb_live_ ile başlar ve yalnızca bir kez gösterilir — doğrudan bir n8n credential'ına kopyalayın.
  3. Anahtara iş akışınıza uygun bir günlük harcama limiti koyun; örneğin günde beklediğiniz çalıştırmaların maliyeti kadar. Böylece kontrolden çıkan bir döngü bakiyeyi eritmek yerine limitte durur.
  4. n8n'de bir Bearer Auth credential'ı oluşturun ve anahtarı Bearer Token olarak yapıştırın. Aşağıdaki iki yöntem de bu tek credential'ı kullanır.
03Yöntem A

AI Agent + MCP Client Tool

Bir AI Agent düğümü ekleyin, bir sohbet modeli bağlayın ve MCP Client Tool düğümünü şu ayarlarla ekleyin:

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

Ajanın kendi dil modeline (OpenAI, Anthropic, Gemini veya n8n'in desteklediği herhangi bir model) ve kendi API anahtarına ihtiyacı vardır: medyayı BananaBanana üretir, hangi araçların çağrılacağına model karar verir.

Fiyat onayı

Video ve çoklu görsel çağrıları önce status: confirmation_required ve quoted_cost_usd ile yanıt verir, hiçbir şey tahsil etmez. Ücret, ancak aynı çağrı teklife eşit bir confirm_cost ile geri geldiğinde alınır. Ajana sistem mesajında ne yapacağını söyleyin: durup fiyatı bildirsin (aşağıdaki gibi) ya da belirlediğiniz bir limite kadar kendi başına onaylasın.

Hazır workflow'da kullandığımız sistem mesajı

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.

Üretim asenkrondur: generate_image bir job_id döndürür, get_result ise dosya hazır olana kadar çağrı başına en fazla 30 saniye bekler. Yanıt, imzalı bir dosya bağlantısı içerir; ajandan sonra gelen bir HTTP Request düğümü bunu dosya olarak indirir.

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

HTTP Request düğümleri, dil modeli yok

MCP uç noktası POST üzerinden düz JSON olduğundan, sıradan HTTP Request düğümleri onu doğrudan çağırabilir. Bu, en ucuz ve en öngörülebilir seçenektir: model token'ı yok, parametreleri seçen bir ajan yok.

  1. Generate image — generate_image için bir tools/call POST'u gönderin. idempotency_key alanında {{ $execution.id }} kullanın: n8n düğümü yeniden denerse aynı anahtar, iki kez ücret almak yerine ilk işi döndürür.
  2. Get result — job_id ve wait_seconds: 30 ile get_result için POST gönderin. Bir If düğümü status: processing durumunu 5 saniyelik bir Wait düğümüne yollar ve başa döner; completed devam eder.
  3. Download file — Response Format File olarak ayarlı şekilde files[0].url adresine GET isteği gönderin. İkili veri Google Drive, S3, WordPress, YouTube, sosyal medya paylaşımı — dosya kabul eden her düğüme geçer.
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: teklif al, kontrol et, onayla

generate_video için çağrıyı iki kez gönderin: ilk yanıt quoted_cost_usd içerir; bir If düğümü bunu limitinizle karşılaştırır ve ancak ondan sonra ikinci çağrı bunu confirm_cost olarak geri iletir. Videolar bir ila on dakika sürer, bu yüzden get_result döngüsünü koruyun.

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)
05Hazır workflow'lar

Bir dakikada workflow içe aktarın

İki workflow'da da anahtar veya credential bulunmaz. n8n'de Workflows → Import from File seçeneğini kullanın (ya da JSON'u editöre yapıştırın), ardından uyarı işaretli düğümlerde kendi credential'larınızı seçin.

  • AI Agent + MCP Client Tool: Manual Trigger → AI Agent (OpenAI Chat Model, BananaBanana MCP) → Download file. OpenAI credential'ınızı ve Bearer Auth credential'ını seçin.

    JSON'u indir · bananabanana-n8n-agent.json
  • HTTP Request: Manual Trigger → istek ayarları → Generate image → Get result (bekleme döngüsüyle) → Download file, ayrıca net hata durakları. Üç istek düğümünde Bearer Auth credential'ını seçin.

    JSON'u indir · bananabanana-n8n-http.json

İki workflow da kendi sunucusunda çalışan n8n 2.48.7 üzerinde içe aktarıldı ve baştan sona çalıştırıldı; varsayılan görselin maliyeti çalıştırma başına $0.03'dır.

06Sorun giderme

Sık görülen hatalar ve ne yapmalı

  • 401 — anahtar eksik, yanlış yazılmış veya iptal edilmiş. Credential'ın içinde yalnızca anahtar olmalı; Bearer sözcüğünü n8n kendisi ekler.
  • INSUFFICIENT_BALANCE — bakiye çağrıyı karşılamıyor. Yanıt bir bakiye yükleme bağlantısı içerir; hiçbir şey tahsil edilmedi.
  • confirmation_required — hata değildir: çağrının confirm_cost alanına ihtiyacı var (Yöntem A'ya ve video tarifine bakın).
  • RATE_LIMITED — tek bir anahtarda dakikada 20 araç çağrısından fazlası. Bir Wait ekleyin veya aralıklı Retry On Fail'i etkinleştirin.
  • DAILY_CAP_EXCEEDED — anahtar, belirlediğiniz günlük limite ulaştı. Limiti profilden yükseltin ya da bir sonraki UTC gününü bekleyin.
  • SAFETY_FILTERED — modelin içerik filtresi istemi veya sonucu reddetti; tahsil edilen tutar iade edilir. İstemi yeniden yazın.
  • Dosya bağlantıları 24 saat sonra geçersiz olur. Dosyayı aynı çalıştırmada indirin; 30 gün içinde get_result yeni bağlantılar döndürür.
07SSS

n8n ve BananaBanana hakkında sorular

n8n'de bir BananaBanana düğümü var mı?

Düğüm listesinde henüz yok. n8n ile birlikte gelen MCP Client Tool ve HTTP Request düğümleri zaten tüm BananaBanana araçlarına ulaşır; yukarıdaki hazır workflow'lar bunları sizin yerinize kurar.

OpenAI veya başka bir model anahtarına ihtiyacım var mı?

Yalnızca hangi aracın çağrılacağına bir AI Agent'ın karar verdiği Yöntem A için. HTTP Request düğümlerini kullanan Yöntem B'de BananaBanana anahtarından başka bir şey gerekmez.

Bir workflow çalıştırması ne kadar tutar?

Tam olarak ürettiği şeyin fiyatı kadar: görsel için $0.03'dan, video klip için $0.06'dan başlayan fiyatlarla, sesin başlanan her 200 karakteri için $0.01. Durum kontrolleri ve indirmeler ücretsizdir, başarısız üretimler iade edilir.

Yeniden deneme veya döngü beni iki kez ücretlendirebilir mi?

Çağrı bir idempotency_key taşıyorsa hayır: aynı anahtarla tekrarlanan çağrı, yeni ücret almadan ilk işi döndürür. Anahtardaki günlük limit de kontrolden çıkan bir döngünün zararını sınırlar.

Bir workflow hangi modelleri kullanabilir?

Platformun tüm modelleri: görseller için Nano Banana 2, 2.1, Lite ve Pro, GPT Image ve Qwen; video için Veo 3.1, Gemini Omni, Wan 3.0 ve Grok Imagine; ses için Gemini TTS. list_models güncel listeyi fiyatlarıyla birlikte döndürür.

Üretimi bir sonraki workflow'unuza bağlayın

Tek anahtar, üretim başına ödeme, her pahalı çağrıdan önce fiyat teklifi.

API anahtarı oluşturun