---
title: Chatbox AI | RunAPI
description: ثبّت Chatbox AI، أضف مزوداً مخصصاً لـ RunAPI، احضر نموذجاً، شغّل فحص
  الاتصال، وتحقق من الدردشة.
url: https://runapi.ai/ar/docs/resources/application-practices/chatbox.md
canonical: https://runapi.ai/ar/docs/resources/application-practices/chatbox
locale: ar
---

> نسخة HTML: https://runapi.ai/ar/docs/resources/application-practices/chatbox
> فهرس الموقع للوكلاء: https://runapi.ai/llms.txt

# Chatbox AI

اربط Chatbox AI بـ RunAPI باستخدام مزوّد BYOK مخصص. تتبع الأسماء
أدناه واجهة المزوّد المخصص الحالية؛ قد تتفاوت التسميات قليلاً بين
إصدارات سطح المكتب. أنشئ مفتاح API قياسياً لـ RunAPI في
[دليل المصادقة](https://runapi.ai/ar/docs/guides/authentication.md) قبل المتابعة.

## تثبيت Chatbox AI

حمّل Chatbox AI من [صفحة التنزيل الرسمية][1] أو من [الإصدارات الرسمية][2]، ثم افتح **Settings**.



[1]: https://chatboxai.app/
[2]: https://github.com/chatboxai/chatbox/releases

## إضافة موفر RunAPI

1.  افتح **إعدادات موفر الذكاء الاصطناعي / النموذج** وحدد **إضافة موفر**.
2.  سمِّه `RunAPI` واختر **OpenAI API Compatible** كوضع API.
3.  أدخل مفتاح API الخاص بك في RunAPI.
4.  اضبط **مضيف API** على `https://runapi.ai/v1` و**مسار API** على
    `/chat/completions`.
5.  تأكد من أن معاينة URL تنتهي بـ
    `https://runapi.ai/v1/chat/completions`، ثم احفظ.

احتفظ بـ Host وPath منفصلَين. يبني **Fetch** اكتشاف النموذج من Host مع `/models`، بينما تستخدم الدردشة Host إضافةً إلى API Path المُعيَّن.

## إضافة نموذج والتحقق منه

حدد **Fetch** لتحميل جرد نماذج RunAPI. إذا كان الاكتشاف
غير متاح، حدد **New** وأدخل معرّفاً دقيقاً من
[كتالوج النماذج](https://runapi.ai/ar/models). يحتاج Chatbox AI إلى نموذج محفوظ واحد على الأقل
قبل تشغيل **Check**.

حدد **Check**، واختر النموذج المحفوظ، وشغِّل اختبار الاتصال.
اعتبر **Text Request** الناجح إشارة أساسية. يعتمد **Vision
Request** و**Tool Use Request** على قدرات النموذج المحدد وقد يفشلان
بشكل مستقل دون إبطال المحادثة النصية الأساسية.

## التحقق من الاتصال

ابدأ محادثة جديدة، واختر نموذج RunAPI المحفوظ في محدد النماذج،
وأرسل `Reply with the word connected.` تؤكد الاستجابة الطبيعية أن
المزود المخصص نشط.

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

* **معاينة URL خاطئة:** استخدم Host ‏`https://runapi.ai/v1` و Path ‏`/chat/completions`؛ لا تضع URL العملية الكاملة في كلا الحقلين.
* **الفحص مُعطَّل أو لا يوجد له نموذج:** استخدم **Fetch** أو **New** لإضافة نموذج واحد على الأقل أولاً.
* **يفشل Text Request بخطأ مصادقة:** حدّث المزوّد بمفتاح قياسي صالح من [دليل المصادقة](https://runapi.ai/ar/docs/guides/authentication.md).
* **يعمل Text لكن Vision أو Tool Use يفشل:** اختر نموذجاً يُعلن الميزة المطلوبة في [كتالوج النماذج](https://runapi.ai/ar/models)؛ هذه الفحوصات ليست متطلبات شاملة للمزوّد.

للاطلاع على سلوك البروتوكول المشترك، استخدم [البدء السريع لـ LLM API
](https://runapi.ai/ar/docs/guides/llm-api/quickstart.md). للاطلاع على حقول الطلب والاستجابة، استخدم [مرجع Chat Completions API
](https://runapi.ai/ar/docs/api/openai/chat-completions.md).

---

## المزيد من RunAPI

- [الرئيسية](https://runapi.ai/ar/.md)
- [كتالوج النماذج](https://runapi.ai/ar/models.md)
- [الأسعار](https://runapi.ai/ar/pricing.md)
- [مزودو الخدمة](https://runapi.ai/ar/models)
- [التوثيق](https://runapi.ai/ar/docs/guides)
- [حزم SDK](https://runapi.ai/ar/sdk.md)
- [CLI](https://runapi.ai/ar/cli.md)
- [خادم MCP](https://runapi.ai/ar/mcp.md)
- [Claude Code مقابل Cursor](https://runapi.ai/ar/claude-code-vs-cursor.md)
- [إعداد Cursor API](https://runapi.ai/ar/cursor-api-setup.md)
- [RunAPI مقابل OpenRouter](https://runapi.ai/ar/openrouter-alternative.md)
- [المؤسسات](https://runapi.ai/ar/contact.md)
- [اتصل بنا](https://runapi.ai/ar/contact.md)
- [الشروط](https://runapi.ai/ar/terms.md)
- [الخصوصية](https://runapi.ai/ar/privacy.md)
- [فهرس الموقع للوكلاء](https://runapi.ai/llms.txt)

التواصل: contact@runapi.ai

## البيانات المنظمة

```json
[
  {
    "@context": "https://schema.org",
    "inLanguage": "ar",
    "@type": "WebSite",
    "name": "RunAPI",
    "url": "https://runapi.ai/ar",
    "potentialAction": {
      "@type": "SearchAction",
      "target": {
        "@type": "EntryPoint",
        "urlTemplate": "https://runapi.ai/ar/models?q={search_term_string}"
      },
      "query-input": "required name=search_term_string"
    }
  },
  {
    "@context": "https://schema.org",
    "inLanguage": "ar",
    "@type": "Organization",
    "name": "RunAPI",
    "url": "https://runapi.ai/ar",
    "logo": {
      "@type": "ImageObject",
      "url": "https://runapi.ai/aricon.svg"
    },
    "sameAs": [
      "https://github.com/runapi-ai"
    ]
  },
  {
    "@context": "https://schema.org",
    "inLanguage": "ar",
    "@type": "TechArticle",
    "headline": "Chatbox AI",
    "description": "ثبّت Chatbox AI، أضف مزوداً مخصصاً لـ RunAPI، احضر نموذجاً، شغّل فحص الاتصال، وتحقق من الدردشة.",
    "url": "https://runapi.ai/ar/docs/resources/application-practices/chatbox",
    "mainEntityOfPage": "https://runapi.ai/ar/docs/resources/application-practices/chatbox"
  }
]
```