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

# ابدأ مع CometAPI: أنشئ مفتاح API وأجرِ أول طلب

> ابدأ مع CometAPI من خلال إنشاء مفتاح API، وضبط base URL، وإرسال أول طلب API باستخدام curl أو Python أو Node.js.

## أنشئ حسابًا ومفتاح API

أنشئ حساب CometAPI ومفتاح API قبل استدعاء API.

<Steps>
  <Step title="سجّل الدخول أو أنشئ حسابًا">
    افتح [صفحة تسجيل الدخول إلى CometAPI](https://www.cometapi.com/console/login). تابع باستخدام Google، أو تابع باستخدام GitHub، أو أدخل بريدك الإلكتروني أو اسم المستخدم. إذا لم يكن لديك حساب، فأكمل إنشاء الحساب من هذه الصفحة.

    <Frame>
      <img src="https://mintcdn.com/cometapi/BtE3Lagaukxd3efj/images/overview/cometapi-console-login.png?fit=max&auto=format&n=BtE3Lagaukxd3efj&q=85&s=988bee0055bf1ce2552a8d877a48a97d" alt="صفحة تسجيل الدخول إلى CometAPI مع خيارات تسجيل الدخول عبر Google وGitHub والبريد الإلكتروني" width="1280" height="720" data-path="images/overview/cometapi-console-login.png" />
    </Frame>
  </Step>

  <Step title="افتح مفاتيح API">
    بعد تسجيل الدخول، افتح [صفحة مفتاح API](https://www.cometapi.com/console/token). يمكنك أيضًا اختيار **API Keys** من الشريط الجانبي في لوحة التحكم.
  </Step>

  <Step title="أنشئ مفتاح API">
    انقر على **Create API Key**، وأدخل اسمًا واضحًا مثل `local-test`، واترك **Unlimited Quota** مفعّلًا للاختبار الأول ما لم تكن تريد تعيين حد للإنفاق. انقر على **Create**.

    <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="صفحة مفاتيح API في CometAPI مع تمييز زر Create API Key ومربع حوار الإنشاء" width="3824" height="1892" data-path="images/overview/810968_364191.png" />
    </Frame>
  </Step>

  <Step title="انسخ مفتاح API">
    انقر على زر النسخ في عمود **Key**. خزّن المفتاح المنسوخ في متغير بيئة على جانب الخادم أو في ملف `.env` محلي. لا تلصق مفتاح API حقيقيًا في المستودعات العامة أو كود الواجهة الأمامية أو لقطات الشاشة أو تذاكر الدعم.

    <Frame>
      <img src="https://mintcdn.com/cometapi/HhtmQffktazbxUvS/images/overview/810968_364193.png?fit=max&auto=format&n=HhtmQffktazbxUvS&q=85&s=d893f659267150d0faf45f99eb5dffc1" alt="جدول مفاتيح API في CometAPI مع تمييز زر النسخ لمفتاح API مخفي" width="2434" height="1232" data-path="images/overview/810968_364193.png" />
    </Frame>
  </Step>
</Steps>

تقرأ أمثلة الطلبات `COMETAPI_KEY` من بيئتك.

## خزّن مفتاح API محليًا

للاختبار المحلي، صدّر مفتاح API كمتغير بيئة:

```bash theme={null}
read -rsp "CometAPI API key: " COMETAPI_KEY
printf '\n'
export COMETAPI_KEY
```

## Base URL

استخدم base URL هذا مع SDKs المتوافقة مع OpenAI واستدعاءات API:

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

## التحويل من OpenAI خلال 30 ثانية

بعد أن يصبح لديك مفتاح API من CometAPI، استخدم هذا التغيير ذي الإعدادين عند تحويل عميل OpenAI SDK إلى CometAPI:

```diff theme={null}
- base_url="https://api.openai.com/v1"
- api_key=os.environ["OPENAI_API_KEY"]
+ base_url="https://api.cometapi.com/v1"
+ api_key=os.environ["COMETAPI_KEY"]
```

تستخدم CometAPI تنسيقات طلبات متوافقة مع OpenAI لسير العمل الشائعة الخاصة بالنصوص والصور والصوت والفيديو. إذا كان تطبيقك يستخدم OpenAI SDK بالفعل، فابدأ بتغيير base URL ومفتاح API.

## أجرِ أول استدعاء لك

بعد تعيين `COMETAPI_KEY` في بيئتك، استبدل `your-model-id` بـ model ID حالي من [صفحة Models](/ar/overview/models).

<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 a one-sentence bedtime story."
        }
      ]
    }'
  ```

  ```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 a one-sentence bedtime story.",
          }
      ],
  )

  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 a one-sentence bedtime story.",
      },
    ],
  });

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

