حجز الرصيد والخصم

• السعر — بالدولار لكل مليون توكن إدخال وإخراج (أو لكل وحدة: صورة أو ثانية فيديو أو محارف). أسعار كل نموذج موضحة في الكتالوج.
• الحجز — قبل إرسال طلب نصي جديد، يحجز Ailoot مبلغًا تقديريًا لتكلفة الإدخال ورد نموذجي وفق الشروط المتفق عليها للطلب. أما الصور والفيديو والصوت في المخرجات، فتظل تكلفة النتيجة كاملة محجوزة.
• خفض الحد بدلاً من الرفض — إذا تجاوز المبلغ المحجوز المحسوب الرصيد المتاح أو حد المفتاح، فلا يمكن خفض حد الرد إلا للنموذج والطريقة المحددين اللذين يلتزمان به، وإلى مقدار يمكن دفع تكلفته فقط، دون النزول عن الحد الأدنى المنطبق. النماذج التي تدعم ذلك موضحة أدناه.
• الخصم — مرة واحدة، بحسب الاستخدام الفعلي الوارد في usage. يُعاد باقي المبلغ المحجوز فوراً.
• إذا كانت تكلفة الرد أعلى من المبلغ المحجوز — يُغطى الفرق من الرصيد المتاح غير المخصص لحجوزات أخرى. لا يتجاوز الخصم رصيدك أبداً، ولا يصبح الرصيد سالباً.
• إذا لم يكفِ المال حتى للحد الأدنى من الحجز — لا يُرسل الطلب إلى النموذج، وتتلقى خطأ 402 بنص مفهوم. لا يُخصم شيء.
• لا تُحسب تكلفة فشل لا ينتج عنه نتيجة. إذا انقطع الاتصال، فتحقق من الطلب باستخدام Request ID في سجل لوحة الحساب قبل إرساله مجدداً.

• الإدخال تُحجز تكلفته بناءً على تقدير حجم الطلب والمرفقات المدعومة، وليس على استهلاك فعلي معلوم مسبقًا. وتستخدم الطلبات النصية الجديدة تقديرًا لجسم الطلب والمرفقات بحسب أنواعها. وينطبق حساب «4 توكنات لكل بايت، وبحد أدنى 4096 توكن» على الحجوزات المقبولة سابقًا في الإصدار القديم، ولا يصف الحجوزات النصية الجديدة. وإذا أُرسل المرفق عبر رابط (fileData) أو فُعّلت أدوات مدمجة، تؤخذ تقديرات منفصلة للمرفقات وعمل الأدوات في الحسبان للطلبات النصية المدعومة؛ فمجرد وجودها لا يعني حجز تكلفة نافذة الإدخال كاملة. وتظل الشروط المتفق عليها سارية على الحجوزات السابقة، بينما تُحسب تكلفة النتيجة كاملة للوسائط في المخرجات.
• المخرجات — يُقدَّر مبلغ حجزها للطلب النصي الجديد وفق طول الرد المعتاد والشروط المتفق عليها. ويُحدد الحد المطلوب عبر max_tokens (max_output_tokens في Responses). لا يساوي الحد المطلوب تلقائيًا عدد التوكنات الذي استُخدم لحساب المبلغ المحجوز، ولا يضمن طول الرد الفعلي في نموذج لا يفرض قيدًا موثوقًا عليه. ولا تُستخدم القيمة الأولية 4096 إلا في المسارات المعنية؛ فالقاعدة المحددة تعتمد على النموذج والطريقة.
• السعر — يراعي حساب الحجوزات النصية الجديدة شروط الطلب: الوضع العادي أو وضع الأولوية، وشرائح الأسعار التي قد يبلغها تقدير الإدخال. ويظل الحساب تحفظيًا ضمن الشروط المختارة؛ فلا يؤدي وضع flex إلى تقليل المبلغ المحجوز. وفي طلب ذي أولوية، قد يراعي الحجز أغلى وضع منطبق، بما في ذلك priority أو flex أو fast. وتحتفظ الحجوزات المقبولة سابقًا دون هذه الشروط بحسابها الأصلي وفق أعلى الأسعار.
• خفض الحد — عندما لا يتوفر ما يغطي المبلغ المحجوز المحسوب، ويتيح النموذج والطريقة المحددان تقييد الرد: يجب أن تكفي الأموال المتاحة لتقدير الإدخال والحد الأدنى للمخرجات. ولا ينخفض الحد المخفّض عن 256 توكن (1025 مع التفكير بصيغة Anthropic). ويتلقى النموذج الحد بعد خفضه.

