> ## Documentation Index
> Fetch the complete documentation index at: https://docs.tokenlab.sh/llms.txt
> Use this file to discover all available pages before exploring further.

# تطبيقات الدردشة المدعومة بالذكاء الاصطناعي

> قم بتهيئة تطبيقات الدردشة الشهيرة التي تعمل بالذكاء الاصطناعي لاستخدام واجهة برمجة التطبيقات (API) الخاصة بـ TokenLab والمتوافقة مع OpenAI

## نظرة عامة

تتصل معظم تطبيقات الدردشة العامة بالذكاء الاصطناعي بـ TokenLab من خلال مسار الدردشة القياسي المتوافق مع OpenAI.

عملياً، هذا يعني:

* استخدم `https://api.tokenlab.sh/v1` كعنوان URL أساسي (base URL) ما لم يطلب التطبيق صراحةً عنوان URL كاملاً لنقطة النهاية (endpoint URL).
* استخدم مفتاح API الخاص بـ TokenLab كمفتاح API بنمط OpenAI.
* اختر النماذج التي يمكن للتطبيق استخدامها في سير عمل الدردشة القياسي.

<Note>
  تطبيقات الدردشة العامة عادة ما تكون **موجهة لإكمال الدردشة (chat-completions)**، وليست عملاء WebSocket لاستجابات Codex. بالنسبة لـ Codex CLI/App أو Cursor أو أدوات البرمجة الأخرى التي تتطلب سلوكاً خاصاً بالاستجابات، استخدم أدلة التكامل المخصصة بدلاً من ذلك.
</Note>

<Note>
  **النوع**: تطبيق دردشة

  **المسار الأساسي**: إكمال الدردشة المتوافق مع OpenAI

  **مستوى الدعم**: مسار مدعوم
</Note>

## التطبيقات المدعومة

| التطبيق       | المنصة                               | ملاحظات                                                    |
| ------------- | ------------------------------------ | ---------------------------------------------------------- |
| Open WebUI    | الويب، الاستضافة الذاتية             | خيار شائع للاستضافة الذاتية مع اتصالات متوافقة مع OpenAI   |
| LibreChat     | الويب، الاستضافة الذاتية             | مساحة عمل دردشة متعددة الموفرين مع نقاط نهاية OpenAI مخصصة |
| LobeChat      | الويب، سطح المكتب، الاستضافة الذاتية | دعم قوي للموفرين المخصصين                                  |
| Cherry Studio | Windows, macOS, Linux                | تدفق جيد للموفرين المتوافقين مع OpenAI                     |
| Chatbox       | Windows, macOS, Linux                | إعداد بسيط متوافق مع OpenAI                                |
| DeepChat      | Windows, macOS, Linux                | عميل سطح مكتب مع إعدادات موفر متوافقة مع OpenAI            |
| Jan           | سطح المكتب، الاستضافة الذاتية        | تطبيق محلي أولاً مع موفرين عن بُعد متوافقين مع OpenAI      |
| TypingMind    | الويب، سطح المكتب                    | يستخدم نمط نقطة نهاية مخصص                                 |
| NextChat      | الويب، الاستضافة الذاتية             | عميل خفيف بنمط ChatGPT مع تجاوزات لعنوان URL الأساسي       |
| ChatWise      | Windows, macOS                       | نمط الموفر المخصص القياسي                                  |

## قيم الاتصال الافتراضية

| الحقل    | القيمة                       |
| -------- | ---------------------------- |
| Base URL | `https://api.tokenlab.sh/v1` |
| API Key  | `sk-your-tokenlab-key`       |
| API Type | OpenAI Compatible            |

إذا طلب التطبيق **عنوان URL كاملاً لنقطة النهاية** بدلاً من عنوان URL أساسي، استخدم:

* Chat Completions: `https://api.tokenlab.sh/v1/chat/completions`

## إعدادات التطبيقات النموذجية

