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

# البدء السريع في Claude API: إرسال طلبات Messages باستخدام CometAPI

> استدعِ نماذج Claude عبر Anthropic-compatible Messages API من CometAPI باستخدام curl وPython وNode.js.

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

سترسل طلبًا واحدًا إلى `POST /v1/messages`، وتطبع نص استجابة Claude، وتُبقي الكود جاهزًا لاستخدام Anthropic SDK أو HTTP المباشر.

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

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

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

استخدم نقطة نهاية Messages المتوافقة مع Anthropic عبر CometAPI:

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

قم بمصادقة طلبات HTTP المباشرة باستخدام `x-api-key` وترويسة إصدار Anthropic API:

```text theme={null}
x-api-key: $COMETAPI_KEY
anthropic-version: 2023-06-01
```

## أمثلة الكود

استخدم علامات التبويب أدناه للحصول على أمثلة قابلة للنسخ في cURL وPython وNode.js.

<CodeGroup>
  ```bash cURL theme={null}
  curl https://api.cometapi.com/v1/messages \
    -H "Content-Type: application/json" \
    -H "x-api-key: $COMETAPI_KEY" \
    -H "anthropic-version: 2023-06-01" \
    -d '{
      "model": "your-claude-model-id",
      "max_tokens": 256,
      "messages": [
        {
          "role": "user",
          "content": "Reply with one short sentence."
        }
      ]
    }'
  ```

  ```python Python theme={null}
  import os
  import anthropic

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

  message = client.messages.create(
      model="your-claude-model-id",
      max_tokens=256,
      messages=[
          {
              "role": "user",
              "content": "Reply with one short sentence.",
          }
      ],
  )

  print(message.content[0].text)
  ```

  ```javascript Node.js theme={null}
  import Anthropic from "@anthropic-ai/sdk";

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

  const message = await client.messages.create({
    model: "your-claude-model-id",
    max_tokens: 256,
    messages: [
      {
        role: "user",
        content: "Reply with one short sentence.",
      },
    ],
  });

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

## شرح التدفق

تكون طلبات Claude Messages متزامنة افتراضيًا. تُرجع API كائن message ضمن استجابة HTTP واحدة، ويقرأ تطبيقك أول كتلة محتوى نصية.

استخدم هذا المسار عندما تحتاج إلى أشكال طلب خاصة بـ Claude مثل مصفوفات رسائل Anthropic، أو extended thinking، أو prompt caching، أو استخدام الأدوات. إذا كان تطبيقك يستخدم بالفعل Anthropic SDK الرسمي، فاضبط Base URL الخاص بـ SDK على `https://api.cometapi.com` واحتفظ بشكل طلب Messages API.

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

| Parameter    | الاستخدام                                                  |
| ------------ | ---------------------------------------------------------- |
| `model`      | model ID لنموذج Claude متاح لحسابك.                        |
| `max_tokens` | الحد الأقصى لميزانية Token للاستجابة في Messages API.      |
| `messages`   | مصفوفة رسائل Anthropic بأدوار `user` و`assistant`.         |
| `stream`     | يبث أحداث الرسائل المتزايدة عند ضبطه على `true`.           |
| `thinking`   | يفعّل Claude extended thinking عندما يدعمه النموذج المحدد. |

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

<AccordionGroup>
  <Accordion title="يعيد الطلب 401">
    تأكد من أن `COMETAPI_KEY` مضبوط في نفس shell أو بيئة التشغيل التي ترسل الطلب. لا تلصق مفتاحًا حقيقيًا في ملفات المصدر.
  </Accordion>

  <Accordion title="لا يزال SDK يستدعي Anthropic مباشرة">
    تأكد من أن عميل SDK يضبط `base_url` في Python أو `baseURL` في Node.js على `https://api.cometapi.com`.
  </Accordion>

  <Accordion title="أي نموذج يجب أن أستخدم">
    استخدم model ID لنموذج Claude متاح لحسابك. لا يضع هذا الدليل السريع نموذج Claude ثابتًا لأن التوفر يختلف حسب الحساب وعائلة النموذج.
  </Accordion>
</AccordionGroup>

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

* استخدم [مرجع Anthropic Messages API](/api/text/anthropic-messages) للاطلاع على جميع حقول الطلب والاستجابة.
* تحقّق من توفر النماذج في [Models](/ar/overview/models).
* اضبط جلسات البرمجة المحلية باستخدام [دليل تكامل Claude Code](/ar/integrations/claude-code).
* راجع سلوك إعادة المحاولة في [رموز الأخطاء واستراتيجية إعادة المحاولة](/ar/guides/error-codes-and-retry-strategy).