---
title: "Base URL متوافق مع OpenAI في n8n مع OpenAI Chat Model"
description: "وجّه بيانات اعتماد OpenAI في n8n إلى BroadNet Inference عبر حقل Base URL، ثم استخدم عقدة OpenAI Chat Model بالمعرّف مع إيقاف خيار Responses API."
url: https://broadrouter.com/ar/guides/n8n-openai-compatible/
lang: ar
updated: 2026-11-16
publisher: BroadRouter (a BroadNet site); API by BroadNet Inference, https://inference.broadnet.ai
---

تُرجمت هذه الصفحة من الإنجليزية بمساعدة الذكاء الاصطناعي. [اقرأ الأصل الإنجليزي](https://broadrouter.com/guides/n8n-openai-compatible/) (حُدّث في 2026-11-16).

# استخدام BroadNet Inference في n8n (بيانات اعتماد OpenAI وBase URL)

آخر تحديث 2026-11-16

في n8n، أنشئ بيانات اعتماد OpenAI تضع فيها مفتاح BroadNet في API Key وتضبط Base URL على https://inference.broadnet.ai/v1. وفي عقدة OpenAI Chat Model، غيّر وضع Model من From List إلى ID، وأدخل معرّفًا من BroadNet مثل broadnet/glm-5.3، ثم أوقف Use Responses API ليستدعي n8n مسار chat completions.

n8n أداة لأتمتة سير العمل. وتحتوي بيانات اعتماد **OpenAI** فيها على حقل **Base URL**، لذا تستطيع عقدة **OpenAI Chat Model** (وعقد OpenAI الأخرى التي تستخدم بيانات الاعتماد هذه) استدعاء أي واجهة API متوافقة مع OpenAI، ومنها BroadNet Inference. لا تعرض صفحة توثيق n8n الخاصة ببيانات الاعتماد حقل Base URL، لذا راجعنا أسماء الحقول أدناه في الشيفرة المصدرية لـ n8n أيضًا، والروابط في المصادر.

## الإعداد

1.  **أنشئ بيانات الاعتماد.** في n8n، انتقل إلى **Credentials**، وأنشئ بيانات اعتماد جديدة من نوع **OpenAI**، واملأ الحقول:
    
    | الحقل | القيمة |
    | --- | --- |
    | API Key | مفتاح BroadNet الخاص بك |
    | Organization ID (اختياري) | اتركه فارغًا |
    | Base URL | `https://inference.broadnet.ai/v1` |
    
    احفظها. يختبر n8n بيانات الاعتماد باستدعاء `/models` على عنوان Base URL.
    
2.  **أضف عقدة النموذج.** أضف عقدة **AI Agent** أو **Basic LLM Chain**، ثم اربط بها عقدة فرعية **OpenAI Chat Model** واختر بيانات الاعتماد.
    
3.  **حدّد النموذج بالمعرّف.** في **Model**، غيّر الوضع من **From List** إلى **ID** وأدخل `broadnet/glm-5.3`.
    
4.  **أوقف Use Responses API.** في الشيفرة المصدرية لـ n8n، يوجد هذا الخيار بدءًا من إصدار العقدة 1.3 ويكون مفعّلًا افتراضيًا فيه. وبما أن BroadNet تقدّم chat completions، فأوقفه.
    
5.  **اضبط الخيارات.** تحت **Options**، اترك **Maximum Number of Tokens** على قيمته الافتراضية (-1) أو اضبطه على بضعة آلاف. القيمة الافتراضية لـ **Max Retries** هي 2؛ ارفعها إن أردت أن يعيد n8n محاولة الاستدعاءات الفاشلة أكثر.
    
6.  **شغّل سير العمل** مرة واحدة بأمر تجريبي.
    

يعرض n8n تنبيهًا حين تستخدم Base URL لا يتبع OpenAI، مفاده أن بعض النماذج قد لا تكون متوافقة مع المحادثة أو لا تدعم استدعاء الأدوات أو صيغة استجابة JSON. أما في BroadNet، فالمحادثة تعمل على كل نماذج المحادثة، لكن توثيق BroadNet يُدرج الأدوات والمخرجات المنظَّمة لنموذجَي GLM 5.3 وQwen3.8 27B فقط.

## أي نموذج تختار

| سير العمل | النموذج | السبب |
| --- | --- | --- |
| AI Agent مع أدوات | `broadnet/glm-5.3` | تُدرج BroadNet له الأدوات والمخرجات المنظَّمة |
| الصور، والرسائل العربية | `broadnet/qwen3.8-27b` | أدوات، وإدخال الصور، ومُختبَر بالعربية |
| التصنيف بأحجام كبيرة | `broadnet/gemma-4-26b-a4b` | سعر منخفض لكل رمز؛ لا يُدرج له استدلال منطقي |
| المستندات الطويلة | `broadnet/deepseek-v4.1-flash` | سياق مليون رمز؛ الأدوات غير مُدرجة |

قارن الأسعار في [صفحة الأسعار](https://broadrouter.com/ar/pricing/). وللصوت، تستطيع عقدة HTTP Request في n8n إرسال الملفات إلى `/v1/audio/transcriptions`؛ ويعرض [دليل تحويل الصوت العربي إلى نص](https://broadrouter.com/ar/guides/arabic-speech-to-text-api/) حقول النموذج التي ترسلها.

## حل المشكلات

-   **يفشل اختبار بيانات الاعتماد.** تأكّد أن Base URL ينتهي بـ `/v1` دون مسار بعده. وإن كانت استدعاءات المحادثة تُرجع 401 أيضًا، فالمفتاح خاطئ أو منتهي الصلاحية أو استنفد رصيد الدفع حسب الاستخدام.
-   **أخطاء النموذج.** استخدم وضع **ID** وأدخل معرّف BroadNet الدقيق مع البادئة `broadnet/`. تحتاج نماذج GLM 5.3 وQwen3.8 27B وDeepSeek V4.1 Flash إلى شحن الرصيد؛ أما الرصيد المبدئي البالغ $5 فيغطي BroadNet Gemma 4 VL 26B.
-   **“Bad request - please check your parameters”.** يقترح توثيق n8n تكرار الاستدعاء في عقدة HTTP Request لرؤية الخطأ كاملًا. والسبب الشائع هنا هو خيار Responses API.
-   **مخرجات فارغة.** يُحتسب الاستدلال المنطقي ضمن **Maximum Number of Tokens**. ارفع القيمة. راجع [لماذا تعود الإجابات فارغة](https://broadrouter.com/ar/guides/reasoning-tokens-empty-response/).
-   **الخطأ 429 في الحلقات.** يسمح مفتاح الدفع حسب الاستخدام بـ 30 من الطلبات في الدقيقة و4 في آنٍ واحد. ويقترح توثيق n8n استخدام **Loop Over Items** مع عقدة **Wait** لتنظيم وتيرة الدفعات. راجع [الأخطاء وإعادة المحاولة](https://broadrouter.com/ar/guides/errors-and-retries/).
-   **عمليات تنفيذ متوازية على مفتاح خطة.** [جلسة الخطة غير المحدودة](https://broadrouter.com/ar/guides/unlimited-llm-api-sessions/) تشغّل طلبًا واحدًا في كل مرة، فتنتظر عمليات تنفيذ سير العمل المتوازية في طابور ما لم تكن لكلٍّ منها جلستها الخاصة.

تفضّل الشيفرة؟ الإعدادات نفسها تعمل في [LangChain](https://broadrouter.com/ar/guides/langchain-openai-base-url/)، الذي بُنيت عليه عقد الذكاء الاصطناعي في n8n.

## مصطلحات في هذا الدليل

[العنوان الأساسي (Base URL)](https://broadrouter.com/ar/glossary/base-url/)

العنوان الأساسي (base URL) هو الجذر الثابت لعنوان الواجهة، مثل https://api.example.com/v1، الذي يضعه العميل قبل كل مسار نقطة نهاية، مثل /chat/completions. وفي حزم SDK المتوافقة مع OpenAI، يكفي تغيير العنوان الأساسي، مع مفتاح API ومعرّف النموذج، لتوجيه الشيفرة نفسها إلى مزوّد آخر.

[الرمز (التوكن، Token)](https://broadrouter.com/ar/glossary/token/)

الرمز (التوكن) هو وحدة النص التي يقرؤها نموذج اللغة ويكتبها: كلمة، أو جزء من كلمة، أو علامة ترقيم، أو تسلسل بايتات ينتجه مجزّئ النموذج (tokenizer). وتَعُدّ واجهات LLM API الاستهلاك بالرموز، وتضع حدودها بها، وتحتسب تكلفتها بها عادةً.

[استدعاء الأدوات (Tool calling)](https://broadrouter.com/ar/glossary/tool-calling/)

استدعاء الأدوات، ويُسمّى أيضًا استدعاء الدوال (function calling)، ميزة في واجهات LLM API يُرجع فيها النموذج طلبًا منظَّمًا لتشغيل دالة عرّفها المطوّر، مع معاملات بصيغة JSON. ويشغّل التطبيق الدالة ويعيد النتيجة؛ فالنموذج لا يشغّل الشيفرة بنفسه أبدًا.

[الدفع حسب الاستخدام (Pay-as-you-go)](https://broadrouter.com/ar/glossary/pay-as-you-go/)

الدفع حسب الاستخدام هو نموذج تسعير تدفع فيه مقابل ما تستخدمه فقط، مقيسًا بوحدات مثل الرموز (التوكنات) أو الطلبات أو دقائق الصوت، دون اشتراك أو حد أدنى للالتزام. وتحتسب معظم واجهات LLM API تكلفتها بهذه الطريقة، من رصيد مدفوع مسبقًا أو بفاتورة دورية.

[التزامن (Concurrency)](https://broadrouter.com/ar/glossary/concurrency/)

التزامن (concurrency) هو عدد الطلبات التي تكون لدى العميل قيد التنفيذ في الوقت نفسه. وكثيرًا ما تضع واجهات LLM API سقفًا له لكل مفتاح أو خطة، بمعزل عن عدد الطلبات في الدقيقة، لأن كل طلب مفتوح يشغل قدرة من وحدة GPU حتى تكتمل استجابته.

[وكيل الذكاء الاصطناعي (AI agent)](https://broadrouter.com/ar/glossary/agent/)

وكيل الذكاء الاصطناعي نظام يوجّه فيه النموذج اللغوي خطواته بنفسه نحو هدف: يقرر أي الأدوات يستدعي، ويقرأ النتائج، ويكرّر حتى يُنتج إجابة نهائية أو يبلغ حدًّا. أما البرنامج الثابت الذي يستدعي النموذج عند نقاط محددة فيُسمّى عادةً سير عمل (workflow).

[الرصيد المدفوع مسبقًا (Prepaid credit)](https://broadrouter.com/ar/glossary/prepaid-credit/)

الرصيد المدفوع مسبقًا هو مال يُضاف إلى حساب API قبل الاستخدام. يُخصم من الرصيد ثمن كل طلب، وعندما ينفد الرصيد تتوقف الطلبات المحتسبة بالاستهلاك حتى تشحن رصيدك. وهو يحصر الإنفاق في حدود ما دفعته.

[حد المعدل (Rate limit)](https://broadrouter.com/ar/glossary/rate-limit/)

حد المعدل هو سقف تفرضه واجهة API على مقدار استخدام العميل لها خلال فترة زمنية، مثل عدد الطلبات في الدقيقة أو الرموز في الدقيقة. وتُرفض الطلبات التي تتجاوزه، غالبًا بالخطأ HTTP 429 Too Many Requests، إلى أن يعود الاستخدام تحت الحد.

## أسئلة شائعة

### لماذا يفشل AI Agent في n8n مع BroadNet؟

تأكّد أن Use Responses API متوقف في عقدة OpenAI Chat Model. ففي إصدار العقدة 1.3 يكون مفعّلًا افتراضيًا، بينما تقدّم BroadNet المسار /v1/chat/completions لا Responses API. واضبط Model أيضًا على وضع ID مع معرّف BroadNet الدقيق.

### لماذا تظهر قائمة النماذج فارغة أو خاطئة؟

يقرأ وضع From List نقطة النهاية /models لدى المزوّد، ويصفها توثيق BroadNet بأنها بيانات وصفية عامة للكتالوج مخصّصة لأدوات المراقبة. غيّر Model إلى وضع ID واكتب معرّف نموذج BroadNet.

### لماذا يُرجع وكيل n8n مخرجات فارغة؟

استهلك الاستدلال المنطقي قيمة Maximum Number of Tokens كلها. ارفعها، أو اتركها على القيمة الافتراضية -1.

### أين حقل Base URL في بيانات اعتماد OpenAI في n8n؟

هو في بيانات اعتماد OpenAI نفسها، أسفل API Key وOrganization ID. قيمته الافتراضية https://api.openai.com/v1. ضع مكانها https://inference.broadnet.ai/v1، مع الإبقاء على /v1 ودون إضافة أي مسار بعدها.

## أدلة ذات صلة

-   [تفريغ الرسائل الصوتية من WhatsApp إلى نص في n8n](https://broadrouter.com/ar/guides/n8n-whatsapp-voice-note-transcription/)
-   [استخدام LangChain مع BroadNet Inference](https://broadrouter.com/ar/guides/langchain-openai-base-url/)
-   [API لتحويل الصوت العربي إلى نص خطوة بخطوة](https://broadrouter.com/ar/guides/arabic-speech-to-text-api/)
-   [لماذا يعيد نموذج الاستدلال إجابة فارغة؟](https://broadrouter.com/ar/guides/reasoning-tokens-empty-response/)
-   [رموز أخطاء BroadNet Inference ومتى تعيد المحاولة](https://broadrouter.com/ar/guides/errors-and-retries/)
-   [كل الأدوات التي تعمل مع BroadNet Inference (بالإنجليزية)](https://broadrouter.com/integrations/): حِزم SDK ووكلاء البرمجة وواجهات الدردشة وأدوات الأتمتة، مع الإعدادات الدقيقة لكل منها

جرّبه على مهامك الفعلية. تبدأ الحسابات الجديدة برصيد قدره $5 لاستخدام Gemma والتفريغ الصوتي. أما DeepSeek وGLM وQwen3.8 فتتطلب شحن الرصيد.

[ابدأ الآن](https://inference.broadnet.ai/account/?utm_source=broadrouter&utm_medium=referral&utm_campaign=ar-guides-n8n-openai-compatible&utm_content=page-cta) ·

**المصادر**

-   [توثيق n8n، عقدة OpenAI Chat Model (رُوجع في 2026-11-14)](https://docs.n8n.io/integrations/builtin/cluster-nodes/sub-nodes/n8n-nodes-langchain.lmchatopenai/)
-   [توثيق n8n، المشكلات الشائعة في OpenAI Chat Model (رُوجع في 2026-11-14)](https://docs.n8n.io/integrations/builtin/cluster-nodes/sub-nodes/n8n-nodes-langchain.lmchatopenai/common-issues/)
-   [توثيق n8n، بيانات اعتماد OpenAI (رُوجع في 2026-11-14)](https://docs.n8n.io/integrations/builtin/credentials/openai/)
-   [الشيفرة المصدرية لـ n8n، حقول بيانات اعتماد OpenAI (رُوجعت في 2026-11-14)](https://github.com/n8n-io/n8n/blob/master/packages/nodes-base/credentials/OpenAiApi.credentials.ts)
-   [الشيفرة المصدرية لـ n8n، عقدة OpenAI Chat Model (رُوجعت في 2026-11-14)](https://github.com/n8n-io/n8n/blob/master/packages/@n8n/nodes-langchain/nodes/llms/LMChatOpenAi/LmChatOpenAi.node.ts)
-   [المرجع التقني لـ BroadNet Inference API (بالإنجليزية)](https://inference.broadnet.ai/docs?utm_source=broadrouter&utm_medium=referral&utm_campaign=ar-guides-n8n-openai-compatible&utm_content=sources)
