# البداية السريعة: أول طلب إلى Claude أو GPT أو Gemini

> أرسل أول طلب إلى Claude أو GPT أو Gemini عبر عنوان واحد متوافق مع OpenAI، في 5 خطوات.

آخر تحديث: 2026-10-03

إذا كان لديك كود يعمل مع OpenAI أو Anthropic، فالتغيير سطران: العنوان الأساسي والمفتاح. هذه الخطوات تأخذك من إنشاء الحساب إلى أول رد من النموذج، والمثال الأخير متاح بـ 4 لغات: cURL وPython وJavaScript وPowerShell.

### 1. أنشئ حسابك

سجّل بالبريد الإلكتروني، أو تابع بحساب Google أو GitHub. نطلب رقم الهاتف مرة واحدة لنتواصل معك بشأن حسابك أو رصيدك.

### 2. اشحن رصيدك

طلبات الـ API تُخصم من رصيدك حسب استخدامك، وكل نموذج بأقل من سعره الرسمي. قبل أن تدفع، تعرض لك شاشة الشحن الرصيد الذي سيُضاف إلى حسابك. التفاصيل في [الأسعار والرصيد](https://5abeer.ai/ar/docs/start/pricing.md).

Claude Sonnet 5.5 (`claude-sonnet-5.5`) لكل مليون توكن: الإدخال 0.60 US$ (الرسمي 2 US$)، الإخراج 3 US$ (الرسمي 10 US$). آخر مراجعة للسعر الرسمي: 19 أكتوبر 2026.

### 3. أنشئ مفتاح API

من لوحة التحكم افتح **الـ API ← المفاتيح**، وأنشئ مفتاحًا للمزوّد الذي تريد نماذجه. انسخ المفتاح واحفظه في متغير بيئة:

macOS / Linux:

```bash
export KHABEER_API_KEY="YOUR_5ABEER_API_KEY"
```

Windows:

```powershell
$env:KHABEER_API_KEY = "YOUR_5ABEER_API_KEY"
```

> عامِل هذا المفتاح معاملة كلمة المرور: لا تضعه في كود يعمل داخل المتصفح، ولا تشاركه مع أحد.

### 4. اختر العنوان الأساسي

استخدم العنوان الذي يناسب الكود الذي لديك. كل صيغة تقرأ المفتاح من ترويستها المعتادة.

| الصيغة | العنوان الأساسي | ترويسة المفتاح |
| --- | --- | --- |
| OpenAI | `https://api.5abeer.ai/v1` | `Authorization: Bearer <KEY>` |
| Anthropic | `https://api.5abeer.ai` | `x-api-key: <KEY>` |
| Gemini | `https://api.5abeer.ai/v1beta` | `x-goog-api-key: <KEY>` |

### 5. أرسل أول طلب

انسخ المثال وشغّله في الطرفية التي حفظت فيها المفتاح. اختر الصيغة واللغة، ويمكنك تغيير النموذج من القائمة فوق الكود.

```bash
curl --request POST "https://api.5abeer.ai/v1/chat/completions" \
  --header "Authorization: Bearer $KHABEER_API_KEY" \
  --header "Content-Type: application/json" \
  --data '{"model":"claude-sonnet-5.5","messages":[{"role":"user","content":"اكتب فكرة منتج في سطر واحد"}]}'
```

```python
import os
import requests

response = requests.post(
    "https://api.5abeer.ai/v1/chat/completions",
    headers={
        "Authorization": f"Bearer {os.environ['KHABEER_API_KEY']}",
        "Content-Type": "application/json",
    },
    json={
    "model": "claude-sonnet-5.5",
    "messages": [
        {
            "role": "user",
            "content": "اكتب فكرة منتج في سطر واحد"
        }
    ]
},
    stream=False,
    timeout=60,
)

response.raise_for_status()
print(response.json())
```

إذا وصلك رد بالشكل الظاهر تحت الكود، فكل شيء يعمل.

## إذا لم يعمل الطلب

- [`INVALID_API_KEY`](https://5abeer.ai/ar/docs/help/errors.md#INVALID_API_KEY): المفتاح غير صحيح أو منسوخ ناقصًا. تأكد أن متغير البيئة محفوظ في الطرفية نفسها.
- [`INSUFFICIENT_BALANCE`](https://5abeer.ai/ar/docs/help/errors.md#INSUFFICIENT_BALANCE): الرصيد لا يكفي لهذا الطلب. اشحن رصيدك ثم أعد المحاولة.
- [`MODEL_PLATFORM_NOT_ALLOWED`](https://5abeer.ai/ar/docs/help/errors.md#MODEL_PLATFORM_NOT_ALLOWED): المفتاح لمزوّد آخر. أنشئ مفتاحًا لمزوّد هذا النموذج.

كل الرموز ومعانيها في [الأخطاء وحلولها](https://5abeer.ai/ar/docs/help/errors.md).

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

- [العناوين الأساسية](https://5abeer.ai/ar/docs/start/base-urls.md): استخدم مكتبة OpenAI أو Anthropic دون تغيير الكود.
- [Claude Code](https://5abeer.ai/ar/docs/apps/claude-code.md): شغّل مساعد البرمجة في الطرفية على نماذجنا.
- [النماذج والأسعار](https://5abeer.ai/ar/models): سعرنا بجانب السعر الرسمي لكل نموذج.