LibreChat تطبيق محادثة مفتوح المصدر يدعم الخدمات المتوافقة مع OpenAI بوصفها نقاط نهاية مخصّصة (custom endpoints). تعرّفها في librechat.yaml، وتحفظ المفاتيح في .env، وعلى Docker تربط ملف YAML بالحاوية. BroadRouter هو موقع BroadNet نفسها؛ وتتبع الخطوات دليل LibreChat لنقاط النهاية المخصّصة.
الإعداد
- اربط 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
- أضف نقطة النهاية إلى
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.
- اضبط المفتاح في
.env:
BROADNET_API_KEY=your-broadnet-key
- أعد تشغيل 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 متعدد المستخدمين.
