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.
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.
Bir API anahtarı oluşturun
- Kaydolun ve bakiye yükleyin.
- 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. - 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.
- n8n'de bir
Bearer Authcredential'ı oluşturun ve anahtarı Bearer Token olarak yapıştırın. Aşağıdaki iki yöntem de bu tek credential'ı kullanır.
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_resultAjanı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: FileHTTP 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.
- Generate image —
generate_imageiçin birtools/callPOST'u gönderin.idempotency_keyalanında{{ $execution.id }}kullanın: n8n düğümü yeniden denerse aynı anahtar, iki kez ücret almak yerine ilk işi döndürür. - Get result —
job_idvewait_seconds: 30ileget_resultiçin POST gönderin. BirIfdüğümüstatus: processingdurumunu 5 saniyelik birWaitdüğümüne yollar ve başa döner;completeddevam eder. - Download file — Response Format File olarak ayarlı şekilde
files[0].urladresine 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: FileVideo: 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)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.jsonHTTP 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.
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ınconfirm_costalanı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ı. BirWaitekleyin 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_resultyeni bağlantılar döndürür.
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