التوثيق
البدايةالبدء السريع
البداية

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

Markdown

أول رد من نموذج عبر 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أي لغة، دون تبعيات، للتحقق من المفتاح بسرعة
OpenAI SDKPython وNode.js؛ أي نموذج من الكتالوج بصيغة OpenAI
Anthropic SDKClaude وغيره من النماذج بصيغة Messages
تطبيقات جاهزة85 وكيلاً ومحرراً وتطبيق دردشة: 77 بإعداد جاهز، و8 أخرى قيد التحقق

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

احصل على المفتاح

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

    أنشئ حساباً على ailoot.ai/register. ثم سجل الدخول عبر ailoot.ai/login.

  2. اشحن الرصيد

    افتح قسم «الباقات» في لوحة الحساب: شحن لمرة واحدة يبدأ من $18 أو اشتراك مع مكافأة على الرصيد. التفاصيل: شحن الرصيد و الاشتراكات.

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

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

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

أرسل أول طلب

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

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

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

200 OK
{
  "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
  }
}

الرد المتدفق

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

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)

اختر النموذج

الحقل model — المعرّف الدقيق من كتالوج النماذج أو من رد 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

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

هل لديك أسئلة أخرى؟ أرسل Request ID ووصفاً للمشكلة وسنساعدك على فهمها.مراسلة الدعم
المزيد من التفاصيل

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

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

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

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

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

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

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

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

الاشتراك
اختر خطة بخصم لطلباتك المنتظمة.
رمز خصم حتى 50%
أدخل الرمز عند الشراء. يعاد حساب السعر وفق العرض الساري.
المصروفات في السجل
يحفظ النموذج والرموز والمبلغ لكل طلب.

اختر اشتراكا · اعرض أسعار النماذج

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

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

تطبيق تجاري
أضف توليد النص والصور والفيديو والصوت إلى ميزات خدمتك المدفوعة.
ترخيص إعادة البيع
أرسل وصف المشروع وطريقة توفير الوصول. اطلب شروط استخدام وإعادة بيع مكتوبة.
المستندات على الموقع
العرض واتفاقية الترخيص وسياسة معالجة البيانات متاحة قبل الربط.

اطلب ترخيص إعادة بيع · العرض واتفاقية الترخيص

الأسئلة

كيف أرسل أول طلب 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%؟

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