سقفها و خطاها
هر خطا یک کد دارد که میگوید چه شد و حالا چه کسی باید کاری بکند. اینجا خواندن این کدها را یاد میگیرید.
خطاهای ایرانروتر پیام مبهم نیستند. هر پاسخ خطا یک کد دارد که دقیقاً میگوید چه شد و حالا چه کسی باید کاری بکند. با یاد گرفتن همین چند کد، بیشتر گیرها باز میشود.
دو نوع سقف
| از کجا میآید | چه چیزی را کنترل میکند | |
|---|---|---|
| سقف نرخ | پلن شما | سرعت: درخواست در دقیقه، ساعت و روز، و توکن در دقیقه |
| سقف بودجه | روی کلید، Workspace یا گاردریل | خرج کل |
این دو مستقلاند و هر کدام جداگانه میتواند درخواست را رد کند. برای دیدن همهٔ محدودیتهای یک کلید در یکجا، آن را باز کنید و «همهٔ محدودیتهای مؤثر» را بزنید. همیشه سختگیرترین عدد اعمال میشود.
معنی خطاها
| کد | یعنی | چه باید کرد |
|---|---|---|
۴۰۱ invalid_api_key | کلید اشتباه، باطل یا منقضی است | معمولاً یک فاصله یا خط جدید اضافه موقع کپی |
۴۰۲ insufficient_balance | موجودی برای رزرو کافی نیست | شارژ کنید یا max_tokens را کم کنید |
۴۰۲ plan_quota_reached | سهمیهٔ پلن تمام شده | تمدید کنید یا کلید را اعتباری کنید |
۴۰۳ model_not_in_plan | این مدل در پلن شما نیست | کلید را «اعتباری» کنید |
۴۰۴ model_not_found | شناسهٔ مدل درست نیست | شناسه را از صفحهٔ مدلها بردارید |
۴۲۹ rate_limit_* | سرعت درخواست زیاد است | به اندازهٔ retry-after صبر کنید |
۴۲۹ key_daily_budget_reached | سقف روزانهٔ کلید پر شده | تا نیمهشب تهران صبر کنید یا سقف را بالا ببرید |
۵۰۳ no_capacity | فعلاً مسیر سالمی برای این مدل نیست | کمی بعد دوباره بفرستید |
کد را نگاه کنید، نه متن پیام را. کد ثابت میماند و برنامهتان باید بر اساس آن تصمیم بگیرد.
کی دوباره تلاش کنیم
- دوباره بفرستید: ۴۲۹ بعد از
retry-after؛ ۵۰۳ و ۵۰۲ با فاصلهای که هر بار بیشتر شود. - فایده ندارد: ۴۰۰، ۴۰۱، ۴۰۳ و ۴۰۴. تا خود درخواست عوض نشود، جواب هم عوض نمیشود.
- کار یک آدم است: ۴۰۲. کسی باید کیف پول را شارژ کند یا تنظیمات را تغییر دهد.
retry-after را رعایت کنید.برای پشتیبانی
هر پاسخ هدر x-request-id دارد. اگر تیکت میزنید همین را بفرستید. فهرست کامل کدها در مرجع خطاها است.
یک خطا را عمداً ببینید۰ از ۳ قدم
- یک بار با شناسهٔ مدل اشتباه درخواست بفرستید.
- کد خطا را در جواب ببینید.
- همان درخواست را در لاگها پیدا کنید و ببینید خطا به حساب کدام طرف نوشته شده است.
خلاصهٔ درس
- سقف نرخ سرعت را کنترل میکند و سقف بودجه خرج را.
- کد خطا میگوید چه باید کرد.
- سطح متوسط تمام شد. سطح پیشرفته برای وقتی است که هزینه و پایداری برایتان جدی میشود.
وارد شوید تا پیشرفتتان بماند
اگر وارد پنل شوید، مسیرتان و جایی که در هر درس بودید ذخیره میشود و روی هر دستگاهی از همانجا ادامه میدهید.