محدودیت نرخ درخواست در API
هر کلید API بهطور پیشفرض ۱٬۰۰۰ درخواست در دقیقه میفرستد و میتواند همهٔ ۱٬۰۰۰ درخواست را یکجا بفرستد. هر پاسخ سه هدر X-RateLimit-* دارد که میگوید چقدر مانده است. بیشتر از سقف، پاسخ 429 با کد rate_limit_exceeded و هدر Retry-After میگیری؛ این درخواست هزینهای ندارد. سقف بالاتر را پشتیبانی برای حساب تنظیم میکند.
آخرین بهروزرسانی:
فهرست مستندات
مسیرهای API
حساب، کلید و تیم
محدودیت نرخ · ۱
سقف پیشفرض
| چه چیزی | مقدار |
|---|---|
| سقف هر کلید | ۱٬۰۰۰ درخواست در دقیقه |
| برست (یکجا) | ۱٬۰۰۰ درخواست |
| شمارش | جدا برای هر کلید؛ هر کلید حساب سطل خودش را دارد |
| مسیرها | /v1/* (همراه با API حساب)، /anthropic/* و /gemini/* |
| درخواست همزمان | سقف جداگانهای ندارد |
سقف یک سطل توکن است: تا اندازهٔ سقف را میشود یکجا فرستاد و سطل در طول دقیقه یکنواخت پر میشود. درخواستی که به این سقف میخورد به سازندهٔ مدل فرستاده نمیشود و هزینهای ندارد. این سقف فقط سرعت را محدود میکند، نه مبلغ خرج را.
محدودیت نرخ · ۲
هدرهای پاسخ
هر پاسخ روی این مسیرها، چه انجامشده و چه ردشده، این هدرها را دارد. این هدرها وضعیت کلید تو در 1xAi را میگویند.
| هدر | معنی |
|---|---|
X-RateLimit-Limit | تعداد درخواست در دقیقه که این کلید اجازه دارد |
X-RateLimit-Remaining | درخواستهای کاملی که پس از این درخواست در سطل مانده |
X-RateLimit-Reset | چند ثانیه تا پر شدن کامل سطل؛ صفر یعنی پر است |
Retry-After | فقط روی 429: چند ثانیه تا یک درخواست دیگر ممکن شود |
هدرهای یک پاسخ موفق
HTTP/1.1 200 OK
X-RateLimit-Limit: 1000
X-RateLimit-Remaining: 999
X-RateLimit-Reset: 1
X-Request-Id: gw_01JD3Z5T8Q0V6W4M2K9R7N1PXAهدرهای محدودیت خود سازندهٔ مدل (x-ratelimit-* و anthropic-ratelimit-*) به تو فرستاده نمیشوند، چون سقف حساب ما نزد سازنده را میگویند، نه سقف کلید تو را.
محدودیت نرخ · ۳
بالاتر از سقف: پاسخ 429
پاسخ سقف کلید
HTTP/1.1 429 Too Many Requests
Retry-After: 1
X-RateLimit-Limit: 1000
X-RateLimit-Remaining: 0
X-RateLimit-Reset: 60
Content-Type: application/json; charset=utf-8
{
"error": {
"message": "…",
"type": "rate_limit_exceeded",
"code": "rate_limit_exceeded"
}
}به اندازهٔ Retry-After صبر کن و دوباره بفرست. کتابخانههای رسمی OpenAI و Anthropic این پاسخ را میشناسند و خودشان با همین هدر دوباره تلاش میکنند. اگر خودت درخواست میفرستی:
import time, httpx
def call(payload, key):
while True:
r = httpx.post(
"https://1xai.ir/v1/chat/completions",
headers={"Authorization": f"Bearer {key}"},
json=payload,
timeout=600,
)
if r.status_code != 429:
return r
# Retry-After is in seconds, on both kinds of 429.
time.sleep(int(r.headers.get("Retry-After", "1")))محدودیت نرخ · ۴
دو نوع 429: سقف خودت یا شلوغی سازندهٔ مدل
همهٔ پاسخهای 429 از سقف کلید تو نیست. گاهی سازندهٔ مدل درخواست را رد میکند چون خودش شلوغ است. از روی خود پاسخ میشود فهمید کدام است:
| نشانه | سقف کلید تو | شلوغی سازندهٔ مدل |
|---|---|---|
| کد خطا | rate_limit_exceeded | upstream_capacity روی مسیرهای سازگار با OpenAI؛ روی /anthropic و /gemini بدنهٔ خطای خود سازنده (rate_limit_error، RESOURCE_EXHAUSTED) |
X-RateLimit-Remaining | صفر | معمولاً بالاتر از صفر |
Retry-After | از ما: تا یک درخواست دیگر | از سازنده، همانطور که فرستاده |
| هزینه | ندارد | ندارد |
| سقف بالاتر کمک میکند؟ | بله | نه؛ کمی بعد دوباره بفرست یا مدل دیگری انتخاب کن |
محدودیت نرخ · ۵
سقفهای دیگر هر درخواست
| چه چیزی | مقدار | اگر رد شود |
|---|---|---|
| حجم بدنهٔ درخواست | ۲۵ مگابایت | 413 |
حجم بدنه در /v1/audio/speech | ۱ مگابایت | 413 |
| مهلت پاسخ سازندهٔ مدل | ۱۰ دقیقه | 504 با کد upstream_error؛ اگر چیزی نرسیده باشد هزینه ندارد |
روی مسیرهای /anthropic و /gemini، اگر سازنده 429، 503 یا 529 بدهد و هنوز چیزی برایت فرستاده نشده باشد، دروازه خودش تا ۳ بار تلاش میکند و بعد پاسخ را برمیگرداند.
محدودیت نرخ · ۶
سقف بالاتر
اگر ۱٬۰۰۰ درخواست در دقیقه برای کارت کم است، از صفحهٔ کلیدهای API در داشبورد دکمهٔ «درخواست سقف بالاتر» را بزن، سقف لازم و کاربردت را بنویس. این درخواست یک تیکت پشتیبانی باز میکند. پشتیبانی سقف را برای حساب تنظیم میکند و بلافاصله روی همهٔ کلیدهای حساب اعمال میشود؛ لازم نیست کلید را عوض کنی. بالا بردن سقف بهصورت خودکار و بدون پشتیبانی ممکن نیست.
فهرست همهٔ کدهای خطا در مرجع خطاها است.