---
title: "إعداد مزوّد OpenAI-API-compatible في Dify (عنوان الأساس)"
description: "اربط Dify بـ BroadNet Inference عبر إضافة مزوّد النماذج OpenAI-API-compatible، مع قيم الحقول الدقيقة وأحجام السياق وإعدادات استدعاء الدوال."
url: https://broadrouter.com/ar/guides/dify-openai-api-compatible/
lang: ar
updated: 2026-11-16
publisher: BroadRouter (a BroadNet site); API by BroadNet Inference, https://inference.broadnet.ai
---

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

# إضافة BroadNet Inference إلى Dify عبر إضافة OpenAI-API-compatible

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

في Dify، ثبّت إضافة OpenAI-API-compatible من Integrations ثم Model Provider، وانقر Add Model. اختر النوع LLM، وأدخل معرّف نموذج من BroadNet مثل broadnet/glm-5.3، ومفتاح BroadNet، وAPI Base URL بقيمة https://inference.broadnet.ai/v1. اضبط Completion mode على Chat، وحجم السياق الحقيقي، وحدًا للمخرجات يترك مساحة للاستدلال، وTool Call فقط مع GLM 5.3 أو Qwen3.8 27B.

Dify منصة مفتوحة المصدر لبناء تطبيقات النماذج اللغوية الكبيرة وسير العمل. والمزوّدون الذين لا يذكرهم Dify بالاسم يُضافون عبر إضافة مزوّد النماذج **OpenAI-API-compatible**، التي ينشرها فريق Dify (langgenius). وBroadNet Inference تخدم chat completions القياسية على `https://inference.broadnet.ai/v1`، فهي مناسبة. BroadRouter هو موقع BroadNet نفسها؛ وأسماء الحقول أدناه مأخوذة من الإصدار 0.0.83 من الإضافة.

## الإعداد

1.  **احصل على مفتاح.** أنشئ مفتاح دفع حسب الاستخدام في لوحة تحكم BroadNet.
    