النموذج claude-sonnet-5-5: الإدخال $2 والإخراج $10 لكل مليون توكن. أرسلت 20 000 توكن، وأجاب النموذج بـ1 200 توكن.

في المثال الحسابي المعروض، تبلغ التكلفة الفعلية $0.0520. ويفترض الخصم الموضح أن المبلغ المحجوز المقبول والرصيد الحر المتاح يغطيان هذه التكلفة. ولا يُحسب المبلغ المحجوز نفسه هنا: إذ يُحدد للطلب النصي الجديد بصورة مستقلة وفق تقدير الإدخال ورد نموذجي، وقد يكون أعلى أو أقل من التكلفة الفعلية. ويُحرر الجزء غير المستخدم من الحجز؛ وتوضح الصيغة أدناه سقف الخصم.

الخصم الفعلي = min(التكلفة الفعلية الكاملة, المبلغ المحجوز المقبول + الرصيد المتاح غير المحجوز). وتظل الحجوزات المفتوحة الأخرى محمية، ولذلك لا يصبح الرصيد الإجمالي صفرًا بالضرورة. ولا يصبح الرصيد سالبًا. وإذا تجاوزت التكلفة الفعلية مجموع المبلغ المحجوز المقبول والرصيد الحر غير المحجوز، بقي الفرق غير المغطى خسارةً على Ailoot؛ فلا يتحول إلى دين عليكم ولا يُحصَّل منكم لاحقًا.

إغلاق الاتصال أو انتهاء مهلة تطبيقك أو الامتناع عن قراءة رد جاهز لا يلغي الطلب تلقائياً: تُحسب تكلفة رد النموذج الجاهز مرة واحدة. إذا لم تُسلّم النتيجة بسبب خطأ من Ailoot، تُعاد الأموال. إذا انقطع الاتصال، فتحقق من الطلب باستخدام Request ID في سجل لوحة الحساب قبل إرساله مجدداً.

• في الطلبات النصية الجديدة، يُحسب المبلغ المحجوز للرد وفق طوله المعتاد، مع مراعاة القيمة المحددة للمعامل max_tokens وشروط النموذج المحدد. هذا تقدير للمبلغ المحجوز، وليس ضمانًا لطول الرد الفعلي أو تكلفته.
• في النماذج التي لا تفرض حدًا موثوقًا لطول الرد الفعلي، لا يتحول تقدير المبلغ المحجوز إلى قيد على الطول. وفي الطلبات النصية الجديدة، لا يُستبدل هذا التقدير تلقائيًا بتكلفة أطول رد ممكن. وتحتفظ الحجوزات المقبولة سابقًا بشروطها الأصلية.
• تضيف صور الإدخال تقدير تكلفتها إلى المبلغ المحجوز.
• يرسل الوكلاء (Claude Code وCodex CLI وCline) سياقاً كبيراً في كل خطوة؛ وقد تحجز الخطوة الواحدة عشرات السنتات. احتفظ ببضعة دولارات على الأقل في الرصيد.
• نصيحة: حدد قيمة معقولة لـ max_tokens — فهذا يقلل الحجز في النماذج التي يمكن تقييد طول ردها.

للنماذج التي تدعم التخزين المؤقت أسعار منفصلة للكتابة في الذاكرة المؤقتة والقراءة منها. تكون القراءة عادةً أرخص بعدة مرات من الإدخال العادي. تظهر الأسعار في بطاقة النموذج في الكتالوج.

إذا لم يكفِ الرصيد المتاح حتى للحد الأدنى من الحجز، فلا يرسل Ailoot الطلب، ويعيد 402 بالرمز insufficient_balance. إذا استُنفد الحد الإجمالي لإنفاق المفتاح، يكون الرمز api_key_quota_exhausted. إذا كان على الحساب دين بسبب دفعة محل اعتراض، يكون الرمز payment_disputed: تُوقف الطلبات الجديدة حتى تسديده.

{
  "error": {
    "code": "insufficient_balance",
    "reason": "insufficient_balance",
    "type": "insufficient_quota",
    "param": null,
    "message": "Your balance is too low to start this request. … Request ID: 5c0e7a1d-….",
    "request_id": "5c0e7a1d-…"
  }
}

سجل الطلبات والخصومات متاح في لوحة الحساب على ailoot.ai. يظهر لكل طلب النموذج والتوكنات والمبلغ.