---
title: "نقطة نهاية مخصّصة في LibreChat عبر librechat.yaml | BroadRouter"
description: "أضف BroadNet Inference إلى LibreChat كنقطة نهاية مخصّصة متوافقة مع OpenAI في librechat.yaml، مع المفتاح في .env وقائمة النماذج ونموذج العناوين والحلول."
url: https://broadrouter.com/ar/guides/librechat-custom-endpoint/
lang: ar
updated: 2026-11-16
publisher: BroadRouter (a BroadNet site); API by BroadNet Inference, https://inference.broadnet.ai
---

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

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

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

في 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 لنقاط النهاية المخصّصة](https://www.librechat.ai/docs/quick_start/custom_endpoints).

## الإعداد

1.  **اربط librechat.yaml (على Docker فقط).** انسخ `docker-compose.override.yml.example` إلى `docker-compose.override.yml` وتأكد من أن وحدة التخزين (volume) مفعّلة:

```yaml
services:
  api:
    volumes:
      - type: bind
        source: ./librechat.yaml
        target: /app/librechat.yaml
```

2.  **أضف نقطة النهاية** إلى `librechat.yaml` في جذر المشروع، تحت `endpoints.custom`:

```yaml
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`.

3.  **اضبط المفتاح** في `.env`:

```bash
BROADNET_API_KEY=your-broadnet-key
```

4.  **أعد تشغيل 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](https://broadrouter.com/ar/models/glm-5.3/) |
| الصور والعربية | [Qwen3.8 27B](https://broadrouter.com/ar/models/qwen3.8-27b/) |
| المستندات الطويلة، سياق 1M | [DeepSeek V4.1 Flash](https://broadrouter.com/ar/models/deepseek-v4.1-flash/) |
| العناوين والردود السريعة | [BroadNet Gemma 4 VL 26B](https://broadrouter.com/ar/models/gemma-4-vl-26b/) |

من بين هذه النماذج، لا يعمل بالرصيد المبدئي البالغ $5 إلا Gemma 4 VL 26B، ويغطي الرصيد أيضًا نموذجَي Transcribe. قارن الأسعار في [صفحة الأسعار](https://broadrouter.com/ar/pricing/).

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

-   **نقطة النهاية لا تظهر.** تحقق من أن `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، فارفعه. راجع [لماذا تعود الإجابات فارغة](https://broadrouter.com/ar/guides/reasoning-tokens-empty-response/).
-   **429 مع كثرة المستخدمين.** يسمح مفتاح واحد للدفع حسب الاستخدام بـ 30 من الطلبات في الدقيقة و4 في الوقت نفسه، يتقاسمها كل من يستخدم نقطة النهاية. وطلبات العناوين تُحتسب أيضًا. أما مفاتيح `user_provided` فتوزّع الحمل. راجع [الأخطاء وإعادة المحاولة](https://broadrouter.com/ar/guides/errors-and-retries/).
-   **مفاتيح الخطط.** [جلسة الخطة غير المحدودة](https://broadrouter.com/ar/guides/unlimited-llm-api-sessions/) تشغّل طلبًا واحدًا في كل مرة ولا يمكن مشاركتها، فلا تناسب LibreChat متعدد المستخدمين.

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

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

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

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

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

[العنوان الأساسي (Base URL)](https://broadrouter.com/ar/glossary/base-url/)

العنوان الأساسي (base URL) هو الجذر الثابت لعنوان الواجهة، مثل https://api.example.com/v1، الذي يضعه العميل قبل كل مسار نقطة نهاية، مثل /chat/completions. وفي حزم SDK المتوافقة مع OpenAI، يكفي تغيير العنوان الأساسي، مع مفتاح API ومعرّف النموذج، لتوجيه الشيفرة نفسها إلى مزوّد آخر.

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

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

### لماذا لا تظهر نقطة نهاية 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 الكاملة أصلًا.

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

-   [ربط Open WebUI بـ BroadNet Inference](https://broadrouter.com/ar/guides/open-webui-openai-api/)
-   [لماذا يعيد نموذج الاستدلال إجابة فارغة؟](https://broadrouter.com/ar/guides/reasoning-tokens-empty-response/)
-   [رموز أخطاء BroadNet Inference ومتى تعيد المحاولة](https://broadrouter.com/ar/guides/errors-and-retries/)
-   [اربط مفاتيح API بخوادمك عبر قوائم عناوين IP المسموح بها](https://broadrouter.com/ar/guides/api-keys-ip-allow-lists/)
-   [كل الأدوات التي تعمل مع 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-librechat-custom-endpoint&utm_content=page-cta) ·

**المصادر**

-   [توثيق LibreChat، البداية السريعة لنقاط النهاية المخصّصة (رُوجع في 2026-11-14)](https://www.librechat.ai/docs/quick_start/custom_endpoints)
-   [توثيق LibreChat، بنية كائن نقطة النهاية المخصّصة (رُوجع في 2026-11-14)](https://www.librechat.ai/docs/configuration/librechat_yaml/object_structure/custom_endpoint)
-   [المرجع التقني لـ BroadNet Inference API (رُوجع في 2026-11-16) (بالإنجليزية)](https://inference.broadnet.ai/docs?utm_source=broadrouter&utm_medium=referral&utm_campaign=ar-guides-librechat-custom-endpoint&utm_content=sources)
