API لوحة الحساب

• لوحة الحساب: https://ailoot.ai (تسجيل الدخول باسم المستخدم، وتوكن لوحة الحساب)
• API النماذج: https://api.ailoot.ai (مفتاح sk-…)

المفتاح sk-… لا يحل محل توكن لوحة الحساب، وتوكن لوحة الحساب لا يتيح API النماذج. يُذكر المسار الكامل عند كل طريقة.

curl --fail-with-body "https://ailoot.ai/api/v1/user/profile" \
  -H "Authorization: Bearer $TOKEN"

يتضمن الرد code وmessage وdata. قد يتضمن الخطأ reason وmetadata. يتضمن تقسيم الصفحات في data الحقول items وtotal وpage وpage_size وpages. صيغة كل طريقة موضحة في وصفها.

{
  "code": 0,
  "message": "success",
  "data": {
    "items": [],
    "total": 0,
    "page": 1,
    "page_size": 20,
    "pages": 1
  }
}

يُتحقق من صلاحية توكن لوحة الحساب ومن نشاط المستخدم؛ وإذا فُعّلت ربط الجلسة، يُتحقق أيضاً من IP والمتصفح. تميز الرموز TOKEN_EXPIRED وTOKEN_REVOKED وUSER_INACTIVE وINVALID_TOKEN وFORBIDDEN بين مشكلات الجلسة والصلاحيات. قد يمنع حد المعدل أو تأكيد 2FA إضافي طلباً محدداً.

• تتضمن كل مادة طريقة HTTP والمسار الكامل وشروط الوصول والمعاملات وحقول الجسم والرد.
• خذ المعرّفات من رد سابق: KEY_ID من GET /api/v1/keys، ومعرّف الطلب من GET /api/v1/usage.
• حقول الكائنات وأنواعها موضحة في صفحات «مخططات البيانات».
• تعرض القوالب أسماء الحقول وأنواعها. PLACEHOLDER وTOKEN علامتان تمثيليتان، ولا توجد بيانات حقيقية هنا.
• شحن الرصيد في قسم «الباقات» بلوحة الحساب: كيفية شحن الرصيد.

يتضمن الملف الشخصي balance وfrozen_balance. frozen_balance هو المبلغ المحجوز لطلبات لم تكتمل. تحقق من الحقلين مع السجل.

يعيد GET /api/v1/keys مفاتيحك. الحقول quota و quota_used — حد إنفاق المفتاح والجزء المستخدم منه؛ ip_whitelist, ip_blacklist, status و expires_at تتحكم في استخدام المفتاح؛ rate_limit_5h, rate_limit_1d و rate_limit_7d — حدود الإنفاق لكل نافذة زمنية.

curl --fail-with-body "https://ailoot.ai/api/v1/keys" \
  -H "Authorization: Bearer $TOKEN"

# KEY_ID هو id الخاص بمفتاحك من استجابة القائمة
curl --fail-with-body "https://ailoot.ai/api/v1/keys/$KEY_ID" \
  -H "Authorization: Bearer $TOKEN"

يعرض السجل وdashboard الحقل actual_cost بوصفه الخصم الفعلي، والحقل total_cost بوصفه التكلفة بالسعر القياسي. تُذكر فلاتر التاريخ والنموذج والمفتاح ونوع الطلب عند الطريقة. تتطلب تغييرات كلمة المرور وTOTP وpasskey التأكيدات الموضحة عند طرقها.

في هذا القسم: 39 طريقة.