ربط n8n بـ Claude وGPT عبر API خطوة بخطوة

لكلٍّ من بيانات اعتماد OpenAI وAnthropic في n8n حقل باسم Base URL. ولكي تعمل مسارات عملك على 5abeer، ضع فيه العنوان الأساسي الخاص بنا، والصق مفتاحًا لذلك المزوّد، وحدد النموذج بمعرّفه. ثم اربط نموذج المحادثة بعقدة AI Agent، فيُدفع كل طلب بالتوكن من رصيدك في 5abeer.

كيف يتصل n8n بنماذج Claude وGPT؟#

يتكوّن سير العمل الذكي في n8n من عقدة رئيسية، مثل AI Agent، وعقدة فرعية لنموذج المحادثة، مثل OpenAI Chat Model أو Anthropic Chat Model، وهي التي ترسل الطلبات. ويقرأ نموذج المحادثة العنوان والمفتاح من بيانات اعتماد فيها حقل Base URL، فلا تحتاج إلى عقدة من المجتمع.

وخدمة 5abeer متوافقة مع OpenAI: غيّر العنوان الأساسي واحتفظ بالكود نفسه. وهي أيضًا متوافقة مع واجهة Anthropic Messages، وهي الصيغة التي ترسلها عقدة Anthropic. ويشرح دليل ما هو العنوان الأساسي base URL؟ هذا المصطلح.

ويعمل كل مفتاح مع نماذج مزوّد واحد، وكل المفاتيح تُخصم من رصيد واحد، كما في مفتاح لكل مزوّد.

ما الذي تحتاج إليه؟#

• رصيد في 5abeer تشحنه بإحدى طرق الدفع.
• مفتاح لكل مزوّد ستستخدمه، تنشئه كما في إنشاء مفتاح.
• نسخة من n8n، سحابية أو مستضافة على خادمك. وعقد AI مدمجة في النسختين.

كل الإعدادات في هذا الدليل تطابق n8n 2.45.7، وهو الإصدار المستقر حين راجعناه في 2026-11-03، وقد تتغير أسماؤها في الإصدارات التالية. ولكل نوع من بيانات الاعتماد عنوانه الأساسي:

يبقى /v1 في آخر عنوان OpenAI. أما عنوان Anthropic فلا ينتهي به، لأن العقدة تضيف /v1/messages بنفسها.

كيف تُعدّ أول وكيل AI؟#

1. 1

   أضف عقدة Chat Trigger#

   أضف عقدة Chat Trigger إلى سير عمل جديد. تظهر العقدة باسم When chat message received، وتشغّل سير العمل مع كل رسالة ترسلها من لوحة المحادثة.

2. 2

   أضف عقدة AI Agent#

   أضف عقدة AI Agent بعد عقدة التشغيل، واترك الإعداد Source for Prompt (User Message) على القيمة Connected Chat Trigger Node.

3. 3

   اربط نموذج محادثة#

   اضغط على الموصّل Chat Model في الوكيل، واختر OpenAI Chat Model لنماذج GPT أو Anthropic Chat Model لنماذج Claude.

4. 4

   أرسل رسالة تجريبية#

   إذا وصلك الرد، فبيانات الاعتماد والعنوان الأساسي ومعرّف النموذج تعمل كلها. وإذا تحوّل لون عقدة إلى الأحمر، فافتحها واقرأ رسالة الخطأ، ثم راجع الأخطاء الشائعة في آخر الدليل.

كيف تربط نماذج GPT؟#

وهذه أحدث نماذج GPT، بسعرنا لكل مليون توكن:

1. 1

   أنشئ مفتاحًا لنماذج GPT#

   أنشئ مفتاحًا لمزوّد OpenAI كما في إنشاء مفتاح. وسمّه باسم سير العمل، مثل n8n-support، ليسهل عليك أن تجد استخدامه.

2. 2

   أنشئ بيانات اعتماد OpenAI#

   في عقدة OpenAI Chat Model، أنشئ بيانات اعتماد جديدة من نوع OpenAI. الصق مفتاحك في الحقل API Key، واترك الحقل Organization ID (optional) فارغًا، وضع في الحقل Base URL العنوان https://api.5abeer.ai/v1. وعند الحفظ، يختبر n8n بيانات الاعتماد بطلب قائمة النماذج من هذا العنوان.

