# إعداد LibreChat بمفتاح خبير: نقاط اتصال مخصّصة

> أضف خبير إلى LibreChat المستضاف ذاتيًا عبر نقاط اتصال مخصّصة في librechat.yaml، واحفظ المفاتيح في .env، وشغّل Claude أو GPT أو Gemini من رصيدك.

آخر تحديث: 2026-11-01

لإعداد LibreChat بمفتاح خبير، أضف نقطة اتصال مخصّصة لكل مزوّد تحت `endpoints.custom` في الملف `librechat.yaml`. ضع في `baseURL` العنوان `https://api.5abeer.ai/v1`، واجعل `apiKey` يقرأ المفتاح من متغيّر في `.env`، واكتب معرّف نموذج مثل `claude-sonnet-5.5` تحت `models.default`، ثم أعد تشغيل LibreChat. بعد ذلك تُدفع الطلبات من رصيدك في خبير.

## ما تحتاج إليه

- نسخة من LibreChat تستضيفها بنفسك. تفترض الأمثلة التالية التثبيت عبر Docker Compose.
- مفتاح API من خبير لكل مزوّد تريده. فالمفتاح يعمل مع نماذج مزوّد واحد فقط، ومفتاح Claude يشغّل نماذج Claude وحدها ([أنشئ مفتاحًا](https://5abeer.ai/ar/docs/start/keys.md#create)).
- رصيد في حسابك ([طرق الدفع](https://5abeer.ai/ar/docs/start/payment.md)).

مفتاح الاشتراك في خبير لا يعمل هنا. فالباقات مخصّصة للتطبيقات المدعومة، وLibreChat ليس منها. أنشئ مفتاح API يُدفع استخدامه من رصيدك.

## كيف تعمل نقاط الاتصال المخصّصة في LibreChat؟

يقرأ LibreChat المزوّدين الإضافيين من الملف `librechat.yaml`. وكل عنصر تحت `endpoints.custom` اتصال متوافق مع OpenAI، له اسمه ومفتاحه وعنوانه الأساسي وقائمة نماذجه، ويظهر خيارًا مستقلًا في قائمة نقاط الاتصال.

تذكر وثائق LibreChat أربعة حقول إلزامية: `name` و`apiKey` و`baseURL` و`models`. وتنبّه إلى أن غياب أي منها يُسقط نقطة الاتصال بصمت، دون أي خطأ في السجلات. ويقدّم خبير صيغة OpenAI Chat Completions على المسار `/v1` لنماذج Claude وGPT وGemini، فتكفي نقطة اتصال واحدة لكل مفتاح.

| الصيغة | العنوان الأساسي | ترويسة المفتاح |
| --- | --- | --- |
| OpenAI | `https://api.5abeer.ai/v1` | `Authorization: Bearer <KEY>` |
| Anthropic | `https://api.5abeer.ai` | `x-api-key: <KEY>` |
| Gemini | `https://api.5abeer.ai/v1beta` | `x-goog-api-key: <KEY>` |

## مثال librechat.yaml لخبير

### 1. أنشئ مفتاحًا لكل مزوّد

افتح في لوحة التحكم **API → Keys**، واختر **New key**، ثم حدّد Claude. كرّر الخطوة لـ GPT، ولـ Gemini إن أردته. انسخ كل مفتاح عندما يظهر.

### 2. ضع المفاتيح في .env

أضف متغيّرًا لكل مفتاح في الملف `.env` داخل مجلد LibreChat. الأسماء من اختيارك، ويكفي أن تطابق ما تكتبه في `librechat.yaml`.

```bash
KHABEER_CLAUDE_KEY=your-5abeer-claude-key
KHABEER_GPT_KEY=your-5abeer-gpt-key
KHABEER_GEMINI_KEY=your-5abeer-gemini-key
```

### 3. اكتب الملف librechat.yaml

أنشئ الملف `librechat.yaml` بجانب `docker-compose.yml`. ولنماذج GPT وGemini انسخ المعرّف من [قائمة النماذج](https://5abeer.ai/ar/models) وضعه مكان القيمة المؤقتة.

```yaml
version: 1.3.18
endpoints:
  custom:
    - name: '5abeer Claude'
      apiKey: '${KHABEER_CLAUDE_KEY}'
      baseURL: 'https://api.5abeer.ai/v1'
      models:
        default: ['claude-sonnet-5.5', 'claude-opus-5.5']
        fetch: false
      titleConvo: true
      titleModel: 'current_model'
      modelDisplayLabel: '5abeer Claude'
    - name: '5abeer GPT'
      apiKey: '${KHABEER_GPT_KEY}'
      baseURL: 'https://api.5abeer.ai/v1'
      models:
        default: ['YOUR_GPT_MODEL_ID']
        fetch: false
      titleConvo: true
      titleModel: 'current_model'
      modelDisplayLabel: '5abeer GPT'
    - name: '5abeer Gemini'
      apiKey: '${KHABEER_GEMINI_KEY}'
      baseURL: 'https://api.5abeer.ai/v1'
      models:
        default: ['YOUR_GEMINI_MODEL_ID']
        fetch: false
      titleConvo: true
      titleModel: 'current_model'
      modelDisplayLabel: '5abeer Gemini'
```

قيمة `version` هي إصدار مخطط الإعداد كما يظهر في دليل البدء السريع من LibreChat. وإذا جاء إصدارك من LibreChat بقيمة أحدث فاستخدمها. واحذف كتلة Gemini إن لم تحتج إليها.

### 4. اربط الملف عبر docker-compose.override.yml

لا تقرأ حاوية LibreChat الملف قبل أن تربطه بها. أضف ما يلي إلى `docker-compose.override.yml`:

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

### 5. أعد التشغيل وجرّب

يقرأ LibreChat الإعداد عند التشغيل، لذلك أعد تشغيله بعد كل تعديل:

```bash
docker compose down && docker compose up -d
```

افتح LibreChat، واختر **5abeer Claude** من قائمة نقاط الاتصال، ثم النموذج `claude-sonnet-5.5`، وأرسل رسالة قصيرة. إذا وصلك رد فالإعداد يعمل.

وظيفة كل حقل:

- `name`: اسم فريد يظهر عنوانًا في قائمة نقاط الاتصال.
- `apiKey`: المفتاح. الصيغة `'${KHABEER_CLAUDE_KEY}'` تقرؤه من `.env`، فلا يُكتب المفتاح في ملف YAML أبدًا.
- `baseURL`: العنوان `https://api.5abeer.ai/v1` لكل نقاط الاتصال.
- `models.default`: المعرّفات التي تظهر في قائمة النماذج. ضع `claude-sonnet-5.5` أولًا.
- `models.fetch`: القيمة `false` تُبقي القائمة التي كتبتها. اكتب كل معرّف كما يظهر في [قائمة النماذج](https://5abeer.ai/ar/models) تمامًا.
- `titleConvo` و`titleModel`: يفعّلان عناوين المحادثات، والقيمة `'current_model'` تكتب العنوان بنموذج المحادثة نفسها.
- `modelDisplayLabel`: التسمية التي تظهر بجانب أيقونة النموذج.

## LibreChat مع Claude: نقطة اتصال Anthropic المدمجة

في LibreChat أيضًا نقطة اتصال مدمجة لـ Anthropic تُضبط من `.env`. ويذكر مرجع المتغيّرات فيها `ANTHROPIC_API_KEY` و`ANTHROPIC_MODELS` و`ANTHROPIC_REVERSE_PROXY`، ويصف الأخير بأنه وسيط عكسي لـ Anthropic. فإذا استخدمت مفتاح Claude من خبير فاجعل الوسيط العكسي عنوان صيغة Anthropic، وهو بلا `/v1`:

```bash
ANTHROPIC_API_KEY=your-5abeer-claude-key
ANTHROPIC_REVERSE_PROXY=https://api.5abeer.ai
ANTHROPIC_MODELS=claude-sonnet-5.5,claude-opus-5.5
```

يستخدم هذا الطريق صيغة Anthropic Messages. اختر طريقًا واحدًا لـ Claude، نقطة الاتصال المخصّصة أو هذا الطريق، حتى لا يرى مستخدموك النماذج نفسها مرتين.

## أي نموذج تختار في LibreChat؟

ابدأ بنموذج [`claude-sonnet-5.5`](https://5abeer.ai/ar/models/claude-sonnet-5.5) للمحادثة والكتابة اليومية. وانتقل إلى [`claude-opus-5.5`](https://5abeer.ai/ar/models/claude-opus-5.5) في المهام الطويلة والصعبة التي تستحق تكلفتها الأعلى. هذه نماذج Claude الحالية:

| النموذج | المعرّف | الإدخال (سعرنا) | الإخراج (سعرنا) | السياق |
| --- | --- | --- | --- | --- |
| Claude Sonnet 5.5 | `claude-sonnet-5.5` | 0.60 US$ | 3 US$ | 1M |
| Claude Opus 5.5 | `claude-opus-5.5` | 1.20 US$ | 6 US$ | 1M |
| Claude Fable 5.1 | `claude-fable-5.1` | 3 US$ | 15 US$ | — |

السعر الرسمي بجانب سعرنا، مع تاريخ قراءته:

Claude Sonnet 5.5 (`claude-sonnet-5.5`) لكل مليون توكن: الإدخال 0.60 US$ (الرسمي 2 US$)، الإخراج 3 US$ (الرسمي 10 US$). آخر مراجعة للسعر الرسمي: 19 أكتوبر 2026.

ولنقطتي GPT وGemini خذ المعرّفات من القائمتين التاليتين، مع مفتاح لذلك المزوّد:

| النموذج | المعرّف | الإدخال (سعرنا) | الإخراج (سعرنا) | السياق |
| --- | --- | --- | --- | --- |
| GPT-6.1 Sol | `gpt-6.1-sol` | 0.60 US$ | 3 US$ | 922K |
| GPT-6 Astra | `gpt-6-astra` | 3 US$ | 15 US$ | — |
| GPT-6 Sol | `gpt-6-sol` | 0.60 US$ | 3 US$ | 922K |

| النموذج | المعرّف | الإدخال (سعرنا) | الإخراج (سعرنا) | السياق |
| --- | --- | --- | --- | --- |
| Gemini 4 Argon | `gemini-4-argon` | 0.60 US$ | 3 US$ | — |
| Gemini 2.5 Pro | `gemini-2.5-pro` | 0.38 US$ | 3 US$ | 1M |

## Claude وGPT وGemini في LibreChat واحد: مفتاح لكل مزوّد

كل مفتاح في خبير يعمل مع نماذج مزوّد واحد. فإذا وضعت معرّف GPT تحت نقطة Claude يعود الطلب بالخطأ [`MODEL_PLATFORM_NOT_ALLOWED`](https://5abeer.ai/ar/docs/help/errors.md#MODEL_PLATFORM_NOT_ALLOWED). لهذا جعلنا في المثال نقطة اتصال لكل مفتاح، ولكل منها متغيّرها. وتُخصم كل المفاتيح من الرصيد نفسه.

## تأمين LibreChat المستضاف ذاتيًا

أنت من يدير الخادم، فأنت من يقرّر من يستخدم رصيدك.

- أغلق التسجيل. يذكر مرجع `.env` في LibreChat المتغيّر `ALLOW_REGISTRATION` وقيمته الافتراضية `true`. أنشئ حساباتك أولًا، ثم اضبط `ALLOW_REGISTRATION=false`.
- شغّل LibreChat عبر HTTPS فقط، خلف وسيط عكسي بشهادة صالحة، حتى لا تنتقل بيانات الدخول والمحادثات نصًا مكشوفًا.
- احفظ المفاتيح في `.env` أو في مخزن الأسرار على خادمك فقط. ولا يحمل `librechat.yaml` إلا مراجع `${...}`، لا مفاتيح. وأبقِ `.env` خارج Git.
- في النسخة المشتركة خصّص لـ LibreChat مفاتيح خاصة به، وضع على كل مفتاح حدًا للإنفاق وتاريخ انتهاء وقائمة عناوين IP مسموح بها ([التحكم في المفاتيح](https://5abeer.ai/ar/docs/start/keys.md#controls)). فإن تسرّب مفتاح لن ينفق أكثر مما سمحت به.

## التحكم في تكلفة LibreChat

يُدفع كل طلب من رصيدك حسب التوكنات التي يستخدمها، بسعر النموذج في خبير ([الأسعار والرصيد](https://5abeer.ai/ar/docs/start/pricing.md)). والمحادثة الطويلة ترسل رسائلها السابقة مع كل رد، فتزيد تكلفة الرسالة كلما طالت. وعناوين المحادثات تضيف طلبًا صغيرًا لكل محادثة جديدة، ويمكنك إيقافها بالقيمة `titleConvo: false`. كما أن المفاتيح المنفصلة لكل نقطة اتصال تفصل استخدام كل مزوّد في لوحة التحكم.

## الأخطاء الشائعة وحلولها

- نقطة الاتصال لا تظهر: أحد الحقول `name` أو `apiKey` أو `baseURL` أو `models` ناقص، أو الملف `librechat.yaml` غير مربوط. راجع ملف override ثم أعد التشغيل.
- [`INVALID_API_KEY`](https://5abeer.ai/ar/docs/help/errors.md#INVALID_API_KEY) أو الخطأ 401: المفتاح خطأ أو أُلغي أو لم يُحمَّل. تأكد أن اسم المتغيّر في `.env` يطابق المرجع `${...}`، ثم أعد التشغيل.
- [`MODEL_PLATFORM_NOT_ALLOWED`](https://5abeer.ai/ar/docs/help/errors.md#MODEL_PLATFORM_NOT_ALLOWED): النموذج يتبع مزوّدًا غير مزوّد المفتاح. انقله إلى نقطة الاتصال المطابقة.
- عنوان أساسي خطأ: نقاط الاتصال المخصّصة تستخدم `https://api.5abeer.ai/v1`، أما `ANTHROPIC_REVERSE_PROXY` فيستخدم `https://api.5abeer.ai` بلا `/v1`.
- النموذج غير موجود: في المعرّف خطأ كتابي. انسخه من [قائمة النماذج](https://5abeer.ai/ar/models).
- [`INSUFFICIENT_BALANCE`](https://5abeer.ai/ar/docs/help/errors.md#INSUFFICIENT_BALANCE): رصيدك لا يكفي للطلب. اشحن الرصيد ثم أعد المحاولة.

كل رمز خطأ ومعناه في [الأخطاء وحلولها](https://5abeer.ai/ar/docs/help/errors.md).

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

### هل أستخدم اشتراكي في خبير داخل LibreChat؟

لا. الباقات تشغّل التطبيقات المدعومة فقط، وLibreChat ليس منها. أنشئ مفتاح API وادفع استخدام LibreChat من رصيدك.

### هل نقطة الاتصال المخصّصة في LibreChat متوافقة مع OpenAI؟

نعم. تتحدث نقطة الاتصال المخصّصة بصيغة OpenAI، وخبير يقدّمها على العنوان `https://api.5abeer.ai/v1` لنماذج Claude وGPT وGemini.

### لماذا أحتاج إلى مفاتيح منفصلة لـ Claude وGPT؟

لأن المفتاح في خبير يعمل مع نماذج مزوّد واحد فقط. أنشئ مفتاحًا لكل مزوّد، وأضف نقطة اتصال لكل مفتاح، ويُخصم الاثنان من الرصيد نفسه.

### هل أفعّل models.fetch؟

يمكنك ذلك، لكن الأفضل أن تُبقي `fetch: false` وتكتب المعرّفات بنفسك. وإذا فعّلت الجلب فطابق كل معرّف مع قائمة نماذج خبير.

### هل يستطيع كل مستخدم أن يضع مفتاحه الخاص من خبير؟

نعم. يقبل LibreChat القيمة `apiKey: 'user_provided'`، فيُدخل كل مستخدم مفتاحه داخل التطبيق ويدفع من رصيده.

### هل تعمل نقطة Anthropic المدمجة بمفتاح خبير؟

نعم، بمفتاح Claude. اضبط `ANTHROPIC_REVERSE_PROXY` على `https://api.5abeer.ai`، وضع المفتاح في `ANTHROPIC_API_KEY`.

> هل أنت مستعد لربط LibreChat؟ [أنشئ مفتاح API](https://5abeer.ai/ar/docs/start/keys.md#create) لكل مزوّد تريده، ثم راجع كل النماذج وأسعارها في [صفحة API في خبير](https://5abeer.ai/ar/api). وإذا كنت تُعدّ تطبيق محادثة مشابهًا فراجع دليل [Open WebUI](https://5abeer.ai/ar/guides/open-webui-api-key)، أو قارن بين [الاشتراك وAPI](https://5abeer.ai/ar/guides/ai-subscription-vs-api).

## المصادر

راجعناها في 2026-11-01:

- وثائق LibreChat: [Custom endpoints quick start](https://www.librechat.ai/docs/quick_start/custom_endpoints) و[Custom endpoint object structure](https://www.librechat.ai/docs/configuration/librechat_yaml/object_structure/custom_endpoint) و[.env configuration](https://www.librechat.ai/docs/configuration/dotenv)
- وثائق خبير: [مفاتيح API](https://5abeer.ai/ar/docs/start/keys.md) و[العناوين الأساسية](https://5abeer.ai/ar/docs/start/base-urls.md) و[الأخطاء وحلولها](https://5abeer.ai/ar/docs/help/errors.md)

> خبير خدمة مستقلة، ولا تتبع LibreChat أو OpenAI أو Anthropic أو Google.