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

# ربط Dify بـ CometAPI

> استخدم هذا الدليل لربط Dify بـ CometAPI من خلال تعيين base URL ومفتاح API وخيارات model أو provider.

[Dify](https://dify.ai) هي منصة مفتوحة المصدر لتطوير تطبيقات LLM. من خلال ربطها بـ CometAPI، يمكنك استخدام model ID الحالية من CometAPI داخل أدوات بناء سير العمل وروبوتات الدردشة والوكلاء في Dify.

## المتطلبات الأساسية

* حساب CometAPI مع مفتاح API نشط — [سجّل الدخول للحصول على واحد](https://www.cometapi.com)
* حساب Dify — [سحابي](https://cloud.dify.ai/signin) أو مستضاف ذاتيًا

## الطريقة 1: إضافة CometAPI plugin (موصى بها)

أسهل طريقة للربط. يوفّر Dify Marketplace إضافة CometAPI plugin رسمية تتولى التكامل تلقائيًا.

<Steps>
  <Step title="احصل على مفتاح CometAPI API الخاص بك">
    سجّل الدخول إلى [لوحة تحكم CometAPI](https://www.cometapi.com/console). انقر على **Add API Key** ثم انسخ مفتاحك.

    <Frame>
      <img src="https://mintcdn.com/cometapi/SZhlxZhCnMLn__BW/images/overview/810968_364191.png?fit=max&auto=format&n=SZhlxZhCnMLn__BW&q=85&s=aef81a83f29f8eb16655ed4060425f50" alt="لوحة تحكم CometAPI تعرض زر Add API Key وقائمة المفاتيح" width="3824" height="1892" data-path="images/overview/810968_364191.png" />
    </Frame>

    <Frame>
      <img src="https://mintcdn.com/cometapi/HhtmQffktazbxUvS/images/overview/810968_364193.png?fit=max&auto=format&n=HhtmQffktazbxUvS&q=85&s=d893f659267150d0faf45f99eb5dffc1" alt="تفاصيل مفتاح CometAPI API تعرض base URL ‏https://api.cometapi.com" width="2434" height="1232" data-path="images/overview/810968_364193.png" />
    </Frame>
  </Step>

  <Step title="ثبّت إضافة CometAPI plugin في Dify">
    في Dify، انتقل إلى **Plugins** → **Install Plugin** → **Marketplace**. ابحث عن `cometapi` ثم قم بتثبيته.

    <Frame>
      <img src="https://mintcdn.com/cometapi/E4FFvyMYmaOZoldp/images/integrations/810968_360267.png?fit=max&auto=format&n=E4FFvyMYmaOZoldp&q=85&s=85e4b1a60c912aa98c182ed731cde19f" alt="نتائج البحث في سوق إضافات Dify تعرض إضافة CometAPI plugin" width="1875" height="916" data-path="images/integrations/810968_360267.png" />
    </Frame>

    <Frame>
      <img src="https://mintcdn.com/cometapi/E4FFvyMYmaOZoldp/images/integrations/810968_360269.png?fit=max&auto=format&n=E4FFvyMYmaOZoldp&q=85&s=695d0f5fde8d4c8aad398048b3b504fd" alt="مربع حوار تأكيد تثبيت إضافة CometAPI plugin في Dify" width="1865" height="896" data-path="images/integrations/810968_360269.png" />
    </Frame>
  </Step>

  <Step title="أضف مفتاح API الخاص بك">
    انتقل إلى **Settings** → **Model Provider** → **CometAPI** → **Open Settings**. ألصق مفتاح CometAPI API الخاص بك ثم انقر على **Save**.
  </Step>

  <Step title="أضف النماذج">
    أدخل model ID من [صفحة نماذج CometAPI](/ar/overview/models) ثم انقر على **Add**.

    <Frame>
      <img src="https://mintcdn.com/cometapi/SZhlxZhCnMLn__BW/images/integrations/810968_362636.png?fit=max&auto=format&n=SZhlxZhCnMLn__BW&q=85&s=9aee58e6532ba58d69eb7673e6c45293" alt="إعدادات موفّر النماذج في Dify تعرض نموذج تكوين CometAPI" width="1256" height="880" data-path="images/integrations/810968_362636.png" />
    </Frame>

    <Frame>
      <img src="https://mintcdn.com/cometapi/SZhlxZhCnMLn__BW/images/integrations/810968_362637.png?fit=max&auto=format&n=SZhlxZhCnMLn__BW&q=85&s=46c8b360d87cfad2adc1cd9f18dd7f25" alt="قائمة النماذج في Dify مع إضافة نماذج CometAPI بنجاح" width="1935" height="870" data-path="images/integrations/810968_362637.png" />
    </Frame>
  </Step>

  <Step title="اختبر الاتصال">
    أنشئ روبوت دردشة أو سير عمل واختر نموذجًا من CometAPI. أرسل رسالة اختبار — تؤكد الاستجابة الناجحة أن التكامل يعمل.

    <Frame>
      <img src="https://mintcdn.com/cometapi/SZhlxZhCnMLn__BW/images/integrations/810968_362638.png?fit=max&auto=format&n=SZhlxZhCnMLn__BW&q=85&s=c729bbc0f3bef82a89305434c08ec313" alt="واجهة الدردشة في Dify تعرض استجابة ناجحة من نموذج CometAPI" width="1910" height="924" data-path="images/integrations/810968_362638.png" />
    </Frame>
  </Step>
</Steps>

## الطريقة 2: موفّر متوافق مع OpenAI

استخدم هذه الطريقة لإضافة نماذج لا تغطيها إضافة CometAPI plugin، مثل Claude أو Grok أو Gemini — أو لاستخدام أسماء نماذج مخصصة.

<Steps>
  <Step title="افتح إعدادات موفّر النماذج">
    انتقل إلى **Settings** → **Model Provider** → **OpenAI-API-compatible** → **Add Model**.
  </Step>

  <Step title="كوّن النموذج">
    املأ الحقول التالية:

    | الحقل        | القيمة                                      |
    | ------------ | ------------------------------------------- |
    | نوع النموذج  | LLM                                         |
    | اسم النموذج  | Model ID من CometAPI (يجب أن يتطابق تمامًا) |
    | مفتاح API    | مفتاح CometAPI API الخاص بك                 |
    | API base URL | `https://api.cometapi.com/v1`               |

    انقر على **Save**.

    <Frame>
      <img src="https://mintcdn.com/cometapi/E4FFvyMYmaOZoldp/images/integrations/810968_354447.png?fit=max&auto=format&n=E4FFvyMYmaOZoldp&q=85&s=a6752a58cf43a3c7658da7b276ed5c1e" alt="نموذج موفّر متوافق مع OpenAI في Dify مع تعبئة قيم CometAPI" width="1910" height="1009" data-path="images/integrations/810968_354447.png" />
    </Frame>

    <Frame>
      <img src="https://mintcdn.com/cometapi/E4FFvyMYmaOZoldp/images/integrations/810968_354448.png?fit=max&auto=format&n=E4FFvyMYmaOZoldp&q=85&s=18caf18d11f4f0aa6741471016bcb14f" alt="قائمة النماذج في Dify تعرض إدخال نموذج متوافق مع CometAPI تم حفظه حديثًا" width="1953" height="965" data-path="images/integrations/810968_354448.png" />
    </Frame>
  </Step>
</Steps>

<Tip>
  بالنسبة إلى معرّفات النماذج، راجع [صفحة نماذج CometAPI](/ar/overview/models). يجب أن يتطابق model ID في Dify تمامًا مع المعرّف المستخدم في CometAPI.
</Tip>

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

<AccordionGroup>
  <Accordion title="فشل مفتاح API">
    تأكد من أن مفتاح API صحيح وأن لديه رصيدًا متاحًا.
  </Accordion>

  <Accordion title="فشل model ID">
    تأكد من أن model ID يطابق تمامًا ما يتوقعه CometAPI.
  </Accordion>

  <Accordion title="فشل عنوان URL الأساسي لـ API">
    تأكد من أن عنوان URL الأساسي لـ API يتضمن `/v1` لطريقة OpenAI-compatible.
  </Accordion>

  <Accordion title="مزيد من المساعدة">
    تفضل بزيارة [صفحة دعم CometAPI](https://www.cometapi.com/support/).
  </Accordion>
</AccordionGroup>

<script type="application/ld+json">
  {`
    {
    "@context": "https://schema.org",
    "@graph": [
      {
        "@type": "HowTo",
        "@id": "https://apidoc.cometapi.com/integrations/dify#howto",
        "name": "ربط Dify بـ CometAPI",
        "description": "استخدم هذا الدليل لربط Dify بـ CometAPI من خلال تعيين عنوان URL الأساسي ومفتاح API وخيارات model أو provider.",
        "step": [
          {
            "@type": "HowToStep",
            "@id": "https://apidoc.cometapi.com/integrations/dify#step-1",
            "position": 1,
            "name": "احصل على مفتاح API الخاص بك في CometAPI",
            "text": "أنشئ حساب CometAPI الخاص بك أو افتحه، ثم انسخ مفتاح API نشطًا من لوحة التحكم."
          },
          {
            "@type": "HowToStep",
            "@id": "https://apidoc.cometapi.com/integrations/dify#step-2",
            "position": 2,
            "name": "ثبّت إضافة CometAPI في Dify",
            "text": "أكمل خطوة تثبيت إضافة CometAPI في Dify ضمن دليل ربط Dify بـ CometAPI."
          },
          {
            "@type": "HowToStep",
            "@id": "https://apidoc.cometapi.com/integrations/dify#step-3",
            "position": 3,
            "name": "أضف مفتاح API الخاص بك",
            "text": "أكمل خطوة إضافة مفتاح API الخاص بك ضمن دليل ربط Dify بـ CometAPI."
          },
          {
            "@type": "HowToStep",
            "@id": "https://apidoc.cometapi.com/integrations/dify#step-4",
            "position": 4,
            "name": "أضف النماذج",
            "text": "أكمل خطوة إضافة النماذج ضمن دليل ربط Dify بـ CometAPI."
          },
          {
            "@type": "HowToStep",
            "@id": "https://apidoc.cometapi.com/integrations/dify#step-5",
            "position": 5,
            "name": "اختبر الاتصال",
            "text": "حدّد model ID حاليًا من صفحة نماذج CometAPI، ثم أرسل طلب اختبار من عملية التكامل."
          },
          {
            "@type": "HowToStep",
            "@id": "https://apidoc.cometapi.com/integrations/dify#step-6",
            "position": 6,
            "name": "افتح إعدادات موفّر النموذج",
            "text": "أكمل خطوة فتح إعدادات موفّر النموذج ضمن دليل ربط Dify بـ CometAPI."
          },
          {
            "@type": "HowToStep",
            "@id": "https://apidoc.cometapi.com/integrations/dify#step-7",
            "position": 7,
            "name": "كوّن النموذج",
            "text": "أكمل خطوة تكوين النموذج ضمن دليل ربط Dify بـ CometAPI."
          }
        ]
      },
      {
        "@type": "BreadcrumbList",
        "itemListElement": [
          {
            "@type": "ListItem",
            "position": 1,
            "name": "مستندات CometAPI",
            "item": "https://apidoc.cometapi.com/"
          },
          {
            "@type": "ListItem",
            "position": 2,
            "name": "عمليات التكامل",
            "item": "https://apidoc.cometapi.com/integrations"
          },
          {
            "@type": "ListItem",
            "position": 3,
            "name": "ربط Dify بـ CometAPI",
            "item": "https://apidoc.cometapi.com/integrations/dify"
          }
        ]
      }
    ]
    }
    `}
</script>