3. 3

   حدد النموذج بمعرّفه#

   في الحقل Model، بدّل من From List إلى ID، والصق معرّف نموذج من الجدول أعلاه كما هو مكتوب. والقائمة الكاملة في صفحة النماذج.

4. 4

   راجع خيارين#

   أبقِ الخيار Use Responses API مفعّلًا كما هو افتراضيًا، لأن 5abeer تقدّم نماذج GPT بصيغة Responses. واترك الحقل Built-in Tools فارغًا، لأن أدواته Web Search وFile Search وCode Interpreter تعمل على منصة OpenAI نفسها، وأعطِ الوكيل عقد أدوات بدلًا منها.

كيف تربط نماذج Claude؟#

وهذه أحدث نماذج Claude، بسعرنا لكل مليون توكن:

1. 1

   أنشئ مفتاحًا لنماذج Claude#

   أنشئ مفتاحًا ثانيًا، هذه المرة لمزوّد Anthropic. ويُخصم هذا المفتاح من الرصيد نفسه الذي يُخصم منه مفتاح GPT.

2. 2

   أنشئ بيانات اعتماد Anthropic#

   في عقدة Anthropic Chat Model، أنشئ بيانات اعتماد جديدة من نوع Anthropic. الصق مفتاح Claude في الحقل API Key، وضع في الحقل Base URL العنوان https://api.5abeer.ai. فإذا انتهى العنوان بـ /v1 تكرر المسار وفشلت كل الطلبات.

3. 3

   حدد النموذج بمعرّفه#

   في الحقل Model، بدّل إلى ID، والصق claude-sonnet-5.5، وهو النموذج الافتراضي، لأغلب مسارات العمل. واستخدم claude-opus-5.5 أو claude-fable-5.1 للخطوات الأصعب.

4. 4

   اترك الخيارات فارغة في أول تشغيل#

   لا تُضف أي خيار قبل أن يصلك رد على أول رسالة تجريبية، فالقسم التالي يشرحها.

أي خيارات العقد تهمّك على 5abeer؟#

هذه العناصر في قائمة Options في كل عقدة تغيّر ما تحصل عليه أو ما تدفعه على 5abeer:

ولا تضبط Thinking Mode على Disabled أبدًا مع claude-fable-5.1، لأن دليل الانتقال من Anthropic، الذي راجعناه في 2026-11-03، يذكر أن هذا النموذج يفكّر دائمًا ويرفض أي طلب يوقف التفكير. والتفكير يضيف توكنات إخراج، فإذا رفعت Effort، جرّب تشغيلًا واحدًا واقرأ استهلاكه.

كيف تضيف ذاكرة وأدوات ونموذجًا احتياطيًا؟#

• الذاكرة: اربط عقدة Simple Memory بالموصّل Memory في الوكيل. ويحدد الإعداد Context Window Length، وقيمته الافتراضية 5، عدد التبادلات السابقة التي تُرسل مع كل طلب، وكلٌّ منها يُحسب من جديد ضمن الإدخال.
• الأدوات: اربط عقد الأدوات، مثل HTTP Request Tool أو Call n8n Sub-Workflow Tool، بالموصّل Tool، فيستدعيها الوكيل عند الحاجة. وتقبل نماذج Claude ونماذج GPT الأدوات كلاهما، كما في ما تدعمه كل عائلة.
• النموذج الاحتياطي: فعّل الخيار Enable Fallback Model في الوكيل، واربط بالموصّل الجديد Fallback Model نموذج محادثة من المزوّد الآخر، مثل نموذج GPT خلف نموذج Claude. ويلجأ إليه الوكيل إذا فشل النموذج الرئيسي.

وإذا أردت طلبًا واحدًا لكل عنصر، مثل تصنيف الصفوف، فاستخدم Basic LLM Chain مع نموذج المحادثة نفسه.

كم يكلّف وكيل n8n؟#

تدفع بالتوكن من رصيدك. والإدخال هو الذي ينمو أسرع في الوكيل، لأن كل طلب يحمل رسالة النظام والرسائل المحفوظة وتعريفات الأدوات والرسالة الجديدة، وقد تحتاج جولة واحدة من المحادثة إلى عدة طلبات حين يستخدم الوكيل أدواته.

مثلًا، وكيل دعم يرسل عشرة ملايين توكن في الشهر ويتلقى مليون توكن، على النموذج الافتراضي:

ولكي تخفض الفاتورة:

