BroadRouter
ابدأ الآن

ربط Open WebUI بـ BroadNet Inference

آخر تحديث

في 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.

الإعداد

  1. احصل على مفتاح BroadNet. لواجهة محادثة يستخدمها عدة أشخاص، مفتاح الدفع حسب الاستخدام هو الخيار المناسب. راجع مفاتيح API وقوائم IP المسموح بها.

  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، يمكنك ضبط الاتصال عند بدء التشغيل:

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

أسئلة شائعة

لماذا يفشل 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 المشتركة.

اقرأها بصيغة Markdownاسأل ChatGPTاسأل Claudeاسأل Perplexity