---
title: "إعداد نقطة نهاية مخصّصة متوافقة مع OpenAI في Open WebUI"
description: "أضف BroadNet Inference إلى Open WebUI كاتصال متوافق مع OpenAI، وأدرج معرّفات النماذج في القائمة المسموح بها، وعالج مشكلات التحقق والردود الفارغة وحد المعدل."
url: https://broadrouter.com/ar/guides/open-webui-openai-api/
lang: ar
updated: 2026-11-16
publisher: BroadRouter (a BroadNet site); API by BroadNet Inference, https://inference.broadnet.ai
---

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

# ربط Open WebUI بـ BroadNet Inference

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

في Open WebUI، انتقل إلى Settings > Connections في قسم الإدارة، وانقر Add Connection تحت Manage OpenAI API Connections، واضبط URL على https://inference.broadnet.ai/v1 وAPI Key على مفتاح BroadNet، ثم أضف معرّفات نماذج مثل broadnet/glm-5.3 إلى القائمة المسموح بها Model IDs واحفظ.

Open WebUI واجهة محادثة تستضيفها بنفسك. وهي تتصل بأي مزوّد يطبّق بروتوكول chat completions من OpenAI، وBroadNet Inference تطبّقه. تتبع الخطوات [دليل Open WebUI للمزوّدين المتوافقين مع OpenAI](https://docs.openwebui.com/getting-started/quick-start/connect-a-provider/starting-with-openai-compatible).

## الإعداد

1.  **احصل على مفتاح BroadNet.** لواجهة محادثة يستخدمها عدة أشخاص، مفتاح الدفع حسب الاستخدام هو الخيار المناسب. راجع [مفاتيح API وقوائم IP المسموح بها](https://broadrouter.com/ar/guides/api-keys-ip-allow-lists/).
    
2.  **افتح صفحة الاتصالات.** انتقل إلى **Settings > Connections** في قسم الإدارة وابحث عن **Manage OpenAI API Connections**.
    
3.  **انقر Add Connection** واملأ الحقول:
    
    | الحقل | القيمة |
    | --- | --- |
    | URL | `https://inference.broadnet.ai/v1` (دون شرطة مائلة في النهاية) |
    | API Key | مفتاح BroadNet الخاص بك |
    | Model IDs | أضف كل معرّف أدناه، واحدًا تلو الآخر، بالأيقونة **+** |
    
4.  **أضف معرّفات النماذج يدويًا.** اكتب `broadnet/glm-5.3`، وانقر **+**، ثم كرّر ذلك لبقية النماذج التي تريدها. يصف توثيق BroadNet المسار `GET /v1/models` بأنه بيانات وصفية عامة للكتالوج مخصّصة لأدوات المراقبة، فلا تعتمد عليه لملء قائمة اختيار النماذج.
    
5.  **انقر Save.** ينبّه توثيق Open WebUI إلى أن الحفظ لا يختبر الاتصال.
    
6.  **ابدأ محادثة** واختر النموذج من قائمة النماذج.
    

### باستخدام متغيّرات البيئة

إن كنت تشغّل Open WebUI في Docker، يمكنك ضبط الاتصال عند بدء التشغيل:

```bash
OPENAI_API_BASE_URL=https://inference.broadnet.ai/v1
OPENAI_API_KEY=your-broadnet-key
```

ولإضافة BroadNet إلى جانب اتصال OpenAI موجود، استخدم صيغ الجمع مفصولة بفواصل منقوطة: `OPENAI_API_BASE_URLS` و`OPENAI_API_KEYS`. ويضبط `OPENAI_API_CONFIGS` خيارات كل اتصال، مثل `model_ids`، بحسب ترتيب الاتصال في تلك القائمة:

```bash
OPENAI_API_CONFIGS='{"0": {"enable": true, "model_ids": ["broadnet/glm-5.3", "broadnet/qwen3.8-27b"]}}'
```

يصنّف [مرجع متغيّرات البيئة في Open WebUI](https://docs.openwebui.com/reference/env-configuration) هذه المتغيّرات إعداداتٍ من نوع ConfigVar، أي أنها تُقرأ عند التشغيل الأول وتُحفظ في قاعدة البيانات، وبعد ذلك تكون الكلمة للوحة الإدارة. عدّل الاتصال من **Settings > Connections** في قسم الإدارة، أو اضبط `ENABLE_PERSISTENT_CONFIG=False` إن أردت أن تُطبَّق البيئة عند كل تشغيل.

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

| الاستخدام | النموذج | السياق |
| --- | --- | --- |
| المحادثة العامة، والأدوات، وJSON | `broadnet/glm-5.3` | 1,048,576 |
| الأسئلة عن الصور، والعربية | `broadnet/qwen3.8-27b` | 262,144 |
| المستندات الطويلة، والصور | `broadnet/deepseek-v4.1-flash` | 1,048,576 |
| تكلفة منخفضة، والرصيد المجاني | `broadnet/gemma-4-26b-a4b` | 32,768 |

اختبرت BroadNet نموذج Qwen3.8 27B بالعربية، بما في ذلك اللهجتان الخليجية والمصرية؛ راجع [اختيار نموذج LLM للعربية](https://broadrouter.com/ar/blog/choosing-an-llm-for-arabic/). ونموذج Gemma 4 VL 26B هو نموذج المحادثة الوحيد الذي يعمل بالرصيد المبدئي البالغ $5؛ ويغطي الرصيد أيضًا نموذجَي Transcribe. وأسعار كل نموذج في [صفحة الأسعار](https://broadrouter.com/ar/pricing/).

يمرّر Open WebUI المعاملات القياسية مثل `temperature` و`max_tokens`، ويدعم استخدام الأدوات حين يدعم النموذج والخادم `tools`. وتُدرج BroadNet الأدوات لنموذجَي GLM 5.3 وQwen3.8 27B.

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

-   **يفشل Verify Connection بالخطأ 400 أو 401 أو 403.** يستدعي زر التحقق في Open WebUI المسار `/models`، ويقول توثيقه إن chat completions قد تعمل مع ذلك. أضف المعرّفات إلى القائمة المسموح بها وجرّب محادثة. وإن أرجعت المحادثة أيضًا 401، فالمفتاح خاطئ أو منتهي الصلاحية أو استنفد رصيد الدفع حسب الاستخدام.
-   **النموذج ظاهر في القائمة لكن الرسالة الأولى تفشل.** تأكّد أن المعرّف يطابق معرّف BroadNet تمامًا، مع البادئة `broadnet/`. تحتاج نماذج GLM 5.3 وQwen3.8 27B وDeepSeek V4.1 Flash إلى شحن الرصيد.
-   **ردود فارغة.** تنفق نماذج الاستدلال المنطقي (DeepSeek V4.1 Flash وGLM 5.3 وQwen3.8 27B) رموز المخرجات على الاستدلال أولًا. فإن ضبطت **max\_tokens** في **Advanced Params** للنموذج، فارفعه أو امسحه. راجع [لماذا تعود الإجابات فارغة](https://broadrouter.com/ar/guides/reasoning-tokens-empty-response/).
-   **الخطأ 429 حين يتحادث عدة أشخاص.** يسمح مفتاح الدفع حسب الاستخدام بـ 30 من الطلبات في الدقيقة و4 في آنٍ واحد. ويُجري Open WebUI أيضًا استدعاءات في الخلفية، مثل توليد عناوين المحادثات، على المفتاح نفسه. راجع [الأخطاء وإعادة المحاولة](https://broadrouter.com/ar/guides/errors-and-retries/).
-   **تغيير متغيّرات البيئة لا يغيّر شيئًا.** حفظ التشغيل الأول القيم القديمة. عدّل الاتصال من لوحة الإدارة، أو راجع قسم متغيّرات البيئة أعلاه.
-   **استخدام مفتاح خطة.** [جلسة الخطة غير المحدودة](https://broadrouter.com/ar/guides/unlimited-llm-api-sessions/) تشغّل طلبًا واحدًا في كل مرة، ولا يمكن مشاركة المفاتيح. فهي تناسب نسخة يستخدمها شخص واحد؛ وتنتظر طلبات المستخدمين الإضافيين في طابور.

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

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

الدفع حسب الاستخدام هو نموذج تسعير تدفع فيه مقابل ما تستخدمه فقط، مقيسًا بوحدات مثل الرموز (التوكنات) أو الطلبات أو دقائق الصوت، دون اشتراك أو حد أدنى للالتزام. وتحتسب معظم واجهات LLM 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. ويشغّل التطبيق الدالة ويعيد النتيجة؛ فالنموذج لا يشغّل الشيفرة بنفسه أبدًا.

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

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

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

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

[الرصيد المدفوع مسبقًا (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، إلى أن يعود الاستخدام تحت الحد.

[مفتاح API (API key)](https://broadrouter.com/ar/glossary/api-key/)

مفتاح API هو سلسلة نصية سرية تعرّف العميل الذي يستدعي الواجهة وتخوّله. تتوقعه واجهات LLM API عادةً في الترويسة Authorization: Bearer، وكل من يملك المفتاح يستطيع إرسال طلبات تُحتسب تكلفتها على الحساب المالك له.

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

### لماذا يفشل Verify Connection بينما تعمل المحادثة؟

يستدعي زر التحقق في Open WebUI نقطة النهاية /models لدى المزوّد، ويقول توثيقه إن فشل الفحص لا يعني أن المحادثة معطّلة. أضف معرّفات نماذج BroadNet يدويًا إلى القائمة المسموح بها Model IDs.

### هل يمكن ضبط الاتصال بمتغيّرات البيئة؟

نعم. اضبط OPENAI\_API\_BASE\_URL على https://inference.broadnet.ai/v1 وOPENAI\_API\_KEY على مفتاح BroadNet. يحفظ Open WebUI هذه القيم عند التشغيل الأول، فتُتجاهَل أي تغييرات لاحقة على المتغيّرات ما لم تكن ENABLE\_PERSISTENT\_CONFIG مضبوطة على False.

### لماذا لم تُطبَّق القيمة الجديدة لـ OPENAI\_API\_BASE\_URL؟

يعامل Open WebUI هذا المتغيّر بوصفه ConfigVar، فبعد التشغيل الأول يستخدم القيمة المحفوظة في قاعدة بياناته. غيّر العنوان من Settings > Connections في قسم الإدارة، أو اضبط ENABLE\_PERSISTENT\_CONFIG=False ليقرأ البيئة عند كل تشغيل.

### هل يمكن لفريقي كله مشاركة مفتاح خطة غير محدودة واحد في Open WebUI؟

لا. خطط BroadNet لا تسمح بمشاركة المفتاح، وجلسة الخطة الواحدة تشغّل طلبًا واحدًا في كل مرة. استخدم مفتاح دفع حسب الاستخدام لنسخة Open WebUI المشتركة.

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

-   [إضافة BroadNet Inference إلى LibreChat كنقطة نهاية مخصّصة](https://broadrouter.com/ar/guides/librechat-custom-endpoint/)
-   [لماذا يعيد نموذج الاستدلال إجابة فارغة؟](https://broadrouter.com/ar/guides/reasoning-tokens-empty-response/)
-   [كيف تعمل خطط LLM API غير المحدودة مع الوكلاء](https://broadrouter.com/ar/guides/unlimited-llm-api-sessions/)
-   [رموز أخطاء 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-open-webui-openai-api&utm_content=page-cta) ·

**المصادر**

-   [توثيق Open WebUI، المزوّدون المتوافقون مع OpenAI (رُوجع في 2026-11-16)](https://docs.openwebui.com/getting-started/quick-start/connect-a-provider/starting-with-openai-compatible)
-   [توثيق Open WebUI، إعداد متغيّرات البيئة (رُوجع في 2026-11-14)](https://docs.openwebui.com/reference/env-configuration)
-   [المرجع التقني لـ BroadNet Inference API (بالإنجليزية)](https://inference.broadnet.ai/docs?utm_source=broadrouter&utm_medium=referral&utm_campaign=ar-guides-open-webui-openai-api&utm_content=sources)