<Tabs>
  <Tab title="LobeChat">
    **استضافة LobeChat ذاتياً**

    ```bash theme={null}
    OPENAI_API_KEY=sk-your-tokenlab-key
    OPENAI_PROXY_URL=https://api.tokenlab.sh/v1
    ```

    **LobeChat Cloud**

    1. افتح **Settings** → **AI Service Provider**
    2. اختر **OpenAI**
    3. أدخل مفتاح API الخاص بـ TokenLab
    4. اضبط نقطة النهاية المخصصة على `https://api.tokenlab.sh/v1`
  </Tab>

  <Tab title="Cherry Studio">
    1. افتح **Settings** → **Model Provider**
    2. أضف موفراً **متوافقاً مع OpenAI**
    3. أدخل:
       * **Name**: TokenLab
       * **API Base URL**: `https://api.tokenlab.sh/v1`
       * **API Key**: `sk-your-tokenlab-key`
    4. أضف النماذج التي ترغب في استخدامها
  </Tab>

  <Tab title="Chatbox">
    1. افتح **Settings** → **AI Model**
    2. اختر **OpenAI API Compatible**
    3. أدخل:
       * **API Host**: `https://api.tokenlab.sh/v1`
       * **API Key**: `sk-your-tokenlab-key`
       * **Model**: `gpt-5.4-mini` أو `claude-sonnet-5`
  </Tab>

  <Tab title="TypingMind">
    1. افتح **Settings**
    2. اختر **Custom Endpoint**
    3. أدخل:
       * **Endpoint URL**: `https://api.tokenlab.sh/v1/chat/completions`
       * **API Key**: `sk-your-tokenlab-key`
    4. قم بتهيئة النماذج التي تريد عرضها
  </Tab>

  <Tab title="Open WebUI">
    1. افتح **Admin Settings** → **Connections**
    2. أضف اتصالاً **متوافقاً مع OpenAI**
    3. أدخل:
       * **Base URL**: `https://api.tokenlab.sh/v1`
       * **API Key**: `sk-your-tokenlab-key`
    4. احفظ واختر النماذج التي تريد عرضها
  </Tab>

  <Tab title="DeepChat">
    1. افتح **Settings** -> **Model Provider**
    2. أضف موفراً متوافقاً مع OpenAI
    3. أدخل:
       * **Base URL**: `https://api.tokenlab.sh/v1`
       * **API Key**: `sk-your-tokenlab-key`
       * **Model**: `gpt-5.4-mini`
    4. احفظ وقم بإجراء دردشة تجريبية
  </Tab>

  <Tab title="Jan">
    1. افتح **Settings** -> **Providers**
    2. أضف موفراً عن بُعد متوافقاً مع OpenAI
    3. أدخل:
       * **Provider name**: TokenLab
       * **Base URL**: `https://api.tokenlab.sh/v1`
       * **API Key**: `sk-your-tokenlab-key`
    4. اختر `gpt-5.4-mini` أو نموذجاً آخر من TokenLab
  </Tab>

  <Tab title="LibreChat">
    أضف نقطة نهاية متوافقة مع OpenAI في إعدادات موفر LibreChat ووجهها إلى:

    ```yaml theme={null}
    customEndpoints:
      - name: TokenLab
        apiKey: '${OPENAI_API_KEY}'
        baseURL: 'https://api.tokenlab.sh/v1'
        models:
          default: ['gpt-5.4-mini', 'gpt-5.4', 'claude-sonnet-5']
          fetch: false
    ```
  </Tab>
</Tabs>

## النماذج الافتراضية الأكثر أماناً

| الفئة           | النماذج المقترحة                                       |
| --------------- | ------------------------------------------------------ |
| الافتراضي العام | `gpt-5.4-mini`, `gpt-5.4`, `gpt-5.5`                   |
| Anthropic       | `claude-sonnet-5`, `claude-opus-4-8`, `claude-fable-5` |
| Google          | `gemini-3.5-flash`, `gemini-3.1-flash-lite`            |
| DeepSeek        | `deepseek-v4-flash`, `deepseek-v4-pro`                 |

## نصائح

<AccordionGroup>
  <Accordion title="فضل استخدام عنوان URL الأساسي عندما يدعمه التطبيق">
    تكون معظم التطبيقات أسهل في التهيئة وأقل عرضة للأخطاء عند توفير `https://api.tokenlab.sh/v1` كعنوان URL أساسي بدلاً من عنوان URL كامل لنقطة النهاية.
  </Accordion>

  <Accordion title="استخدم النماذج الأصغر أولاً">
    ابدأ بـ `gpt-5.4-mini` أو `deepseek-v4-flash` للدردشة اليومية، ثم انتقل إلى مهام الاستدلال الأكثر تعقيداً باستخدام `gpt-5.4` أو `claude-opus-4-8`.
  </Accordion>

  <Accordion title="حافظ على فصل أدوات البرمجة">
    غالباً ما تحتاج تطبيقات الدردشة العامة وعملاء البرمجة إلى سلوك مختلف لنقاط النهاية. احتفظ بالأدوات من نوع Codex/Cursor في صفحات التكامل المخصصة لها.
  </Accordion>
</AccordionGroup>

## استكشاف الأخطاء وإصلاحها

<AccordionGroup>
  <Accordion title="خطأ في الاتصال">
    * تحقق من أن عنوان URL الأساسي هو بالضبط `https://api.tokenlab.sh/v1`
    * قم بإزالة الشرطات المائلة الزائدة إذا كان التطبيق يضيف مسارات تلقائياً
    * إذا كان التطبيق يطلب عنوان URL كاملاً لنقطة النهاية، استخدم `https://api.tokenlab.sh/v1/chat/completions`
  </Accordion>

  <Accordion title="401 غير مصرح به">
    * تحقق جيداً من مفتاح API الخاص بك
    * تأكد من أن المفتاح نشط في لوحة تحكم TokenLab
    * تأكد من عدم وجود مسافات إضافية أو فواصل أسطر
  </Accordion>

  <Accordion title="النموذج غير متاح">
    * تحقق من اسم النموذج بدقة
    * جرب نموذجاً افتراضياً مدعوماً على نطاق واسع مثل `gpt-5.4-mini` أو `deepseek-v4-flash` أو `claude-sonnet-5`
    * تحقق من التوفر الحالي في وثائق أو لوحة تحكم TokenLab
  </Accordion>
</AccordionGroup>