سقف‌ها و خطاها

هر خطا یک کد دارد که می‌گوید چه شد و حالا چه کسی باید کاری بکند. اینجا خواندن این کدها را یاد می‌گیرید.

۶ دقیقهدرس ۸ از ۸۰ از ۳ قدم

خطاهای ایران‌روتر پیام مبهم نیستند. هر پاسخ خطا یک کد دارد که دقیقاً می‌گوید چه شد و حالا چه کسی باید کاری بکند. با یاد گرفتن همین چند کد، بیشتر گیرها باز می‌شود.

دو نوع سقف

از کجا می‌آیدچه چیزی را کنترل می‌کند
سقف نرخپلن شماسرعت: درخواست در دقیقه، ساعت و روز، و توکن در دقیقه
سقف بودجهروی کلید، 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 دارد. اگر تیکت می‌زنید همین را بفرستید. فهرست کامل کدها در مرجع خطاها است.

یک خطا را عمداً ببینید۰ از ۳ قدم

  1. یک بار با شناسهٔ مدل اشتباه درخواست بفرستید.
  2. کد خطا را در جواب ببینید.
  3. همان درخواست را در لاگ‌ها پیدا کنید و ببینید خطا به حساب کدام طرف نوشته شده است.

خلاصهٔ درس

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