Open WebUI واجهة محادثة تستضيفها بنفسك. وهي تتصل بأي مزوّد يطبّق بروتوكول chat completions من OpenAI، وBroadNet Inference تطبّقه. تتبع الخطوات دليل Open WebUI للمزوّدين المتوافقين مع OpenAI.
الإعداد
-
احصل على مفتاح BroadNet. لواجهة محادثة يستخدمها عدة أشخاص، مفتاح الدفع حسب الاستخدام هو الخيار المناسب. راجع مفاتيح API وقوائم IP المسموح بها.
-
افتح صفحة الاتصالات. انتقل إلى Settings > Connections في قسم الإدارة وابحث عن Manage OpenAI API Connections.
-
انقر Add Connection واملأ الحقول:
الحقل القيمة URL https://inference.broadnet.ai/v1(دون شرطة مائلة في النهاية)API Key مفتاح BroadNet الخاص بك Model IDs أضف كل معرّف أدناه، واحدًا تلو الآخر، بالأيقونة + -
أضف معرّفات النماذج يدويًا. اكتب
broadnet/glm-5.3، وانقر +، ثم كرّر ذلك لبقية النماذج التي تريدها. يصف توثيق BroadNet المسارGET /v1/modelsبأنه بيانات وصفية عامة للكتالوج مخصّصة لأدوات المراقبة، فلا تعتمد عليه لملء قائمة اختيار النماذج. -
انقر Save. ينبّه توثيق Open WebUI إلى أن الحفظ لا يختبر الاتصال.
-
ابدأ محادثة واختر النموذج من قائمة النماذج.
باستخدام متغيّرات البيئة
إن كنت تشغّل Open WebUI في Docker، يمكنك ضبط الاتصال عند بدء التشغيل:
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، بحسب ترتيب الاتصال في تلك القائمة:
OPENAI_API_CONFIGS='{"0": {"enable": true, "model_ids": ["broadnet/glm-5.3", "broadnet/qwen3.8-27b"]}}'
يصنّف مرجع متغيّرات البيئة في Open WebUI هذه المتغيّرات إعداداتٍ من نوع 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 للعربية. ونموذج Gemma 4 VL 26B هو نموذج المحادثة الوحيد الذي يعمل بالرصيد المبدئي البالغ $5؛ ويغطي الرصيد أيضًا نموذجَي Transcribe. وأسعار كل نموذج في صفحة الأسعار.
يمرّر 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 للنموذج، فارفعه أو امسحه. راجع لماذا تعود الإجابات فارغة.
- الخطأ 429 حين يتحادث عدة أشخاص. يسمح مفتاح الدفع حسب الاستخدام بـ 30 من الطلبات في الدقيقة و4 في آنٍ واحد. ويُجري Open WebUI أيضًا استدعاءات في الخلفية، مثل توليد عناوين المحادثات، على المفتاح نفسه. راجع الأخطاء وإعادة المحاولة.
- تغيير متغيّرات البيئة لا يغيّر شيئًا. حفظ التشغيل الأول القيم القديمة. عدّل الاتصال من لوحة الإدارة، أو راجع قسم متغيّرات البيئة أعلاه.
- استخدام مفتاح خطة. جلسة الخطة غير المحدودة تشغّل طلبًا واحدًا في كل مرة، ولا يمكن مشاركة المفاتيح. فهي تناسب نسخة يستخدمها شخص واحد؛ وتنتظر طلبات المستخدمين الإضافيين في طابور.
