Source: https://ailoot.ai/docs/ar/
Canonical: https://ailoot.ai/docs/ar/
Language: ar

[البداية](https://ailoot.ai/docs/ar/) 

# البدء السريع — API الذكاء الاصطناعي: المفتاح والطلب الأول

[Markdown](https://ailoot.ai/docs/ar/index.md)

أول رد من نموذج عبر Ailoot خلال بضع دقائق: مفتاح وعنوان وطلب واحد.

Ailoot واجهة API موحّدة للنماذج العصبية من شركات مختلفة: OpenAI وAnthropic وGoogle وxAI وDeepSeek وAlibaba وMoonshot وZ.ai وMiniMax وNVIDIA وMeta وPoolside وTypeSafe. مفتاح واحد ورصيد واحد بالدولار. يضم الكتالوج 1256 بطاقة نموذج و2692 طريقة موثّقة. تُدرج معرّفات الاستدعاء البديلة أو الأسماء المستعارة ضمن الطريقة المحددة عند توفرها.

يدعم Ailoot ثلاث صيغ API: ‏OpenAI وAnthropic وGemini. لذلك تناسبه حزم SDK الجاهزة ومعظم التطبيقات التي تسمح بتحديد عنوان API مخصص، مثل Claude Code وCodex CLI وCline وCursor وOpen WebUI وn8n وعشرات غيرها.

| الطريقة | حالات الاستخدام المناسبة |
| --- | --- |
| [طلب HTTP](https://ailoot.ai/docs/ar/connect/curl/) | أي لغة، دون تبعيات، للتحقق من المفتاح بسرعة |
| [OpenAI SDK](https://ailoot.ai/docs/ar/connect/openai-sdk/) | Python وNode.js؛ أي نموذج من الكتالوج بصيغة OpenAI |
| [Anthropic SDK](https://ailoot.ai/docs/ar/connect/anthropic-sdk/) | Claude وغيره من النماذج بصيغة Messages |
| [تطبيقات جاهزة](https://ailoot.ai/integrations/ar/) | 85 وكيلاً ومحرراً وتطبيق دردشة: 77 بإعداد جاهز، و8 أخرى قيد التحقق |

هل تحتاج إلى تطبيق محدد؟ افتح [كتالوج التكاملات](https://ailoot.ai/integrations/ar/): تجد لكل تطبيق مكان إدخال العنوان والمفتاح وملف إعداد جاهزاً للنسخ.

## أنشئ مفتاح API الذكاء الاصطناعي

[](https://ailoot.ai/docs/ar/#key)احصل على المفتاح

1. **أنشئ حساباً**

   أنشئ حساباً على [ailoot.ai/register](https://ailoot.ai/register). ثم سجل الدخول عبر [ailoot.ai/login](https://ailoot.ai/login).
2. **اشحن الرصيد**

   افتح قسم «الباقات» في لوحة الحساب: شحن لمرة واحدة يبدأ من $18 أو اشتراك مع مكافأة على الرصيد. التفاصيل: [شحن الرصيد](https://ailoot.ai/docs/ar/billing/topup/) و [الاشتراكات](https://ailoot.ai/docs/ar/billing/subscriptions/).
3. **أنشئ مفتاح API**

   افتح قسم المفاتيح في لوحة الحساب وأنشئ مفتاحاً جديداً. يبدأ المفتاح بـ `sk-`. يمكنك نسخه في قسم مفاتيح لوحة الحساب؛ احفظه مثل كلمة مرور.

احفظ المفتاح في متغير بيئة

```bash
export AILOOT_API_KEY="sk-..."
# اختبار: ينبغي أن تُرجع قائمة النماذج
curl -s https://api.ailoot.ai/v1/models -H "Authorization: Bearer $AILOOT_API_KEY" | head -c 300
```

## [](https://ailoot.ai/docs/ar/#first-request)أرسل أول طلب

عنوان API هو `https://api.ailoot.ai`. لحزم SDK بصيغة OpenAI، العنوان الأساسي هو `https://api.ailoot.ai/v1`، ولـAnthropic وGemini هو `https://api.ailoot.ai` دون لاحقة؛ إذ تضيف هذه الحزم المسار بنفسها.

```bash
curl https://api.ailoot.ai/v1/chat/completions \
  -H "Authorization: Bearer $AILOOT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "claude-sonnet-5-5",
    "messages": [
      {"role": "user", "content": "اشرح في جملتين ما هي API."}
    ]
  }' 
```

```python
from openai import OpenAI
import os

client = OpenAI(max_retries=0, 
    base_url="https://api.ailoot.ai/v1",
    api_key=os.environ["AILOOT_API_KEY"],
)

resp = client.chat.completions.create(
    model="claude-sonnet-5-5",
    messages=[{"role": "user", "content": "اشرح في جملتين ما هي API."}],
)
print(resp.choices[0].message.content)
```

```js
import OpenAI from "openai";

const client = new OpenAI({ maxRetries: 0,
  baseURL: "https://api.ailoot.ai/v1",
  apiKey: process.env.AILOOT_API_KEY,
});

const resp = await client.chat.completions.create({
  model: "claude-sonnet-5-5",
  messages: [{ role: "user", content: "اشرح في جملتين ما هي API." }],
});
console.log(resp.choices[0].message.content);
```

```python
import anthropic
import os

client = anthropic.Anthropic(max_retries=0, 
    base_url="https://api.ailoot.ai",   # دون /v1: تضيف SDK المسار /v1/messages تلقائيًا
    api_key=os.environ["AILOOT_API_KEY"],
)

msg = client.messages.create(
    model="claude-sonnet-5-5",
    max_tokens=1024,
    messages=[{"role": "user", "content": "اشرح في جملتين ما هي API."}],
)
print(msg.content[0].text)
```

يأتي الرد بالصيغة المعتادة. يتضمن القسم `usage` عدد التوكنات المستخدمة للسؤال والرد، وتُحسب قيمة الخصم بناءً عليها.

200 OK

```json
{
  "id": "chatcmpl-8f2c…",
  "object": "chat.completion",
  "created": 1790812800,
  "model": "claude-sonnet-5-5",
  "choices": [
    {
      "index": 0,
      "message": {
        "role": "assistant",
        "content": "API هي اتفاق يحدّد كيف يطلب برنامج من برنامج آخر تنفيذ شيء ما…"
      },
      "finish_reason": "stop"
    }
  ],
  "usage": {
    "prompt_tokens": 21,
    "completion_tokens": 48,
    "total_tokens": 69
  }
}
```

## [](https://ailoot.ai/docs/ar/#streaming)الرد المتدفق

مع `"stream": true` يأتي الرد بصيغة Server-Sent Events كما في واجهات API الأصلية، فتتعامل معه حزم SDK والعملاء دون تعديل. في OpenAI SDK، من الملائم طلب قيمة `usage` النهائية في الحدث الأخير.

يعيد Ailoot الرد النصي المدفوع بعد احتساب التكلفة. لذلك عند استخدام `stream: true` تبقى الصيغة متدفقة (SSE)، لكن النص يأتي دفعة واحدة عند اكتمال النموذج، ولا يصل كلمة بكلمة. إذا استغرق إعداد الرد أكثر من نحو 15 ثانية، تبدأ تدفقات Chat Completions وResponses وMessages بأسطر خدمية `: ping` (كل 10 ثوانٍ تقريباً)، ثم السطر `: ailoot-charged-usd …` بمبلغ الخصم، ثم البيانات نفسها. تتجاهل حزم SDK هذه الأسطر.

```python
stream = client.chat.completions.create(
    model="gpt-6.1-sol",
    messages=[{"role": "user", "content": "اكتب هايكو عن المطر"}],
    stream=True,
    stream_options={"include_usage": True},
)
for chunk in stream:
    if chunk.choices and chunk.choices[0].delta.content:
        print(chunk.choices[0].delta.content, end="", flush=True)
```

```js
const stream = await client.chat.completions.create({
  model: "gpt-6.1-sol",
  messages: [{ role: "user", content: "اكتب هايكو عن المطر" }],
  stream: true,
  stream_options: { include_usage: true },
});
for await (const chunk of stream) {
  process.stdout.write(chunk.choices[0]?.delta?.content ?? "");
}
```

```bash
curl -N https://api.ailoot.ai/v1/chat/completions \
  -H "Authorization: Bearer $AILOOT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model": "gpt-6.1-sol", "stream": true,
       "messages": [{"role": "user", "content": "اكتب هايكو عن المطر"}]}' 
```

## [](https://ailoot.ai/docs/ar/#models)اختر النموذج

الحقل `model` — المعرّف الدقيق من [كتالوج النماذج](https://ailoot.ai/models/ar/) أو من رد `GET /v1/models`. لدى كثير من النماذج أسماء بديلة قصيرة، مثل `claude-sonnet-latest` أو `qwen`. يوضح الكتالوج النموذج الذي يشير إليه الاسم البديل حالياً؛ استخدم ID الدقيق للحصول على نتائج قابلة لإعادة الإنتاج.

| المهمة | بماذا تبدأ |
| --- | --- |
| الكود والوكلاء | `claude-sonnet-5-5`, `gpt-6.1-sol`, `claude-opus-5-5` |
| سريع ومنخفض التكلفة | `gemini-3.8-flash`, `deepseek-v4.1-flash`, `qwen3.8-flash` |
| سياق طويل حتى 1M توكن | `claude-sonnet-5-5`, `deepseek-v4-pro`, `qwen3.8-max` |
| الصور | `gpt-image-2.5`, `gemini-3.1-flash-image`, `grok-imagine-image-2.0` |

لا يتوفر كل نموذج بكل صيغة. مثلاً تعمل نماذج Gemini عبر Anthropic Messages وبصيغتها الأصلية Gemini، أما عبر OpenAI Chat فيعمل فقط `gemini-3.6-flash`. الصيغ التي يدعمها كل نموذج موضحة في [الكتالوج](https://ailoot.ai/models/ar/).

## [](https://ailoot.ai/docs/ar/#next)الخطوة التالية

[**آلية العمل** مسار الطلب والحجز والخصم والأخطاء](https://ailoot.ai/docs/ar/how-it-works/)

[**التوافق** الصيغ والعملاء المدعومون](https://ailoot.ai/docs/ar/compatibility/)

[**التكاملات** 77 تطبيقاً بإعداد جاهز](https://ailoot.ai/integrations/ar/)

[**الأخطاء والحدود** رموز الردود والإجراءات المطلوبة](https://ailoot.ai/docs/ar/errors/)

هل لديك أسئلة أخرى؟ أرسل Request ID ووصفاً للمشكلة وسنساعدك على فهمها.[مراسلة الدعم](mailto:support@ailoot.ai)

## API الذكاء الاصطناعي: المفتاح والطلب الأول

### أين أنشئ مفتاح API الذكاء الاصطناعي؟

افتح قسم المفاتيح في لوحة الحساب وأنشئ مفتاحاً جديداً. يبدأ المفتاح بـ sk-. يمكنك نسخه في قسم مفاتيح لوحة الحساب؛ احفظه مثل كلمة مرور.

اربط Ailoot بخدمة Claude Code أوOpenCode أوHermes أوتطبيقك.

## الشركة ومحفظة مشاريعها

الشركة ومحفظة مشاريعها: ملايين العملاء؛ مبيعات بالمليارات شهريًا.

## اشتر الرموز بخصم.

خصم اشتراك للعمل المنتظم. الرموز الترويجية حتى 50% على شراء الرموز.

الاشتراك

اختر خطة بخصم لطلباتك المنتظمة.

رمز خصم حتى 50%

أدخل الرمز عند الشراء. يعاد حساب السعر وفق العرض الساري.

المصروفات في السجل

يحفظ النموذج والرموز والمبلغ لكل طلب.

[اختر اشتراكا](https://ailoot.ai/docs/ar/billing/subscriptions/) · [اعرض أسعار النماذج](https://ailoot.ai/models/ar/)

## اربط API بالمنتج الذي تبيعه.

SaaS والتطبيقات والبوتات وفق العرض واتفاقية ترخيص Ailoot. لإعادة البيع، اطلب ترخيص موزع.

تطبيق تجاري

أضف توليد النص والصور والفيديو والصوت إلى ميزات خدمتك المدفوعة.

ترخيص إعادة البيع

أرسل وصف المشروع وطريقة توفير الوصول. اطلب شروط استخدام وإعادة بيع مكتوبة.

المستندات على الموقع

العرض واتفاقية الترخيص وسياسة معالجة البيانات متاحة قبل الربط.

[اطلب ترخيص إعادة بيع](mailto:support@ailoot.ai) · [العرض واتفاقية الترخيص](https://ailoot.ai/legal/offer?lang=ar)

## الأسئلة

كيف أرسل أول طلب API؟

أنشئ مفتاح API في Ailoot. اضبط العنوان على https://api.ailoot.ai/v1 عند استخدام OpenAI SDK، أو https://api.ailoot.ai عند استخدام Anthropic وGemini SDK. طلب GET /v1/models مجاني ويعرض النماذج المتاحة لمفتاحك؛ ثم اتبع المثال الخاص بالنموذج وطريقة API المحددين.

أي مفتاح API يجب أن أستخدم؟

استخدم مفتاح API من حسابك في Ailoot في حقل المصادقة الخاص بصيغة العميل المحددة. أرسل GET /v1/models بالمفتاح نفسه للتحقق مجانًا من النماذج المتاحة له؛ مفتاح خدمة أخرى لا يمنحك الوصول إلى Ailoot.

ما الذي أتحقق منه إذا فشل الطلب الأول؟

قارن عنوان API ومفتاح API في Ailoot وID النموذج الدقيق وطريقة API مع بطاقة النموذج ومثال الطلب. اقرأ الخطأ الذي أُعيد إليك؛ وإذا احتجت إلى مساعدة، فأرسل الخطأ وID الطلب إلى support@ailoot.ai دون إرفاق مفتاح API.

ما فائدة الاشتراك؟

خصم على شراء الرموز للعمل المنتظم. اختر خطة بحسب حجم الطلبات؛ وتظهر شروط الاشتراك وتكلفته عند الشراء.

كيف أستخدم رمز خصم حتى 50%؟

أدخل الرمز الترويجي عند شراء الرموز. يعاد حساب المبلغ النهائي وفق شروط العرض؛ ويظهر حجم الخصم قبل الدفع.

## Ailoot · الشركة ومحفظة مشاريعها





تستند Ailoot إلى خبرة تشغيلية متراكمة وقاعدة عملاء واسعة وخدمة مستقرة ومراقبة مستمرة لمؤشرات الأداء KPI.





الشركة ومحفظة مشاريعها: ملايين العملاء؛ مبيعات بالمليارات شهريًا.





توظف Ailoot هذه الخبرة التشغيلية لإتاحة الوصول عبر API إلى قدرات الذكاء الاصطناعي في منتجات العملاء ووكلائهم وتطبيقاتهم وعمليات الأتمتة.