محدودیت نرخ و خطاها

مدل‌های پولی هیچ محدودیتِ تحمیلی از Routerah ندارند: نه درخواست در دقیقه، نه توکن در دقیقه و نه سقف همزمانی روی کلید یا حساب شما. هر ارائه‌دهنده بالادستی ظرفیت خودش را دارد. وقتی یکی شلوغ باشد به بعدی مسیریابی می‌کنیم؛ پس 429 یا 503 روی مدل پولی فقط وقتی رخ می‌دهد که همه ارائه‌دهندگانش در آن لحظه شلوغ باشند.

مدل‌های رایگان محدودند. 429 روی مدل رایگان می‌تواند از چند لایه بیاید:

• سقف ما برای مدل رایگان: ۱ درخواست در دقیقه، به ازای هر مدل رایگان، به ازای هر کاربر.
• محدودیت‌های بالادستی: ارائه‌دهنده پشت مدل رایگان به سقف خودش خورده است.
• بودجه توکن روزانه روی بعضی استخرهای رایگان، با ریست در نیمه‌شب UTC.
• سقف توکن-در-دقیقه، که با پرامپت‌های خیلی بزرگ تریگر می‌شود.

وقتی سقف ۱-در-دقیقه آتش بگیرد، هدرهای استاندارد محدودیت نرخ می‌گیرید:

HTTP/1.1 429 Too Many Requests
Retry-After: 38
X-RateLimit-Limit: 1
X-RateLimit-Remaining: 0
X-RateLimit-Reset: 1783198478

‏Retry-After ثانیه‌های باقی‌مانده پنجره شماست، نه ۶۰ ثابت. پیام، مدل پولی را نام می‌برد که محدودیتی ندارد.

بعضی مدل‌های پولی با سقف اندازه درخواست رایگان عرضه می‌شوند. پرامپت‌های بزرگ‌تر از حد 413 می‌دهند: «Request body too large for gpt-4.1 model. Max size: 8000 tokens».

سقف فقط برای مسیر رایگان است. مدل پولی، پرامپت کامل می‌گیرد.

خطاها JSON در قالب خطای OpenAI برمی‌گردانند. code شناسه‌ای پایدار است. شناسه درخواست به هر پیام چسبانده می‌شود:

{
  "error": {
    "message": "Model \"gpt-5.5-typo\" is not offered here. Check the model name for typos, or switch to a model from our supported list. (request id: 20260705...)",
    "type": "new_api_error",
    "code": "model_not_found"
  }
}

شناسه درخواست را در تیکت پشتیبانی ذکر کنید. درخواست شما را در لاگ‌ها پیدا می‌کند.

اگر هنوز سراغ راه‌اندازی کلید یا نشانی پایه هستید، از شروع سریع

وضعیت‌کدهایی که واقعاً برخورد می‌کنید:

دو وضعیت خیلی متفاوت یک وضعیت‌کد 503 را شریک‌اند. اولی ازدحام موقتی است:

HTTP/1.1 503 Service Unavailable

{
  "error": {
    "message": "All providers for model \"kimi-k2.6:free\" are busy right now (they hit their rate limit). This is not a spelling error. Please try again in a little while, or switch to another model. (request id: 20260705...)",
    "type": "new_api_error",
    "code": "get_channel_failed"
  }
}

‏get_channel_failed یعنی همه ارائه‌دهندگان رایگان آن مدل به سقف نرخ خورده‌اند. چند دقیقه‌ای رفع می‌شود: تلاش دوباره یا تعویض مدل. model_not_found یعنی نام حل نمی‌شود؛ تلاش مجدد هرگز کمک نمی‌کند. غلط تایپی را ببینید یا کاتالوگ را.

‏get_channel_failed را قابل تلاش مجدد و model_not_found را خطای سخت بگیرید.

مدلی که زیر بار غیب شد خودش برمی‌گردد؛ برای خبر شدن همان لحظه، آن را در اعلان‌ها

اگر کلید شما گروه‌های ارائه‌دهنده را سنجاق کرده، خطای 503 سومی وقتی ظاهر می‌شود که فقط گروه‌های سنجاق‌شده شما قطع باشند، ببینید سنجاق گروه

‏Retry-After روی 429 را رعایت کنید. خطای 503 با get_channel_failed را بعد از صبر کوتاه دوباره تلاش کنید یا مدل عوض کنید. خطاهای رده 400 را دوباره تلاش نکنید.

درخواست‌های شکست‌خورده و ردشده هرگز صورتحساب نمی‌شوند؛ نحوه کار پیش‌نگه‌داشت و بازپرداخت در حساب و صورتحساب