تكامل n8n

الصور والفيديو داخل n8n ولّد، انتظر، نزّل، انشر — في سير عمل واحد

اربط n8n بـ BananaBanana بمفتاح API واحد واستدعِ Nano Banana وVeo وGemini Omni وWan وGrok Imagine وGPT Image وQwen وGemini TTS من سير عملك. لديك طريقتان: AI Agent مع عقدة MCP Client Tool، أو عقد 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_ ويظهر مرة واحدة فقط — انسخه مباشرة إلى credential في n8n.
  3. حدّد سقف إنفاق يوميًا للمفتاح يناسب سير عملك، مثلًا تكلفة عمليات التشغيل المتوقعة في اليوم. وإذا خرجت حلقة عن السيطرة فإنها تتوقف عند السقف بدلًا من استنزاف الرصيد.
  4. في n8n أنشئ credential من نوع Bearer Auth والصق المفتاح في Bearer Token. تستخدم الطريقتان أدناه هذا الـ credential نفسه.
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 هي JSON عادي عبر POST، لذا تستطيع عقد HTTP Request العادية استدعاءها مباشرة. هذا هو الخيار الأرخص والأكثر قابلية للتوقع: لا رموز نموذج، ولا وكيل يختار المعاملات.

  1. توليد صورة — أرسل POST بطلب tools/call إلى generate_image. استخدم {{ $execution.id }} في idempotency_key: إذا أعاد n8n تشغيل العقدة فإن المفتاح نفسه يعيد المهمة الأصلية بدل أن يُحاسَب مرتين.
  2. جلب النتيجة — أرسل POST إلى get_result مع job_id وwait_seconds: 30. تحوّل عقدة If الحالة status: processing إلى Wait لمدة 5 ثوانٍ ثم تعود؛ وتنتقل completed إلى الخطوة التالية.
  3. تنزيل الملف — أرسل GET إلى files[0].url مع ضبط Response Format على File. ينتقل الملف الثنائي إلى 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سير عمل جاهز

استورد سير عمل في دقيقة

لا يحتوي أي من سيري العمل على مفاتيح أو credentials. في n8n اختر Workflows → Import from File (أو الصق JSON في المحرر)، ثم اختر credentials الخاصة بك في العقد المعلَّمة بتحذير.

  • AI Agent + MCP Client Tool: Manual Trigger → AI Agent (OpenAI Chat Model، BananaBanana MCP) → Download file. اختر credential الخاص بـ OpenAI و credential من نوع Bearer Auth.

    تنزيل JSON · bananabanana-n8n-agent.json
  • HTTP Request: Manual Trigger → إعدادات الطلب → Generate image → Get result (مع حلقة انتظار) → Download file، إضافة إلى نقاط إيقاف واضحة عند الأخطاء. اختر credential من نوع Bearer Auth في عقد الطلب الثلاث.

    تنزيل JSON · bananabanana-n8n-http.json

جرى استيراد سيري العمل كليهما وتشغيلهما من البداية إلى النهاية على n8n 2.48.7 مستضاف ذاتيًا؛ وتكلفة الصورة الافتراضية $0.03 لكل تشغيل.

06استكشاف الأخطاء

أخطاء شائعة وما يجب فعله

  • 401 — المفتاح مفقود أو مكتوب خطأً أو ملغى. يجب أن يحتوي الـ credential على المفتاح نفسه؛ ويضيف n8n كلمة Bearer.
  • 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

هل توجد عقدة BananaBanana في n8n؟

ليس بعد في قائمة العقد. عقدتا MCP Client Tool وHTTP Request المضمَّنتان في n8n تصلان بالفعل إلى كل أدوات BananaBanana، وسيرا العمل الجاهزان أعلاه يضبطانهما لك.

هل أحتاج إلى مفتاح OpenAI أو نموذج آخر؟

فقط للطريقة A، حيث يقرر AI Agent أي أداة يستدعي. أما الطريقة B بعقد HTTP Request فلا تحتاج سوى مفتاح BananaBanana.

كم يكلّف تشغيل سير عمل واحد؟

بالضبط سعر ما يولّده: من $0.03 للصورة، ومن $0.06 لمقطع الفيديو، و$0.01 لكل 200 حرف أو جزء منها من الصوت. فحص الحالة والتنزيل مجانيان، وتُردّ مبالغ عمليات التوليد الفاشلة.

هل يمكن أن تحاسبني إعادة المحاولة أو الحلقة مرتين؟

لا، عندما يحمل الاستدعاء 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