مستندات
محدودیتها و سقفها
سقف نرخ، سقف روزانهٔ کلید، هدرهای پاسخ و اینکه هر سقف کِی بازنشانی میشود.
دو نوع سقف
سقف نرخ از پلن شما میآید و سرعت را کنترل میکند. سقف بودجه روی خودِ کلید تنظیم میشود و کل خرج را کنترل میکند. این دو مستقلاند و هر کدام جداگانه میتواند درخواست را رد کند.
سقف نرخ
| پنجره | کد خطا |
|---|---|
| درخواست در دقیقه | rate_limit_rpm |
| درخواست در ساعت | rate_limit_rph |
| درخواست در روز | rate_limit_rpd |
| توکن در دقیقه | rate_limit_tpm |
سقفهای فعلی کلید خود را بدون باز کردن پنل ببینید:
bash
curl https://iranrouter.com/v1/key -H "Authorization: Bearer ir-..."هدرهای پاسخ
| هدر | معنی |
|---|---|
x-ratelimit-limit-requests | سقف پنجرهٔ جاری |
x-ratelimit-remaining-requests | باقیماندهٔ همان پنجره |
x-ratelimit-reset-requests | ثانیه تا بازنشانی |
x-ratelimit-limit-tokens | سقف توکن در دقیقه |
retry-after | روی هر ۴۲۹: چند ثانیه صبر کنید |
x-request-id | شناسهٔ درخواست — برای پشتیبانی همین را بفرستید |
همیشه به
retry-after احترام بگذارید. یک ایجنت که بلافاصله دوباره تلاش میکند، سقف خودش را زودتر پر میکند.سقف روزانهٔ کلید
روی هر کلید میتوانید سقف روزانهٔ توکن یا سقف روزانهٔ ریالی بگذارید. سقف سخت است: درخواستی که تخمینش شما را از سقف عبور دهد اجرا نمیشود — نه اینکه اجرا شود و بعد هشدار بدهد.
- پاسخ رد:
429با کدkey_daily_token_budget_reachedیاkey_daily_budget_reached - بازنشانی: نیمهشب به وقت تهران. هدر retry-after دقیقاً ثانیههای باقیمانده تا آن لحظه را میگوید.
- برای بازکردن زودتر، سقف را بالا ببرید. شمارندهٔ مصرف قابل صفرکردن نیست — وگرنه «سقف روزانه» معنایی نمیداشت.
پیش از رهاکردن یک ایجنت خودگردان، روی کلیدش سقف روزانه بگذارید. یک حلقهٔ اشتباه میتواند شبانه صدها هزار توکن خرج کند.
سقف ماهانه
علاوه بر سقف روزانه، هر کلید میتواند سقف خرج ماهانه هم داشته باشد؛ عبور از آن 402 monthly_cap_reached برمیگرداند.