BroadRouter
ابدأ الآن

إضافة BroadNet Inference إلى LibreChat كنقطة نهاية مخصّصة

آخر تحديث

في librechat.yaml، أضف عنصرًا تحت endpoints.custom باسم BroadNet، واضبط apiKey على مرجع متغير بيئة مثل BROADNET_API_KEY، وbaseURL على https://inference.broadnet.ai/v1، واذكر في models.default معرّفات BroadNet مثل broadnet/glm-5.3. ضع المفتاح في .env، واربط الملف بالحاوية إن كنت تستخدم Docker، ثم أعد تشغيل LibreChat. يضيف LibreChat المسار /chat/completions إلى العنوان الأساسي بنفسه.

LibreChat تطبيق محادثة مفتوح المصدر يدعم الخدمات المتوافقة مع OpenAI بوصفها نقاط نهاية مخصّصة (custom endpoints). تعرّفها في librechat.yaml، وتحفظ المفاتيح في .env، وعلى Docker تربط ملف YAML بالحاوية. BroadRouter هو موقع BroadNet نفسها؛ وتتبع الخطوات دليل LibreChat لنقاط النهاية المخصّصة.

الإعداد

  1. اربط librechat.yaml (على Docker فقط). انسخ docker-compose.override.yml.example إلى docker-compose.override.yml وتأكد من أن وحدة التخزين (volume) مفعّلة:
services:
  api:
    volumes:
      - type: bind
        source: ./librechat.yaml
        target: /app/librechat.yaml
  1. أضف نقطة النهاية إلى librechat.yaml في جذر المشروع، تحت endpoints.custom:
endpoints:
  custom:
    - name: 'BroadNet'
      apiKey: '${BROADNET_API_KEY}'
      baseURL: 'https://inference.broadnet.ai/v1'
      models:
        default:
          - 'broadnet/glm-5.3'
          - 'broadnet/qwen3.8-27b'
          - 'broadnet/deepseek-v4.1-flash'
          - 'broadnet/gemma-4-26b-a4b'
        fetch: false
      titleConvo: true
      titleModel: 'broadnet/gemma-4-26b-a4b'
      modelDisplayLabel: 'BroadNet'

احتفظ بأي مفاتيح على المستوى الأعلى موجودة في ملفك أصلًا، مثل version.

  1. اضبط المفتاح في .env:
BROADNET_API_KEY=your-broadnet-key
  1. أعد تشغيل LibreChat. مع Docker: docker compose down && docker compose up -d. وفي التثبيت المحلي، أعد التشغيل بـ npm run backend. بعدها تظهر BroadNet في قائمة اختيار نقاط النهاية.

ملاحظات على الحقول

  • baseURL. يضيف LibreChat المسار /chat/completions بنفسه، فاستخدم الجذر /v1 كما في الأعلى. ولا تضبط directEndpoint: true؛ فهذا الخيار مخصّص لـ baseURL يكون أصلًا عنوان completions الكامل.
  • fetch: false. هذه القيمة الافتراضية في LibreChat؛ ضبطناها لنجعل الاختيار واضحًا. يصف توثيق BroadNet المسار GET /v1/models بأنه بيانات وصفية عامة للكتالوج مخصّصة لأدوات المراقبة، لذا فإن ذكر النماذج في default أكثر قابلية للتنبؤ.
  • titleModel. يكتب LibreChat عنوانًا لكل محادثة بطلب إضافي. ونموذج صغير ورخيص بلا استدلال منطقي يجعل هذا الطلب قصيرًا. ولا يُدرج توثيق BroadNet الاستدلال المنطقي لنموذج Gemma 4 VL 26B.
  • user_provided. اضبط apiKey: 'user_provided' إذا أردت أن يُدخل كل مستخدم مفتاح BroadNet الخاص به في الواجهة. يخزّن LibreChat مفتاح كل مستخدم مشفّرًا ويطلبه في أول مرة يختار فيها نقطة النهاية.
  • اسم فريد. نقطة نهاية ثانية بالاسم نفسه، بغض النظر عن حالة الأحرف، تحل محل الأولى بصمت. إن كان لديك عنصر باسم BroadNet أصلًا، فغيّر اسم أحدهما.
  • لا مفاتيح حرفية. يوصي توثيق LibreChat بمرجع ${VAR} بدلًا من كتابة المفتاح في librechat.yaml، حيث سيبقى في الملف نصًا صريحًا.

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

