n8n انٹیگریشن

تصاویر اور ویڈیو n8n کے اندر بنائیں، انتظار کریں، ڈاؤن لوڈ کریں، شائع کریں — ایک ہی ورک فلو میں

ایک API کی سے n8n کو BananaBanana سے جوڑیں اور اپنے ورک فلو سے Nano Banana، Veo، Gemini Omni، Wan، Grok Imagine، GPT Image، Qwen اور Gemini TTS کو کال کریں۔ دو راستے ہیں: MCP Client Tool نوڈ کے ساتھ AI Agent، یا سادہ HTTP Request نوڈز جن میں کسی لینگویج ماڈل کی ضرورت نہیں۔

API کی بنائیںتصاویر $0.03 سے، ویڈیو $0.06 سے — فی جنریشن ادائیگی
01آپ کو کیا ملتا ہے

ورک فلو کیا کر سکتا ہے اور اس کی لاگت کیا ہے

ہر جنریشن کی ادائیگی آپ کے BananaBanana بیلنس سے ویب سائٹ والی قیمتوں پر ہوتی ہے۔ کوئی سبسکرپشن نہیں اور n8n کے لیے الگ فیس نہیں۔ مہنگی کالز (ویڈیو، ایک ساتھ کئی تصاویر) پہلے کوٹیشن واپس کرتی ہیں اور آپ کی تصدیق تک کوئی چارج نہیں لیتیں؛ ناکام یا فلٹر ہونے والی جنریشنز کی رقم خودکار طور پر واپس ہو جاتی ہے۔

کالقیمت
تصویر (generate_image، edit_image)$0.03–$0.20 فی تصویر
ویڈیو کلپ (generate_video، edit_video)$0.06–$6.00 فی کلپ
آواز (generate_speech)$0.01 فی شروع ہونے والے 200 حروف
اسٹیٹس، ماڈلز، اکاؤنٹ (get_result، list_models، get_account)مفت

ماڈل، ریزولوشن اور دورانیے کی درست قیمت list_models میں اور قیمتوں کے صفحے پر موجود ہے۔

02مرحلہ 1

API کی بنائیں

  1. رجسٹر کریں اور اپنا بیلنس ٹاپ اپ کریں۔
  2. پروفائل ← API Keys کھولیں اور ایک کی بنائیں۔ یہ bb_live_ سے شروع ہوتی ہے اور صرف ایک بار دکھائی جاتی ہے — اسے سیدھا n8n کریڈینشل میں کاپی کر لیں۔
  3. کی پر اپنے ورک فلو کے مطابق روزانہ خرچ کی حد مقرر کریں، مثلاً روزانہ متوقع رنز کی لاگت کے برابر۔ پھر کوئی بگڑا ہوا لوپ بیلنس خالی کرنے کے بجائے اسی حد پر رک جاتا ہے۔
  4. n8n میں Bearer Auth کریڈینشل بنائیں اور کی کو Bearer Token کے طور پر پیسٹ کریں۔ نیچے کے دونوں طریقے یہی ایک کریڈینشل استعمال کرتے ہیں۔
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

ایجنٹ کو اپنا لینگویج ماڈل (OpenAI، Anthropic، Gemini یا n8n کا سپورٹ کردہ کوئی بھی ماڈل) اور اس کی اپنی API کی درکار ہے: میڈیا 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 ہر کال میں فائل تیار ہونے تک زیادہ سے زیادہ 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، سوشل پوسٹنگ — فائل قبول کرنے والے کسی بھی نوڈ تک جاتی ہے۔
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 کے لیے کال دو بار بھیجیں: پہلا جواب quoted_cost_usd لاتا ہے؛ If نوڈ اس کا آپ کی حد سے موازنہ کرتا ہے، اور اس کے بعد ہی دوسری کال اسے confirm_cost کے طور پر واپس بھیجتی ہے۔ ویڈیو میں ایک سے دس منٹ لگتے ہیں، اس لیے 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تیار ورک فلو

ایک منٹ میں ورک فلو امپورٹ کریں

دونوں ورک فلو میں کوئی کیز یا کریڈینشلز نہیں ہیں۔ n8n میں Workflows → Import from File چنیں (یا JSON کو ایڈیٹر میں پیسٹ کریں)، پھر وارننگ کے نشان والے نوڈز میں اپنے کریڈینشلز منتخب کریں۔

  • AI Agent + MCP Client Tool: Manual Trigger → AI Agent (OpenAI Chat Model، BananaBanana MCP) → Download file۔ اپنا OpenAI کریڈینشل اور Bearer Auth کریڈینشل منتخب کریں۔

    JSON ڈاؤن لوڈ کریں · bananabanana-n8n-agent.json
  • HTTP Request: Manual Trigger → ریکوئسٹ سیٹنگز → Generate image → Get result (انتظار کے لوپ کے ساتھ) → Download file، اور واضح ایرر اسٹاپس۔ تینوں ریکوئسٹ نوڈز میں Bearer Auth کریڈینشل منتخب کریں۔

    JSON ڈاؤن لوڈ کریں · bananabanana-n8n-http.json