2.  **ثبّت الإضافة.** في Dify، انتقل إلى **Integrations** > **Model Provider**، وابحث عن **OpenAI-API-compatible** ضمن المزوّدين القابلين للتثبيت (أو افتحها في [Marketplace](https://marketplace.dify.ai/plugin/langgenius/openai_api_compatible))، ثم ثبّتها. يجب أن تكون مالكًا لمساحة العمل أو مسؤولًا فيها.
    
3.  **أضف نموذجًا.** انقر **Add Model** على بطاقة المزوّد واملأ:
    
    | الحقل | القيمة |
    | --- | --- |
    | Model Type | LLM |
    | Model Name | `broadnet/glm-5.3` |
    | Model display name | GLM 5.3 (BroadNet) |
    | API Key | مفتاح BroadNet الخاص بك |
    | API Base URL | `https://inference.broadnet.ai/v1` |
    | Completion mode | Chat |
    | Model context size | `1048576` |
    | Upper bound for max tokens | `16000` |
    | Function Call Type | Tool Call |
    | Vision Support | Not Support |
    | Structured Output | Support |
    | API Type | Chat Completions API (/chat/completions) |
    | Token parameter name | Use max\_tokens |
    
4.  **احفظ.** يتحقق Dify من بيانات الاعتماد قبل إضافة النموذج.
    
5.  **اختبر الإعداد.** أنشئ تطبيق Chatbot، واختر **GLM 5.3 (BroadNet)** من محدد النماذج، وأرسل رسالة في لوحة المعاينة.
    

كرّر **Add Model** لكل نموذج من BroadNet تريده. يجب أن يطابق اسم النموذج معرّف BroadNet تمامًا، بما في ذلك البادئة `broadnet/`.

## القيم لكل نموذج

| Model Name | حجم السياق | Function Call Type | Vision Support |
| --- | --- | --- | --- |
| `broadnet/glm-5.3` | 1048576 | Tool Call | Not Support |
| `broadnet/qwen3.8-27b` | 262144 | Tool Call | Support |
| `broadnet/deepseek-v4.1-flash` | 1048576 | Not Support (لم يُختبر) | Support |
| `broadnet/gemma-4-26b-a4b` | 32768 | Not Support | Support |

لماذا هذه الخيارات:

-   **حجم السياق** قيمته الافتراضية في الإضافة 4,096. وإن تركته كذلك، يقتطع Dify الذاكرة والسياق المسترجع إلى ما دون ما يقبله النموذج بكثير.
-   **Upper bound for max tokens** قيمته الافتراضية أيضًا 4,096. ثلاثة من النماذج تستدل قبل أن تجيب، والاستدلال المنطقي يُحتسب ضمن هذا الحد، فامنحها مساحة. القيمة 16,000 اقتراح منا، لا حدّ من BroadNet.
-   **Token parameter name** المضبوط على `max_tokens` يطابق الحقل في المرجع التقني لـ BroadNet API. أما السلوك الافتراضي للإضافة فهو التخمين من اسم النموذج.
-   **API Type** يبقى على Chat Completions. فـ BroadNet لا تُدرج Responses API.

## تحويل الكلام إلى نص

يمكن للإضافة أيضًا إضافة نماذج تحويل الكلام إلى نص. تخدم BroadNet المسار `/v1/audio/transcriptions` مع `broadnet/cohere-transcribe-arabic` للعربية و`broadnet/cohere-transcribe` لـ 14 لغة. ويقول ملف README الخاص بالإضافة إنها تضيف مسار الإصدار بنفسها لتحويل الكلام إلى نص، لذا يستخدم مثالها المضيف دون `/v1` (هنا `https://inference.broadnet.ai`). لم نختبر هذا المسار عبر Dify؛ فجرّبه أولًا بملف WAV قصير. راجع [دليل تحويل الكلام العربي إلى نص](https://broadrouter.com/ar/guides/arabic-speech-to-text-api/).

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

-   **فشل التحقق من بيانات الاعتماد.** تحقّق من المفتاح، ومن API Base URL (ينتهي بـ `/v1` لنماذج LLM)، ومن اسم النموذج. النماذج المدفوعة تحتاج إلى شحن الرصيد؛ والرصيد البالغ $5 يغطي `broadnet/gemma-4-26b-a4b` ونموذجَي Transcribe.
-   **ردود فارغة في سير العمل.** قيمة max tokens في عقدة LLM منخفضة جدًا لنموذج استدلال. ارفعها. راجع [لماذا تعود الإجابات فارغة](https://broadrouter.com/ar/guides/reasoning-tokens-empty-response/).
-   **عقدة Agent لا تستدعي الأدوات أبدًا.** استخدم GLM 5.3 أو Qwen3.8 27B مع ضبط Function Call Type على Tool Call.
-   **429 تحت الضغط.** يسمح مفتاح الدفع حسب الاستخدام بـ 30 من الطلبات في الدقيقة و4 قيد التنفيذ. وقد تتجاوز الفروع المتوازية وعقد التكرار ذلك؛ فخفّض درجة توازيها. راجع [الأخطاء وإعادة المحاولة](https://broadrouter.com/ar/guides/errors-and-retries/).

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

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

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

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

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

[Chat Completions API (واجهة إكمال المحادثة)](https://broadrouter.com/ar/glossary/chat-completions-api/)

Chat Completions API هي نقطة نهاية HTTP لدى OpenAI، أي POST /v1/chat/completions، تستقبل اسم نموذج وقائمة رسائل موسومة بأدوارها وتُرجع الرسالة التالية من النموذج. وصارت بنية طلبها واستجابتها الصيغة المشتركة التي يعيد استخدامها المزوّدون المتوافقون مع OpenAI وحزم SDK.

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

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

[نافذة السياق (Context window)](https://broadrouter.com/ar/glossary/context-window/)

نافذة السياق هي الحد الأقصى لعدد الرموز (التوكنات) التي يستطيع نموذج اللغة التعامل معها في طلب واحد. وتشمل الأمر (prompt) وسجل المحادثة وتعريفات الأدوات والصور والمخرجات المولَّدة، بما فيها رموز الاستدلال المنطقي. وكل ما لا يتسع لها يجب قصّه أو تلخيصه أو توزيعه على عدة طلبات.

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

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

[المخرجات المنظَّمة (Structured output)](https://broadrouter.com/ar/glossary/structured-output/)

المخرجات المنظَّمة هي ميزة في LLM API تقيّد رد النموذج بصيغة يحدّدها المطوّر، عادةً JSON Schema، لكي تحلّلها الشيفرة بموثوقية. وهي أكثر صرامة من وضع JSON (JSON mode)، الذي يضمن JSON صالحًا لكن لا يضمن بنية معيّنة.

[تحويل الصوت إلى نص (Speech-to-text)](https://broadrouter.com/ar/glossary/speech-to-text/)

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

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

### هل تعمل BroadNet على Dify Cloud وكذلك على Dify المستضاف ذاتيًا؟

نعم. BroadNet Inference نقطة نهاية HTTPS عامة، فيستطيع Dify Cloud الوصول إليها. ويقول توثيق Dify إن مالكي مساحة العمل ومسؤوليها وحدهم يستطيعون إدارة مزوّدي النماذج، وإن المفتاح الذي تضيفه يعمل في مساحة العمل كلها.

### هل يجب أن يتضمن API Base URL المقطع /v1؟

نعم، لنماذج LLM. تستخدم أمثلة الإضافة نفسها عنوان أساس ينتهي بـ /v1 لنماذج المحادثة، ويحذّر ملف README الخاص بها من أنها تضيف مسار الإصدار بنفسها لبعض أنواع النماذج الأخرى.

### أي Function Call Type أختار؟

Tool Call لنموذجَي GLM 5.3 وQwen3.8 27B، اللذين تُدرجهما BroadNet مع الأدوات. واختر Not Support لنموذج DeepSeek V4.1 Flash ما لم تختبر استدعاءات الأدوات عليه بنفسك.

### هل تنطبق أرصدة الذكاء الاصطناعي في Dify على نماذج BroadNet؟

لا. يقول توثيق Dify إن أرصدة الذكاء الاصطناعي (AI credits) لا تنطبق على المزوّدين الذين تشغّلهم بحسابك الخاص. وBroadNet تحاسب على المفتاح الذي تدخله.

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

-   [استخدام BroadNet Inference في n8n (بيانات اعتماد OpenAI وBase URL)](https://broadrouter.com/ar/guides/n8n-openai-compatible/)
-   [ربط Open WebUI بـ BroadNet Inference](https://broadrouter.com/ar/guides/open-webui-openai-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-dify-openai-api-compatible&utm_content=page-cta) ·

**المصادر**

-   [توثيق Dify، مزوّدو النماذج (رُوجع في 2026-11-15)](https://docs.dify.ai/en/cloud/use-dify/workspace/model-providers)
-   [متجر Dify Marketplace، إضافة OpenAI-API-compatible من langgenius، الإصدار 0.0.83 (رُوجع في 2026-11-15)](https://marketplace.dify.ai/plugin/langgenius/openai_api_compatible)
-   [الشيفرة المصدرية للإضافة، حقول مزوّد openai\_api\_compatible (رُوجع في 2026-11-15)](https://github.com/langgenius/dify-official-plugins/tree/main/models/openai_api_compatible)
-   [المرجع التقني لـ BroadNet Inference API (رُوجع في 2026-11-15) (بالإنجليزية)](https://inference.broadnet.ai/docs?utm_source=broadrouter&utm_medium=referral&utm_campaign=ar-guides-dify-openai-api-compatible&utm_content=sources)