الاستخدام النموذج
المحادثة الافتراضية، والأدوات، وJSON GLM 5.3
الصور والعربية Qwen3.8 27B
المستندات الطويلة، سياق 1M DeepSeek V4.1 Flash
العناوين والردود السريعة BroadNet Gemma 4 VL 26B

من بين هذه النماذج، لا يعمل بالرصيد المبدئي البالغ $5 إلا Gemma 4 VL 26B، ويغطي الرصيد أيضًا نموذجَي Transcribe. قارن الأسعار في صفحة الأسعار.

حل المشكلات

  • نقطة النهاية لا تظهر. تحقق من أن name وbaseURL وapiKey وmodels.default مكتوبة بشكل صحيح ومُزاحة داخل endpoints.custom. يُسقط LibreChat العناصر الناقصة دون أي سطر في السجل. وعلى Docker، تأكد من إلغاء تعليق ربط bind في docker-compose.override.yml.
  • “Missing API Key for BroadNet”. المتغير BROADNET_API_KEY غير موجود في .env، أو لم يُعَد تشغيل LibreChat. تظل نقطة النهاية ظاهرة؛ ولا يظهر الخطأ إلا عند إرسال رسالة.
  • 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. إذا ضبطت حدًا صغيرًا للمخرجات في معاملات LibreChat، فارفعه. راجع لماذا تعود الإجابات فارغة.
  • 429 مع كثرة المستخدمين. يسمح مفتاح واحد للدفع حسب الاستخدام بـ 30 من الطلبات في الدقيقة و4 في الوقت نفسه، يتقاسمها كل من يستخدم نقطة النهاية. وطلبات العناوين تُحتسب أيضًا. أما مفاتيح user_provided فتوزّع الحمل. راجع الأخطاء وإعادة المحاولة.
  • مفاتيح الخطط. جلسة الخطة غير المحدودة تشغّل طلبًا واحدًا في كل مرة ولا يمكن مشاركتها، فلا تناسب LibreChat متعدد المستخدمين.

أسئلة شائعة

لماذا لا تظهر نقطة نهاية BroadNet في LibreChat؟

يُسقط LibreChat نقطة النهاية المخصّصة دون أي خطأ أو سطر في السجل إذا كان name أو baseURL أو apiKey أو models.default مفقودًا أو مكتوبًا خطأ. وعلى Docker، تحقق أيضًا من أن librechat.yaml مربوط على /app/librechat.yaml وأنك أعدت التشغيل.

هل يمكن لكل مستخدم أن يستخدم مفتاح BroadNet الخاص به؟

نعم. اضبط apiKey على user_provided. عندها يطلب LibreChat من كل مستخدم مفتاحًا في أول مرة يختار فيها نقطة النهاية، ويخزّنه مشفّرًا.

لماذا يظهر في LibreChat الخطأ "Missing API Key for BroadNet"؟

المتغير المشار إليه في apiKey غير مضبوط في .env. تظل نقطة النهاية ظاهرة في القائمة، ولا يظهر الخطأ إلا عند إرسال رسالة. أضف المتغير ثم أعد تشغيل LibreChat.

هل يجب أن يتضمن baseURL في LibreChat المسار /chat/completions؟

لا. يضيف LibreChat المسار /chat/completions إلى baseURL افتراضيًا. استخدم https://inference.broadnet.ai/v1. ولا تضبط directEndpoint على true إلا إذا كان العنوان الذي تدخله هو نقطة نهاية completions الكاملة أصلًا.

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