دونوں ورک فلو سیلف ہوسٹڈ n8n 2.48.7 پر امپورٹ کیے گئے اور شروع سے آخر تک چلائے گئے؛ ڈیفالٹ تصویر کی لاگت $0.03 فی رن ہے۔

06مسائل کا حل

عام ایررز اور ان کا حل

  • 401 — کی موجود نہیں، غلط لکھی گئی ہے یا منسوخ ہو چکی ہے۔ کریڈینشل میں خود کی ہونی چاہیے؛ لفظ Bearer n8n خود لگاتا ہے۔
  • INSUFFICIENT_BALANCE — بیلنس کال کے لیے کافی نہیں۔ جواب میں ٹاپ اپ کا لنک ہوتا ہے؛ کچھ چارج نہیں ہوا۔
  • confirmation_required — یہ ایرر نہیں: کال کو confirm_cost درکار ہے (طریقہ A اور ویڈیو والی ترکیب دیکھیں)۔
  • RATE_LIMITED — ایک کی پر فی منٹ 20 سے زیادہ ٹول کالز۔ Wait شامل کریں یا وقفے کے ساتھ Retry On Fail آن کریں۔
  • DAILY_CAP_EXCEEDED — کی آپ کی مقرر کردہ روزانہ حد تک پہنچ گئی۔ پروفائل میں حد بڑھائیں یا اگلے UTC دن کا انتظار کریں۔
  • SAFETY_FILTERED — ماڈل کے مواد کے فلٹر نے پرامپٹ یا نتیجہ مسترد کر دیا؛ چارج واپس کر دیا جاتا ہے۔ پرامپٹ کو دوبارہ لکھیں۔
  • فائل لنکس 24 گھنٹے بعد ختم ہو جاتے ہیں۔ فائل اسی رن میں ڈاؤن لوڈ کریں؛ 30 دن کے اندر get_result نئے لنکس واپس کرتا ہے۔
07عمومی سوالات

n8n اور BananaBanana کے بارے میں سوالات

کیا n8n میں BananaBanana نوڈ موجود ہے؟

ابھی نوڈ لسٹ میں نہیں۔ n8n کے ساتھ آنے والے MCP Client Tool اور HTTP Request نوڈز پہلے ہی BananaBanana کے ہر ٹول تک پہنچتے ہیں، اور اوپر کے تیار ورک فلو انہیں آپ کے لیے سیٹ کر دیتے ہیں۔

کیا مجھے OpenAI یا کسی اور ماڈل کی کی چاہیے؟

صرف طریقہ A کے لیے، جہاں AI Agent طے کرتا ہے کہ کون سا ٹول کال کرنا ہے۔ HTTP Request نوڈز والے طریقہ B کو BananaBanana کی کے سوا کچھ نہیں چاہیے۔

ایک ورک فلو رن کی لاگت کتنی ہے؟

بالکل اتنی جتنی اس کی بنائی ہوئی چیز کی قیمت ہے: تصویر کے لیے $0.03 سے، ویڈیو کلپ کے لیے $0.06 سے، آواز کے ہر شروع ہونے والے 200 حروف کے لیے $0.01۔ اسٹیٹس چیک اور ڈاؤن لوڈ مفت ہیں، اور ناکام جنریشنز کی رقم واپس ہو جاتی ہے۔

کیا ری ٹرائی یا لوپ مجھ سے دو بار چارج کر سکتا ہے؟

نہیں، جب کال میں idempotency_key ہو: اسی کی کے ساتھ دہرائی گئی کال نیا چارج لیے بغیر اصل جاب واپس کرتی ہے۔ کی پر روزانہ حد بے قابو لوپ کے نقصان کو محدود کر دیتی ہے۔

ورک فلو کون سے ماڈلز استعمال کر سکتا ہے؟

پلیٹ فارم کے تمام ماڈلز: تصاویر کے لیے Nano Banana 2، 2.1، Lite اور Pro، GPT Image اور Qwen؛ ویڈیو کے لیے Veo 3.1، Gemini Omni، Wan 3.0 اور Grok Imagine؛ آواز کے لیے Gemini TTS۔ list_models قیمتوں کے ساتھ موجودہ فہرست واپس کرتا ہے۔

جنریشن کو اپنے اگلے ورک فلو میں شامل کریں

ایک کی، فی جنریشن ادائیگی، ہر مہنگی کال سے پہلے کوٹیشن۔

API کی بنائیں