• اجعل رسالة النظام قصيرة، ولا تربط إلا الأدوات التي يحتاج إليها الوكيل، وأبقِ Context Window Length صغيرًا.
• استخدم نموذجًا أرخص للخطوات البسيطة.
• أعطِ كل سير عمل مفتاحه الخاص، وتابع استخدامه كما في تتبّع استخدامك.

وفي التخزين المؤقت ودليل خفّض فاتورة LLM API طرق أخرى لتقليل الإنفاق. والسعر الرسمي لكل نموذج بجوار سعرنا في صفحة Claude API وصفحة OpenAI API.

ما الأخطاء الشائعة وكيف تحلها؟#

إذا فشل اختبار بيانات الاعتماد عند الحفظ، فراجع العنوان الأساسي أولًا (/v1 لصيغة OpenAI، ودونها لصيغة Anthropic)، ثم المفتاح. وفي أثناء التشغيل:

• INVALID_API_KEY: المفتاح غير صحيح أو ناقص. الصقه من جديد.
• MODEL_PLATFORM_NOT_ALLOWED: المفتاح لمزوّد آخر، مثل مفتاح GPT في بيانات اعتماد Anthropic.
• The model "…" was not found at …: تعرض عقدة Anthropic هذه الرسالة حين يردّ العنوان بأن النموذج غير موجود. الصق المعرّف كما هو من صفحة النماذج.
• does not support disabling thinking: الخيار Thinking Mode مضبوط على Disabled مع نموذج يفكّر دائمًا. احذف الخيار أو اختر Adaptive (Recommended).
• INSUFFICIENT_BALANCE: الرصيد لا يكفي لهذا الطلب. اشحن رصيدك ثم أعد المحاولة.
• API_KEY_QUOTA_EXHAUSTED: وصل المفتاح إلى حد الإنفاق الذي حددته له.

وكل الرموز ومعانيها في الأخطاء وحلولها.

أسئلة شائعة#

هل يعمل هذا على n8n السحابي وعلى النسخة المستضافة على خادمي؟#

نعم، فبيانات الاعتماد والعقد واحدة في النسختين. وإذا استضفت n8n على خادم له عنوان IP ثابت، فيمكنك أيضًا إضافة هذا العنوان إلى قائمة العناوين المسموح بها للمفتاح، كما في تحكّم في كل مفتاح.

هل أستطيع استخدام نماذج Gemini في n8n؟#

نعم، عبر عقدة OpenAI Chat Model. استخدم مفتاحًا لنماذج Gemini في بيانات اعتماد من نوع OpenAI مع عنوان صيغة OpenAI الخاص بنا، وحدد النموذج بمعرّفه، وأوقف الخيار Use Responses API، لأن صيغة Responses لدينا تقدّم نماذج Claude وGPT فقط. ومعرّفات نماذج Gemini وأسعارها في صفحة Gemini API.

بأي نموذج يبدأ وكيل n8n؟#

النموذج الافتراضي claude-sonnet-5.5 يكفي لأغلب عمل الوكيل. ولا تنقل خطوة إلى claude-opus-5.5 إلا إذا أظهرت تجاربك أن النموذج الافتراضي يخطئ فيها.

كيف أمنع سير عمل واحدًا من الإنفاق الزائد؟#

أنشئ لسير العمل مفتاحًا خاصًا به، وحدد له حد إنفاق وتاريخ انتهاء كما في تحكّم في كل مفتاح. وعندما يصل إلى الحد، تعيد طلباته الخطأ API_KEY_QUOTA_EXHAUSTED، وتبقى مفاتيحك الأخرى تعمل.

من يحاسبني على طلبات النماذج، n8n أم 5abeer؟#

مع مفتاح من 5abeer، يُحسب كل طلب للنموذج بالتوكن من رصيدك في 5abeer، وتشحن هذا الرصيد بأي طريقة من طرق الدفع. أما تشغيل n8n نفسه، على n8n السحابي أو على خادمك، فتكلفته منفصلة.

هل 5abeer جزء من n8n أو OpenAI أو Anthropic؟#

لا. خبير خدمة مستقلة، ولا تتبع OpenAI أو Anthropic أو Google، وليست جزءًا من n8n. وتعمل في n8n لأن واجهتنا البرمجية تقبل الصيغ التي ترسلها هذه العقد.

ابدأ#

اشحن رصيدك، وأنشئ مفتاحًا لكل مزوّد، ثم الصقه في بيانات الاعتماد في n8n. وكل النماذج وأسعارها في صفحة الـ API.