حدود المعدل
حدود الاستخدام والمستوى الحالي
معاينة المطوّرين
تتشارك كل مفاتيح حسابك حداً واحداً على كل مسار: 120 طلباً في أي 60 ثانية. المفتاح الإضافي لا يضيف سعة، ولكل الحسابات الحد القياسي نفسه خلال المعاينة.
لا مستويات مدفوعة ولا تتبّع للإنفاق بعد.
حدود المستويات
يُحتسب الحد لحسابك على كل مسار على حدة، عبر كل طلبات مفاتيحه، بما فيها GET /v1/models.
| المستوى | RPM | TPM | الطلبات اليومية | الحالة |
|---|---|---|---|---|
| معاينة المطوّرين | 120 لكل مسار، لكل حساب | لا حد منفصل | لا حد منفصل | الحالي |
| مستويات أخرى | — | — | — | غير متاحة بعد |
الحدود لكل مسار
لكل مسار عدّاده الخاص لحسابك. والطلب الذي يتجاوز الحد يعود 429 rate_limit_exceeded، ويبقى ذلك العدّاد مغلقاً 60 ثانية: تذكر ترويسة Retry-After كم بقي. وللمتجهات والبحث حصة إضافية لكل حساب، ونطاق يجب أن يملكه المفتاح.
| المسار | الحد العام | حصة المسار | النطاق المطلوب |
|---|---|---|---|
POST /v1/chat/completions | 120 / 60 s | — | لا يلزم |
GET /v1/models | 120 / 60 s | — | لا يلزم |
POST /v1/embeddings | 120 / 60 s | 20 في الدقيقة | embeddings |
POST /v1/search | 120 / 60 s | 10 في الدقيقة | search |
سعة المتجهات والبحث مشتركة بين كل المستخدمين: حين تنشغل يعود 429 capacity_exceeded مع Retry-After، حتى لو لم يبلغ حسابك حده. انظر صلاحيات المفتاح.
ترويسات الرد
الترويسات التي يوثّقها عقد الواجهة لحدود المعدل.
| الترويسة | الوصف |
|---|---|
x-request-id | كل رد، بما فيه الأخطاء والبث. معرّف هذا الطلب: معرّفك إن أرسلت معرّفاً صالحاً، وإلا فمعرّف مولَّد. أرفقه عند التواصل مع الدعم. |
Retry-After | الرد 429 بالرمز عدد الثواني (عدد صحيح، 1 على الأقل) قبل أن تعيد المحاولة: حتى يسمح الحد الذي رفض الطلب بطلب آخر (حد حسابك على المسار، أو حصة حسابك من المتجهات أو البحث)، أو حتى تتسع السعة المشتركة.rate_limit_exceeded أو capacity_exceeded، والرد 503 service_unavailable من POST /v1/embeddings أو POST /v1/search (وقد يأتي ذلك الرد دونها). لا يُرسل مع upstream_rate_limited. |
التعامل مع 429
استراتيجية إعادة المحاولة الموصى بها.
- الحالة 429 تعني أن الطلب لم يُنفَّذ. يميّز
error.codeسببها:rate_limit_exceeded— تجاوز حسابك حده على هذا المسار (تُحتسب كل مفاتيحه)، معRetry-After؛capacity_exceeded— السعة المشتركة للمتجهات أو البحث مشغولة، معRetry-After؛upstream_rate_limited— خادم النموذج طلب الإبطاء (وأثناء البث يصلupstream_error). - احترم ترويسة
Retry-Afterعند وجودها، وإلا استخدم تراجعاً أُسّياً مع عشوائية. - قلّل عدد الطلبات المتوازية بدلاً من إعادة المحاولة الفورية؛ وتوزيع الطلبات على مفاتيح أكثر لا يرفع الحد.
// Retry on 429: honor Retry-After when present, else exponential backoff + jitter.async function withBackoff(call, maxRetries = 5) { for (let attempt = 0; ; attempt++) { const res = await call(); if (res.status !== 429 || attempt >= maxRetries) return res; const retryAfter = Number(res.headers.get("retry-after")); const delayMs = retryAfter > 0 ? retryAfter * 1000 : 1000 * 2 ** attempt + Math.random() * 250; await new Promise((r) => setTimeout(r, delayMs)); }}const res = await withBackoff(() => fetch("https://api.mindlabsa.com/v1/chat/completions", opts));لديك سؤال عن الحدود؟
أخبرنا بما تبنيه.
لكل الحسابات الحد القياسي نفسه خلال المعاينة، ولا يمكن رفع حد حساب بعينه بعد. راسلنا عن حالة استخدامك؛ فذلك يساعدنا في تخطيط المستويات.