۱۰۰ هزار تومان هدیهٔ ثبت‌نام، تا ۱ میلیونبا ثبت‌نام گردونهٔ هدیه را بچرخان: دست‌کم ۱۰۰٬۰۰۰ تومان و تا ۱٬۰۰۰٬۰۰۰ تومان اعتبار هدیه، بدون کارت بانکیگردونهٔ هدیه۱ میلیون برای تو، ۱ میلیون برای دوستتدوستانت را دعوت کن: برای هر دوستی که فعال شود ۱٬۰۰۰٬۰۰۰ تومان اعتبار هدیه می‌گیری و خودش هم ۱٬۰۰۰٬۰۰۰ تومانجوایز
1xAi
مستندات API

محدودیت نرخ درخواست در API

هر کلید API به‌طور پیش‌فرض ۱٬۰۰۰ درخواست در دقیقه می‌فرستد و می‌تواند همهٔ ۱٬۰۰۰ درخواست را یک‌جا بفرستد. هر پاسخ سه هدر X-RateLimit-* دارد که می‌گوید چقدر مانده است. بیشتر از سقف، پاسخ 429 با کد rate_limit_exceeded و هدر Retry-After می‌گیری؛ این درخواست هزینه‌ای ندارد. سقف بالاتر را پشتیبانی برای حساب تنظیم می‌کند.

آخرین به‌روزرسانی:

فهرست مستندات

محدودیت نرخ · ۱

سقف پیش‌فرض

سقف نرخ درخواست
چه چیزیمقدار
سقف هر کلید۱٬۰۰۰ درخواست در دقیقه
برست (یک‌جا)۱٬۰۰۰ درخواست
شمارشجدا برای هر کلید؛ هر کلید حساب سطل خودش را دارد
مسیرها/v1/* (همراه با API حساب)، /anthropic/* و /gemini/*
درخواست هم‌زمانسقف جداگانه‌ای ندارد

سقف یک سطل توکن است: تا اندازهٔ سقف را می‌شود یک‌جا فرستاد و سطل در طول دقیقه یکنواخت پر می‌شود. درخواستی که به این سقف می‌خورد به سازندهٔ مدل فرستاده نمی‌شود و هزینه‌ای ندارد. این سقف فقط سرعت را محدود می‌کند، نه مبلغ خرج را.

محدودیت نرخ · ۲

هدرهای پاسخ

هر پاسخ روی این مسیرها، چه انجام‌شده و چه ردشده، این هدرها را دارد. این هدرها وضعیت کلید تو در 1xAi را می‌گویند.

هدرهای محدودیت نرخ
هدرمعنی
X-RateLimit-Limitتعداد درخواست در دقیقه که این کلید اجازه دارد
X-RateLimit-Remainingدرخواست‌های کاملی که پس از این درخواست در سطل مانده
X-RateLimit-Resetچند ثانیه تا پر شدن کامل سطل؛ صفر یعنی پر است
Retry-Afterفقط روی 429: چند ثانیه تا یک درخواست دیگر ممکن شود

هدرهای یک پاسخ موفق

http
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
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 این پاسخ را می‌شناسند و خودشان با همین هدر دوباره تلاش می‌کنند. اگر خودت درخواست می‌فرستی:

Python
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 از سقف کلید تو نیست. گاهی سازندهٔ مدل درخواست را رد می‌کند چون خودش شلوغ است. از روی خود پاسخ می‌شود فهمید کدام است:

تفاوت دو نوع 429
نشانهسقف کلید توشلوغی سازندهٔ مدل
کد خطاrate_limit_exceededupstream_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 در داشبورد دکمهٔ «درخواست سقف بالاتر» را بزن، سقف لازم و کاربردت را بنویس. این درخواست یک تیکت پشتیبانی باز می‌کند. پشتیبانی سقف را برای حساب تنظیم می‌کند و بلافاصله روی همهٔ کلیدهای حساب اعمال می‌شود؛ لازم نیست کلید را عوض کنی. بالا بردن سقف به‌صورت خودکار و بدون پشتیبانی ممکن نیست.

فهرست همهٔ کدهای خطا در مرجع خطاها است.