> ## 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.

# البدء السريع مع واجهة API المتوافقة مع OpenAI: إرسال طلبات Chat Completions باستخدام CometAPI

> استخدم CometAPI كعنوان base URL متوافق مع OpenAI API لطلبات Chat Completions باستخدام curl وPython وNode.js وOpenAI SDKs.

هذه الصفحة هي دليل بدء سريع لواجهة API المتوافقة مع OpenAI من CometAPI. تساعدك على إعادة استخدام صيغة طلب Chat Completions، وOpenAI SDKs، وعنوان base URL الخاص بـ CometAPI. وهي ليست دليلاً لإعداد حساب OpenAI أو صفحة خاصة بنماذج OpenAI فقط.

## ما الذي ستبنيه

سترسل طلبًا نصيًا واحدًا إلى المسار المتوافق مع OpenAI `POST /v1/chat/completions` في CometAPI، وتطبع رسالة المساعد، وتُبقي صيغة الطلب جاهزة للتطبيقات التي تستخدم OpenAI SDKs بالفعل.

## متى تستخدم هذه الصفحة

استخدم هذا الدليل السريع عندما ينطبق أحد ما يلي على مشروعك:

* أنت تستخدم بالفعل OpenAI SDKs أو صيغ طلبات Chat Completions.
* تريد تبديل base URL إلى CometAPI.
* تريد استدعاء model ID من CometAPI عبر مسار متوافق مع OpenAI API.

## المتطلبات المسبقة

* مفتاح CometAPI API مخزّن في `COMETAPI_KEY`
* model ID نصي من [صفحة النماذج](/ar/overview/models)
* `curl` أو Python 3.10+ أو Node.js 18+

## مفتاح API وbase URL والمصادقة

استخدم عنوان base URL الخاص بـ CometAPI مع العملاء المتوافقين مع OpenAI:

```text theme={null}
https://api.cometapi.com/v1
```

قم بمصادقة طلبات HTTP المباشرة باستخدام Bearer token:

```text theme={null}
Authorization: Bearer $COMETAPI_KEY
```

## أمثلة على الشيفرة

استخدم علامات التبويب أدناه لإرسال طلب Chat Completions نفسه باستخدام cURL وPython وNode.js.

<CodeGroup>
  ```bash cURL theme={null}
  curl https://api.cometapi.com/v1/chat/completions \
    -H "Authorization: Bearer $COMETAPI_KEY" \
    -H "Content-Type: application/json" \
    -d '{
      "model": "your-model-id",
      "messages": [
        {
          "role": "user",
          "content": "Write one sentence about CometAPI."
        }
      ]
    }'
  ```

  ```python Python theme={null}
  import os
  from openai import OpenAI

  client = OpenAI(
      api_key=os.environ["COMETAPI_KEY"],
      base_url="https://api.cometapi.com/v1",
  )

  completion = client.chat.completions.create(
      model="your-model-id",
      messages=[
          {
              "role": "user",
              "content": "Write one sentence about CometAPI.",
          }
      ],
  )

  print(completion.choices[0].message.content)
  ```

  ```javascript Node.js theme={null}
  import OpenAI from "openai";

  const client = new OpenAI({
    apiKey: process.env.COMETAPI_KEY,
    baseURL: "https://api.cometapi.com/v1",
  });

  const completion = await client.chat.completions.create({
    model: "your-model-id",
    messages: [
      {
        role: "user",
        content: "Write one sentence about CometAPI.",
      },
    ],
  });

  console.log(completion.choices[0].message.content);
  ```
</CodeGroup>

## شرح التدفق

كونها متوافقة مع OpenAI يعني أن تطبيقك يحتفظ بنقطة نهاية Chat Completions، وجسم الطلب، وأسماء أساليب SDK، مع تغيير base URL وmodel ID إلى قيم CometAPI.

يكون المسار متزامنًا افتراضيًا. تعيد API كائن الاستجابة المكتملة في استجابة HTTP واحدة، ويقرأ تطبيقك `choices[0].message.content`.

للحصول على مخرجات تدريجية، اضبط `stream` على `true`. تصبح الاستجابة Server-Sent Events وتنتهي بـ `data: [DONE]`. استخدم Streaming لواجهات الدردشة والاستجابات الطويلة. واحتفظ بالشكل المتزامن للمهام الخلفية والاختبارات البسيطة.

## المعلمات الشائعة

| المعلمة                 | الاستخدام                                                                              |
| ----------------------- | -------------------------------------------------------------------------------------- |
| `model`                 | model ID الخاص بـ CometAPI لنموذج يدعم النص.                                           |
| `messages`              | مصفوفة المحادثة. ابدأ برسالة `user` واحدة لطلب بسيط.                                   |
| `temperature`           | يتحكم في العشوائية. القيم الأقل تجعل المخرجات أكثر حتمية.                              |
| `max_completion_tokens` | يضع حدًا أقصى للمخرجات المُولدة لعائلات النماذج التي تستخدم ميزانيات completion-token. |
| `stream`                | يبث أجزاء الاستجابة بشكل تدريجي عند ضبطه على `true`.                                   |
| `response_format`       | يطلب مخرجات JSON عندما يدعمها النموذج المحدد.                                          |

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

<AccordionGroup>
  <Accordion title="هل هذه هي OpenAI API؟">
    لا. هذا هو مسار API المتوافق مع OpenAI من CometAPI. أنت تستخدم مفتاح API خاص بـ CometAPI، وbase URL الخاص بـ CometAPI، وmodel ID خاص بـ CometAPI.
  </Accordion>

  <Accordion title="يعيد الطلب 401">
    تأكد من أن `COMETAPI_KEY` مُعيَّن في نفس shell أو runtime الذي يرسل الطلب. لا تلصق مفتاحًا حقيقيًا في ملفات المصدر.
  </Accordion>

  <Accordion title="لم يتم العثور على model">
    استخدم model ID من CometAPI يدعم طلبات النص أو الدردشة. تحقق من صفحة Models قبل إعادة المحاولة.
  </Accordion>

  <Accordion title="لا يزال SDK يستدعي OpenAI">
    تأكد من أن العميل يعيّن `base_url` في Python أو `baseURL` في Node.js إلى `https://api.cometapi.com/v1`.
  </Accordion>
</AccordionGroup>

## الخطوات التالية

* اقرأ [مرجع Chat Completions API](/api/text/chat).
* قم بإعداد عملاء SDK في [استخدام CometAPI مع OpenAI SDKs](/ar/guides/use-cometapi-with-openai-sdk).
* اعرض النماذج المتاحة باستخدام [سرد نماذج CometAPI المتاحة](/ar/guides/how-to-list-available-models).
* أضف معالجة إعادة المحاولة وحدّ المعدل باستخدام [رموز الأخطاء واستراتيجية إعادة المحاولة](/ar/guides/error-codes-and-retry-strategy).