/api_keys/rate_limits هي الطريقة الرسمية لجلب حدودك الحالية. يمكنك التحقق من حدودك الدقيقة في أي وقت:
عرض حدودك
ساحة لعب تفاعلية
سجلات حدود المعدل
شاهد الطلبات التي وصلت إلى الحدود
الحدود الافتراضية
نماذج النصوص والـ Embedding
تُجمَّع نماذج النصوص والـ embedding في أربعة أحجام. تعرض كل بطاقة نموذج في صفحة النماذج شارة حجمها. جميع نماذج الـ embedding من الحجم XS.تعمل بعض النماذج على بنية تحتية مخصصة أو تابعة لطرف ثالث وتحمل حدودًا لا تتطابق مع هذه الأحجام الأربعة. استدعِ
GET /api_keys/rate_limits للحصول على الحدود الرسمية لكل نموذج على مفتاحك.نماذج الصور والصوت
نماذج الفيديو والموسيقى
توليد الفيديو والموسيقى غير خاضع لحدود المعدل. تُحتسب فوترة كليهما لكل عملية توليد من رصيدك، لذا فإن القيد العملي هو التكلفة وليس سقف الطلبات. قم بتسعير المهمة أولًا باستخدامPOST /video/quote أو POST /audio/quote.
التعامل مع الأخطاء
يجب إعادة محاولة الطلبات الفاشلة (500، 503، 429) باستخدام exponential backoff. بالنسبة لأخطاء 429 تحديدًا، تحقق من headerx-ratelimit-reset-requests للحصول على الطابع الزمني Unix الدقيق متى يمكنك إعادة المحاولة. تحتوي معظم مكتبات HTTP على آليات إعادة محاولة مدمجة تتعامل مع هذا تلقائيًا.
ميزانيات الأخطاء
يحمي حدّان إضافيان الـ API من العملاء الذين يستمرون في إعادة المحاولة دون جدوى. يُحسب كلاهما لكل نموذج ولكل مفتاح API خلال نافذة متحركة مدتها 30 ثانية، ويعيد كلاهما429:
تحسب الميزانية الثانية الطلبات التي تطلب من نموذج ميزة لا يدعمها. على سبيل المثال، طلب الرؤية أو استدعاء الأدوات من نموذج لا يمتلك تلك القدرة. يظهر تجاوز أي من الميزانيتين في سجلات حدود المعدل باسم
FAILED_REQUESTS أو UNSUPPORTED_FEATURE_REQUESTS.
يعيد كلاهما customMessage يحدد العتبة التي تم تجاوزها:
x-ratelimit-remaining وx-ratelimit-resets بدلًا من رؤوس النافذة المذكورة أدناه.
رؤوس الاستجابة
تتضمن كل استجابة هذه الرؤوس:
يستخدم endpoint
/crypto/rpc/{network} حدوده الخاصة ورؤوسه الخاصة X-RateLimit-Limit وX-RateLimit-Remaining وX-RateLimit-Reset، والتي تُعيَّن فقط في استجابات 429. راجع Crypto RPC لمزيد من التفاصيل.