> ## 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 للنصوص والدردشة

> اختر واجهة CometAPI للنصوص والدردشة التي تناسب تنسيق طلبك: Chat Completions أو Responses أو Anthropic Messages أو Gemini content generation.

استخدم وثائق نماذج النصوص في CometAPI عبر مطابقة تنسيق طلبك مع الصفحة التي تنفّذه. للدردشة المتوافقة مع OpenAI، ابدأ بـ Chat Completions أو Responses؛ وللتنسيقات الأصلية الخاصة بالمزوّدين، استخدم صفحة المزوّد المطابقة.

## اختر واجهة API للنصوص والدردشة

<CardGroup cols={2}>
  <Card title="إنشاء Chat Completion" icon="message" href="/api/text/chat">
    أرسل رسائل دردشة متوافقة مع OpenAI باستخدام مصفوفة `messages`.
  </Card>

  <Card title="إنشاء استجابة نموذج" icon="sparkles" href="/api/text/responses">
    استخدم reasoning والمخرجات Multimodal والأدوات المدمجة عبر Responses API.
  </Card>

  <Card title="إنشاء Message" icon="message" href="/api/text/anthropic-messages">
    نفّذ مسارات عمل Messages المتوافقة مع Claude باستخدام حقول أصلية خاصة بالمزوّد.
  </Card>

  <Card title="توليد محتوى" icon="sparkles" href="/api/text/gemini-generating-content">
    أرسل طلبات توليد محتوى أصلية لـ Gemini.
  </Card>
</CardGroup>

## استدعاء نموذج نصي

استخدم أي model ID يدعم النصوص من [صفحة Models](/ar/overview/models) أو [دليل النماذج](https://www.cometapi.com/models/). تستدعي الأمثلة أدناه نقطة النهاية Chat Completions المتوافقة مع OpenAI.

<Note>
  تستخدم هذه الأمثلة العنصر النائب `your-model-id`. استبدله بـ model ID متاح للنصوص من [صفحة Models](/ar/overview/models) أو [دليل النماذج](https://www.cometapi.com/models/) قبل تشغيل الطلب.
</Note>

<CodeGroup>
  ```python Python theme={null}
  import os
  import requests

  response = requests.post(
      "https://api.cometapi.com/v1/chat/completions",
      headers={
          "Authorization": "Bearer " + os.environ["COMETAPI_KEY"],
          "Content-Type": "application/json",
      },
      json={
          "model": "your-model-id",
          "messages": [
              {
                  "role": "user",
                  "content": "Write one sentence about CometAPI.",
              }
          ],
      },
      timeout=30,
  )

  response.raise_for_status()
  result = response.json()
  print(result["choices"][0]["message"]["content"])
  ```

  ```javascript Node.js theme={null}
  const response = await fetch("https://api.cometapi.com/v1/chat/completions", {
    method: "POST",
    headers: {
      Authorization: `Bearer ${process.env.COMETAPI_KEY}`,
      "Content-Type": "application/json",
    },
    body: JSON.stringify({
      model: "your-model-id",
      messages: [
        {
          role: "user",
          content: "Write one sentence about CometAPI.",
        },
      ],
    }),
  });

  if (!response.ok) {
    throw new Error(await response.text());
  }

  const result = await response.json();
  console.log(result.choices[0].message.content);
  ```

  ```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."
        }
      ]
    }'
  ```
</CodeGroup>

## مثال على الاستجابة

قد تبدو الاستجابة الناجحة كما يلي. تختلف قيم الحقول حسب النموذج والطلب:

```json theme={null}
{
  "id": "chatcmpl_example",
  "object": "chat.completion",
  "created": 1779960520,
  "model": "your-model-id",
  "choices": [
    {
      "index": 0,
      "message": {
        "role": "assistant",
        "content": "CometAPI lets developers route model requests through one API surface."
      },
      "finish_reason": "stop"
    }
  ],
  "usage": {
    "prompt_tokens": 12,
    "completion_tokens": 14,
    "total_tokens": 26
  }
}
```

## سجلات model نموذجية

<Info>
  يوضّح هذا المثال لاستجابة فهرس النماذج غلاف `/api/models` وشكل سجل واحد لنموذج نصي. وهو ليس قائمة نماذج كاملة.
</Info>

```bash cURL theme={null}
curl https://api.cometapi.com/api/models
```

```json theme={null}
{
  "success": true,
  "page": 1,
  "page_size": 20,
  "total": 302,
  "data": [
    {
      "created": 1773798949,
      "id": "your-text-model-id",
      "code": "your-text-model-id",
      "provider": "ExampleProvider",
      "provider_code": "example",
      "name": "Example text model",
      "model_type": "text",
      "features": [
        "text-to-text"
      ],
      "endpoints": "{\n  \"openai-chat\": {\n    \"path\": \"/v1/chat/completions\",\n    \"method\": \"POST\"\n  }\n}",
      "pricing": {
        "currency": "USD / M Tokens",
        "input": 0.5,
        "output": 1.5,
        "per_request": null,
        "per_second": null
      }
    }
  ]
}
```

## الأخطاء الشائعة

<AccordionGroup>
  <Accordion title="مفتاح API مفقود أو غير صالح">
    أرسل `Authorization: Bearer $COMETAPI_KEY`.
  </Accordion>

  <Accordion title="عنوان URL أساسي خاطئ">
    استخدم `https://api.cometapi.com/v1` للطلبات المتوافقة مع OpenAI.
  </Accordion>

  <Accordion title="نوع model خاطئ">
    اختر نموذجًا يدعم النص من [صفحة Models](/ar/overview/models).
  </Accordion>

  <Accordion title="خطأ في parameter خاص بمزوّد الخدمة">
    أزل الحقول الاختيارية، ثم أعد إضافة الحقول واحدًا تلو الآخر.
  </Accordion>
</AccordionGroup>

## رموز الأخطاء واستراتيجية إعادة المحاولة

<AccordionGroup>
  <Accordion title="400">
    لا تُعد المحاولة حتى يتم إصلاح نص الطلب.
  </Accordion>

  <Accordion title="401">
    لا تُعد المحاولة حتى يكون مفتاح API موجودًا وصالحًا.
  </Accordion>

  <Accordion title="404">
    تحقّق من عنوان URL الأساسي والمسار وmodel ID قبل إعادة المحاولة.
  </Accordion>

  <Accordion title="429">
    أعد المحاولة باستخدام exponential backoff وقلّل التوازي.
  </Accordion>

  <Accordion title="500 or 503">
    أعد المحاولة مع backoff لأخطاء المزوّد أو الخدمة المؤقتة.
  </Accordion>
</AccordionGroup>

<Tip>
  للاطلاع على أنماط التنفيذ، راجع [Error codes and retry strategy](/ar/guides/error-codes-and-retry-strategy) و[Rate limits and concurrency](/ar/guides/rate-limits-and-concurrency).
</Tip>

## التسعير ودليل النماذج

<CardGroup cols={3}>
  <Card title="صفحة Models" icon="list" href="/overview/models">
    اقرأ كيف يعرِض CometAPI معرّفات model في الوثائق.
  </Card>

  <Card title="دليل النماذج" icon="puzzle-piece" href="https://www.cometapi.com/models/">
    تصفّح توفّر النماذج وإمكاناتها.
  </Card>

  <Card title="التسعير" icon="tag" href="https://www.cometapi.com/pricing/">
    تحقّق من التسعير قبل استدعاء model.
  </Card>
</CardGroup>