الفوترة والاستخدام

مدفوع مسبقاً، ولكل توكن

تُفوتَر خدمة الذكاء الاصطناعي من الرصيد المدفوع مسبقاً نفسه الذي يموّل تطبيقاتك: تستبدل قسيمة، فتُضاف قيمتها إلى رصيدك، ويُقاس استهلاك التوكنات مقابله. لا اشتراك ولا حدّ أدنى. يكلّف الطلب ثمن توكناته بالضبط:

أسعار كل نموذج في النماذج والأسعار؛ وقدّر حِمل عملك عبر حاسبة الأسعار.

التوكنات تُعدّ على الخادم

تعتمد الفوترة على عدد التوكنات الذي تلتقطه بوابتنا من محرّك الاستدلال، لا على أرقام يرسلها العميل أبداً. وكل ردّ يتضمّن هذا العدد في كائن usage:

"usage": {
  "prompt_tokens": 21,
  "completion_tokens": 38,
  "total_tokens": 59
}

في وضع البثّ (streaming) يحمل الجزء الأخير كائن usage نفسه (نفرض تفعيل stream_options.include_usage من جهتنا)، فما تراه في الردّ هو بالضبط ما تُفوتَر عليه: prompt_tokens بسعر الإدخال، وcompletion_tokens بسعر الإخراج.

الخصم كل ساعة

يُسجَّل الاستهلاك لكل طلب، ثم يُخصم من رصيدك مرة كل ساعة كقيد واحد في السجلّ عن كل ساعة استخدام. تظهر هذه الخصومات في سجلّ المعاملات نفسه إلى جانب أرصدة قسائمك، في صفحة الفوترة بالبوابة، حيث تبقى الأرصدة والخصومات قابلة للتدقيق جنباً إلى جنب.

تابع استهلاكك من التوكنات يومياً ولكل نموذج في صفحة الذكاء الاصطناعي في البوابة، أو برمجياً (برمز وصول البوابة):

curl -sS "https://api.alawadi.cloud/v1/ai/usage?from=2026-06-01&to=2026-06-30" \
  -H "Authorization: Bearer $PORTAL_ACCESS_TOKEN"

الردّ هو أعداد توكنات وطلبات فقط، مفصّلة لكل يوم ولكل نموذج. لا يُعيد مبالغ مالية: تُحتسب الكلفة من الأسعار أعلاه، وتظهر الرسوم الفعلية كخصومات ساعية في سجلّ معاملاتك.

{
  "from": "2026-06-01",
  "to": "2026-06-30",
  "rows": [
    {
      "day": "2026-06-12",
      "model": "qwen2.5-7b-instruct",
      "prompt_tokens": 18240,
      "completion_tokens": 9610,
      "requests": 142
    }
  ],
  "totals": {
    "prompt_tokens": 512300,
    "completion_tokens": 244180,
    "requests": 3120
  }
}

صدّر تقرير تدقيق

لمراجعات الامتثال أو تحميل الكلفة (chargeback)، صدّر كل ما فعله حسابك على واجهة الذكاء الاصطناعي — أحداث استهلاك الاستدلال، ودورة حياة مفاتيح الذكاء الاصطناعي (البادئات فقط، لا أسرار أبداً)، ووكلاؤك مع سجلّ نسخهم — من GET /v1/ai/audit (مقيّد بمالك الحساب، برمز وصول البوابة):

curl -sS "https://api.alawadi.cloud/v1/ai/audit?from=2026-06-01&to=2026-06-30&format=json" \
  -H "Authorization: Bearer $PORTAL_ACCESS_TOKEN"

تكون النافذة الزمنية افتراضياً آخر 30 يوماً. ويحدّد kind=usage|keys|agents مجموعة جزئية (الافتراضي: الثلاثة كلها)؛ أما format=csv فينزّل ملفاً جاهزاً لجداول البيانات ويتطلّب kind واحداً، بجدول واحد لكل ملف. كامل المعاملات والمخطّطات في مرجع API وكلاء الذكاء الاصطناعي.

نفاد الرصيد والتعليق

يجري فحص للرصيد قبل كل طلب، وقبل توليد أي توكن:

• رصيد صفر (أو لا رصيد بعد) ← يُرفض الطلب بـ 402 وبالرمز INSUFFICIENT_BALANCE. لا تُستهلك أي توكنات، ولا يُحتسب عليك شيء.
• حساب معلّق بسبب الفوترة ← تُرفض الطلبات بـ 403 وبالرمز ACCOUNT_SUSPENDED. وهو التعليق نفسه الذي يوقف تطبيقاتك عندما يبقى الرصيد صفراً بعد فترة السماح.

الحالتان تزولان من تلقاء نفسيهما: استبدل قسيمة فتعود الطلبات إلى النجاح. دون حاجة إلى تذكرة دعم.