## اختر نموذجًا

اختر model ID من [صفحة Models](/ar/overview/models)، ثم مرّر هذه القيمة في الحقل `model`.

| الهدف                    | من أين تبدأ                                                                                                     |
| ------------------------ | --------------------------------------------------------------------------------------------------------------- |
| الدردشة أو النصوص العامة | استخدم نموذج GPT أو Claude أو Gemini أو DeepSeek أو أي نموذج دردشة آخر مع [Chat Completions](/api/text/chat).   |
| البرمجة والاستدلال       | استخدم نموذج برمجة أو استدلال مع [Responses](/api/text/responses) عندما يتطلب النموذج واجهة Responses API.      |
| إنشاء الصور              | استخدم نموذج صور مع [Create image](/api/image/openai/images) أو دليل صور خاصًا بموفر الخدمة.                    |
| إنشاء الفيديو            | استخدم نموذج فيديو مع صفحة video API التي تطابق مسار عمل المزوّد، مثل [Create video](/api/video/sora-2/create). |

## ما التالي

* في حال فشل الطلبات، راجع [Error Codes & Handling](/ar/errors/error-codes-handling).
* لإرشادات إعادة المحاولة، راجع [how to handle rate limits](/api/text/chat#how-to-handle-rate-limits).
* للاستخدام الخاص بكل نموذج، ابدأ بـ [Chat Completions](/api/text/chat) أو [Responses](/api/text/responses) أو [Create image](/api/image/openai/images) أو [Create video](/api/video/sora-2/create).
* لتفاصيل الفوترة، راجع [About Pricing](/ar/pricing/about-pricing).
* لدعوة أعضاء الفريق وإدارة Credits المشتركة، راجع [إدارة فريق باستخدام Workspace](/ar/workspace/overview).
* للحصول على المساعدة، راجع [Help Center](/ar/support/help-center) أو تواصل مع [دعم CometAPI](https://www.cometapi.com/support/).

## الأسئلة الشائعة

<AccordionGroup>
  <Accordion title="كيف يمكنني إنشاء حساب CometAPI؟">
    افتح [صفحة تسجيل الدخول إلى CometAPI](https://www.cometapi.com/console/login)، ثم تابع باستخدام Google، أو تابع باستخدام GitHub، أو أدخل بريدك الإلكتروني أو اسم المستخدم. إذا لم يكن لديك حساب، فأكمل إنشاء الحساب من الصفحة نفسها.
  </Accordion>

  <Accordion title="كيف أحصل على مفتاح API لـ CometAPI؟">
    افتح [صفحة مفتاح API](https://www.cometapi.com/console/token) في لوحة تحكم CometAPI، وانقر على **Create API Key**، وأدخل اسمًا، ثم انقر على **Create**، وانسخ مفتاح API الذي تم إنشاؤه. استخدم `$COMETAPI_KEY` في الأمثلة بدلًا من مفتاح API حقيقي.
  </Accordion>

  <Accordion title="أين يجب أن أخزن مفتاح API الخاص بي؟">
    خزّن مفتاح API الخاص بك في متغير بيئة على جانب الخادم أو في ملف `.env` محلي. لا تقم بإرساله إلى المستودعات العامة، ولا تلصقه في كود الواجهة الأمامية، ولا تدرجه في لقطات الشاشة، ولا ترسله في تذاكر الدعم.
  </Accordion>

  <Accordion title="ما هو عنوان URL الأساسي لـ CometAPI لاستدعاءات API؟">
    استخدم `https://api.cometapi.com/v1` مع OpenAI-compatible SDKs ونقاط النهاية مثل `/v1/chat/completions`.
  </Accordion>

  <Accordion title="هل يعمل CometAPI مع OpenAI Python SDK؟">
    نعم. أنشئ عميل `OpenAI`، واضبط `api_key` على مفتاح API الخاص بـ CometAPI، واضبط `base_url` على `https://api.cometapi.com/v1`.
  </Accordion>

  <Accordion title="كيف أنتقل من OpenAI إلى CometAPI؟">
    غيّر عنوان URL الأساسي إلى `https://api.cometapi.com/v1`، واستبدل مفتاح API بمفتاح API الخاص بـ CometAPI، واستخدم model ID من CometAPI من [صفحة Models](/ar/overview/models).
  </Accordion>

  <Accordion title="أي model ID يجب أن أستخدم أولًا؟">
    اختر model ID بحسب حالة الاستخدام. ابدأ من [صفحة Models](/ar/overview/models)، ثم اختر نموذجًا للدردشة أو البرمجة أو الصور أو الفيديو يتوافق مع صفحة API التي تخطط لاستدعائها.
  </Accordion>

  <Accordion title="ما لغات البرمجة التي يدعمها CometAPI؟">
    يعمل CometAPI مع أي لغة برمجة يمكنها إرسال طلبات HTTPS. ابدأ بأمثلة curl وPython وNode.js في هذه الصفحة، أو استخدم OpenAI-compatible SDK يتيح لك تجاوز عنوان URL الأساسي.
  </Accordion>

  <Accordion title="هل يقدّم CometAPI فترة تجريبية مجانية أو مفتاح API مجاني؟">
    يمكنك إنشاء مفتاح API لـ CometAPI من لوحة التحكم. للتحقق من توفر الفترة التجريبية المجانية، وأرصدة الفترة التجريبية المجانية، وتفاصيل الفوترة، راجع [صفحة أسعار CometAPI](https://www.cometapi.com/pricing/) و[حول التسعير](/ar/pricing/about-pricing).
  </Accordion>
</AccordionGroup>

<script type="application/ld+json">
  {`
    {
    "@context": "https://schema.org",
    "@graph": [
      {
        "@type": "HowTo",
        "name": "البدء السريع مع CometAPI: إنشاء مفتاح API وإجراء أول استدعاء لك",
        "description": "دليل البدء السريع لـ CometAPI للمستخدمين الجدد: سجّل الدخول، وأنشئ مفتاح API، وانسخ المفتاح، واضبط عنوان URL الأساسي، وأجرِ أول استدعاء API باستخدام curl أو Python أو Node.js.",
        "step": [
          {
            "@type": "HowToStep",
            "@id": "https://apidoc.cometapi.com/overview/quick-start#sign-in-or-create-an-account",
            "name": "سجّل الدخول أو أنشئ حسابًا",
            "text": "افتح https://www.cometapi.com/console/login وتابع باستخدام Google أو GitHub أو البريد الإلكتروني."
          },
          {
            "@type": "HowToStep",
            "@id": "https://apidoc.cometapi.com/overview/quick-start#open-api-keys",
            "name": "افتح مفاتيح API",
            "text": "بعد تسجيل الدخول، افتح https://www.cometapi.com/console/token أو اختر API Keys من الشريط الجانبي في لوحة التحكم."
          },
          {
            "@type": "HowToStep",
            "@id": "https://apidoc.cometapi.com/overview/quick-start#create-an-api-key",
            "name": "أنشئ مفتاح API",
            "text": "انقر على Create API Key، وأدخل اسمًا، واختر إعداد الحصة، ثم انقر على Create."
          },
          {
            "@type": "HowToStep",
            "@id": "https://apidoc.cometapi.com/overview/quick-start#copy-the-api-key",
            "name": "انسخ مفتاح API",
            "text": "انقر على زر النسخ في عمود Key وخزّن المفتاح في متغير بيئة على جانب الخادم أو في ملف .env محلي."
          },
          {
            "@type": "HowToStep",
            "name": "اضبط عنوان URL الأساسي",
            "text": "استخدم https://api.cometapi.com/v1 كعنوان URL أساسي مع OpenAI-compatible SDKs واستدعاءات API."
          },
          {
            "@type": "HowToStep",
            "name": "أجرِ أول استدعاء لك",
            "text": "استدعِ /v1/chat/completions باستخدام curl أو Python أو Node.js، واستبدل your-model-id بـ model ID حالي من صفحة Models في CometAPI."
          }
        ]
      },
      {
        "@type": "FAQPage",
        "mainEntity": [
          {
            "@type": "Question",
            "name": "كيف يمكنني إنشاء حساب CometAPI؟",
            "acceptedAnswer": {
              "@type": "Answer",
              "text": "افتح صفحة تسجيل الدخول إلى CometAPI وتابع باستخدام Google أو GitHub أو البريد الإلكتروني. إذا لم يكن لديك حساب، فأكمل إنشاء الحساب من الصفحة نفسها."
            }
          },
          {
            "@type": "Question",
            "name": "كيف أحصل على مفتاح API لـ CometAPI؟",
            "acceptedAnswer": {
              "@type": "Answer",
              "text": "افتح صفحة مفتاح API في لوحة تحكم CometAPI، وانقر على Create API Key، وأدخل اسمًا، ثم انقر على Create، وانسخ مفتاح API الذي تم إنشاؤه."
            }
          },
          {
            "@type": "Question",
            "name": "أين يجب أن أخزن مفتاح API الخاص بي؟",
            "acceptedAnswer": {
              "@type": "Answer",
              "text": "خزّن مفتاح API الخاص بك في متغير بيئة على جانب الخادم أو في ملف .env محلي. لا تقم بإرساله إلى المستودعات العامة، ولا تلصقه في كود الواجهة الأمامية، ولا تدرجه في لقطات الشاشة، ولا ترسله في تذاكر الدعم."
            }
          },
          {
            "@type": "Question",
            "name": "ما هو عنوان URL الأساسي لـ CometAPI لاستدعاءات API؟",
            "acceptedAnswer": {
              "@type": "Answer",
              "text": "استخدم https://api.cometapi.com/v1 مع OpenAI-compatible SDKs ونقاط النهاية."
            }
          },
          {
            "@type": "Question",
            "name": "هل يعمل CometAPI مع OpenAI Python SDK؟",
            "acceptedAnswer": {
              "@type": "Answer",
              "text": "نعم. أنشئ عميل OpenAI، واضبط api_key على مفتاح API الخاص بـ CometAPI، واضبط base_url على https://api.cometapi.com/v1."
            }
          },
          {
            "@type": "Question",
            "name": "كيف أنتقل من OpenAI إلى CometAPI؟",
            "acceptedAnswer": {
              "@type": "Answer",
              "text": "غيّر عنوان URL الأساسي إلى https://api.cometapi.com/v1، واستبدل مفتاح API بمفتاح API الخاص بـ CometAPI، واستخدم model ID من CometAPI من صفحة Models."
            }
          },
          {
            "@type": "Question",
            "name": "أي model ID يجب أن أستخدم أولًا؟",
            "acceptedAnswer": {
              "@type": "Answer",
              "text": "اختر model ID بحسب حالة الاستخدام. ابدأ من صفحة Models، ثم اختر نموذجًا للدردشة أو البرمجة أو الصور أو الفيديو يتوافق مع صفحة API التي تخطط لاستدعائها."
            }
          },
          {
            "@type": "Question",
            "name": "ما لغات البرمجة التي يدعمها CometAPI؟",
            "acceptedAnswer": {
              "@type": "Answer",
              "text": "يعمل CometAPI مع أي لغة برمجة يمكنها إرسال طلبات HTTPS. ابدأ بأمثلة curl وPython وNode.js، أو استخدم OpenAI-compatible SDK يتيح لك تجاوز عنوان URL الأساسي."
            }
          },
          {
            "@type": "Question",
            "name": "هل يقدّم CometAPI فترة تجريبية مجانية أو مفتاح API مجاني؟",
            "acceptedAnswer": {
              "@type": "Answer",
              "text": "يمكنك إنشاء مفتاح API لـ CometAPI من لوحة التحكم. للتحقق من توفر الفترة التجريبية المجانية، وأرصدة الفترة التجريبية المجانية، وتفاصيل الفوترة، راجع صفحة أسعار CometAPI وصفحة حول التسعير."
            }
          }
        ]
      }
    ]
    }
    `}
</script>