تحديد الحد الفعلي
المعدل الفعلي هو الأقل بين حد الحساب وحد بيان الاعتماد. تُقاس الدفعة خلال عشر
ثوانٍ. تعني الحصة الشهرية
0 أنها غير محدودة؛ وإلا يُصفّر العداد مع بداية كل
شهر ميلادي بتوقيت UTC.
الطلبات المرفوضة قبل قبولها لا تستهلك الحصة الشهرية. بعد القبول يُحسب الطلب
حتى لو أعادت نقطة النهاية خطأ تحقق أو خطأ تطبيق آخر. حركة لوحة التحكم المسجلة
لا تُحسب ضمن استخدام API للمطورين.
قد تحتفظ بعض مسارات الذكاء الاصطناعي المكلفة بحد إضافي خاص بها. يجب أن يسمح
كل من حد الحساب/المفتاح وحد المسار بالطلب.
ترويسات الاستجابة
تتضمن الاستجابات الموثقة المقبولة أو المحدودة:X-RateLimit-Limit هو حد بيان الاعتماد الفعلي في الدقيقة، ويمثل
X-RateLimit-Remaining أقل رصيد متبقٍ بين نافذتي الحساب وبيان الاعتماد.
X-RateLimit-Reset طابع Unix، وX-RateLimit-Burst دفعة العشر ثواني الفعلية.
عند عدم وجود حد شهري تكون قيمة الحد 0 والمتبقي unlimited.
تجاوز حد الدقيقة أو الدفعة
Retry-After. استخدم تراجعًا أسّيًا مع عشوائية
إذا تكرر الحد، ولا تنشئ حلقة محاولات سريعة.
تجاوز الحصة الشهرية
تعيد الاستجابة429 مع الرمز monthly_quota_exceeded. يشير Retry-After إلى
بداية الشهر التالي بتوقيت UTC. على مالك الحساب مراجعة الخطة إذا كان التكامل
يحتاج سعة مستمرة أكبر.
API غير متاحة في الخطة
يعيد الحساب الذي عُطلت عنه API العامة حالة402 مع الرمز
api_not_available_on_plan. هذا قرار سياسة وليس عطلًا مؤقتًا، لذلك لا تفيد
إعادة المحاولة الآلية.