نمای کلی
استفاده از API مشمول محدودیت تعداد درخواست است. این محدودیتها تعداد درخواستها، توکنها یا سایر موارد استفاده را در یک بازه زمانی مشخص محدود میکنند.
پاسخ ۴۲۹ میتواند نشاندهنده محدودیت موقت تعداد درخواست، اتمام موجودی پیشپرداخت یا رسیدن به محدودیت هزینه یا مصرف باشد. پیش از تلاش دوباره یا تغییر تنظیمات صورتحساب، جزئیات خطا را بررسی کنید.
علت را شناسایی کنید
پیام خطا و در صورت ارائه، error.code را بخوانید. خطاهای مربوط به صورتحساب ممکن است همچنان از مقدار کلیتر insufficient_quota برای error.type استفاده کنند.
| خطا یا کد | مفهوم آن | اقدام لازم |
| رسیدن درخواستها یا توکنها به محدودیت تعداد درخواست | درخواستها از یکی از محدودیتهای تعداد درخواست مربوطه فراتر رفتهاند. | سرعت ارسال درخواستها را تنظیم کنید و راهنمای تلاش مجدد در ادامه را به کار ببرید. |
| credit_balance_exhausted | هیچ اعتبار پیشپرداختی برای سازمان باقی نمانده است. | در تنظیمات صورتحساب API خود اعتبار اضافه کنید. |
| organization_usage_limit_exceeded | سازمان به محدودیت مصرف تعیینشده از سوی OpenAI رسیده است. | برای دریافت محدودیت مصرف تأییدشده بالاتر درخواست دهید. |
| organization_spend_limit_exceeded | سازمان به سقف هزینه اعمالشده خود رسیده است. | سقف را افزایش دهید یا بردارید، یا تا بازنشانی ماهانه منتظر بمانید. |
| project_spend_limit_exceeded | پروژه به سقف هزینه اعمالشده خود رسیده است. | سقف پروژه را افزایش دهید یا بردارید، یا تا بازنشانی ماهانه منتظر بمانید. |
تلاش دوباره برای خطای صورتحساب، هزینه یا سهمیه، دسترسی را بازنمیگرداند. ابتدا موجودی یا محدودیت گزارششده را برطرف کنید. اعمال تغییرات سقفهای هزینه ممکن است زمان ببرد.
تغییر سقف هزینه مستلزم داشتن مجوز مدیریت تنظیمات سازمان یا پروژه مربوطه است. اگر دسترسی ندارید، از مسئول مدیریت این تنظیمات بخواهید آن را انجام دهد.
برای خرید اعتبار پیشپرداخت، به این مطلب مراجعه کنید: راهاندازی و مدیریت صورتحساب پیشپرداخت API.
برای آشنایی با کنترلهای مختلف هزینه، به راهنمای سقف هزینه API مراجعه کنید.
محدودیتهای تعداد درخواست مربوطه را بررسی کنید
برای بررسی سطح مصرف و محدودیتهای فعلی سازمان، به صفحه محدودیتها بروید.
محدودیتهای تعداد درخواست ممکن است در سطح سازمان و پروژه اعمال شوند. این محدودیتها سهمیه کاربران بهصورت جداگانه نیستند. محدودیتها بر اساس مدل نیز متفاوتاند و برخی خانوادههای مدل محدودیت مشترک دارند.
بررسی کنید خطا به کدام محدودیت اشاره دارد. برای مثال، تعداد درخواست در دقیقه و تعداد توکن در دقیقه محدودیتهای جداگانهای هستند. ممکن است به یکی برسید، درحالیکه همچنان پایینتر از دیگری هستید.
سازمان مورداستفاده درخواستتان را تأیید کنید
اگر عضو چند سازمان هستید، مطمئن شوید درخواستهایتان از سازمان و پروژه موردنظر استفاده میکنند.
اگر کلید API شما از یک سازمان پیشفرض استفاده میکند، تنظیم سازمان پیشفرض خود را بررسی کنید. سازمانهای مختلف ممکن است ترتیبات صورتحساب و سطوح مصرف متفاوتی داشته باشند.
کاهش خطاهای موقت محدودیت تعداد درخواست
سرعت درخواستها را تنظیم کنید و از ارسال انبوه بپرهیزید
بهجای ارسال تعداد زیادی درخواست بهصورت همزمان، آنها را در طول زمان پخش کنید.
محدودیتهای تعداد درخواست ممکن است در بازههایی کوتاهتر از بازه نمایشدادهشده اعمال شوند. برای مثال، محدودیت ۶۰ درخواست در دقیقه ممکن است در بازههای یکثانیهای نیز اعمال شود. بنابراین، ارسال انبوه کوتاهمدت میتواند حتی زمانی که میانگین مصرفتان کمتر از محدودیت دقیقهای به نظر میرسد، خطا ایجاد کند.
اعلانهای طولانی و سهمیههای بیشازحد بزرگ و غیرضروری برای توکن خروجی نیز میتوانند در بروز خطاهای نرخ توکن نقش داشته باشند.
پس از کمی تأخیر دوباره تلاش کنید
برای خطاهای موقت محدودیت تعداد درخواست:
وجود سرآیند پاسخ Retry-After را بررسی کنید.
اگر سرآیند حاوی مدتزمان تأخیر معتبری است، پیش از تلاش دوباره دستکم به همان اندازه صبر کنید.
اگر سرآیند وجود ندارد یا نامعتبر است، از عقبنشینی نمایی همراه با نوسان تصادفی استفاده کنید: پس از هر تلاش ناموفق، تأخیر را افزایش دهید و یک تأخیر تصادفی کوتاه نیز به آن بیفزایید.
هم تعداد تلاشهای مجدد و هم کل زمان صرفشده برای آنها را محدود کنید.
کیتهای توسعه نرمافزار رسمی OpenAI خطاهای واجدشرایط محدودیت تعداد درخواست را از قبل دوباره امتحان میکنند و در صورت وجود Retry-After، آن را رعایت میکنند. پیش از افزودن یک حلقه تلاش مجدد دیگر، این تلاشها را در نظر بگیرید.
درخواستهای ناموفق نیز در محدودیتهای دقیقهای محاسبه میشوند. ارسال مداوم همان درخواست میتواند مشکل را طولانیتر کند.
برای راهنمای پیادهسازی و نمونهها، به راهنمای محدودیت تعداد درخواست API مراجعه کنید. پیش از استفاده از هر کتابخانه شخص ثالث برای تلاش مجدد در برنامه خود، آن را بررسی کنید.
اندازه اعلان و خروجی را بررسی کنید
دستورالعملهای غیرضروری، زمینههای تکراری و مثالها را از اعلانهای خود حذف کنید. اعلان اصلاحشده را آزمایش کنید تا مطمئن شوید همچنان نتیجه موردنیازتان را تولید میکند.
از پارامتر توکن خروجی پشتیبانیشده در نقطه پایان و مدل خود استفاده کنید:
Chat Completions از max_completion_tokens استفاده میکند.
Responses از max_output_tokens استفاده میکند.
از تعیین سهمیهای بسیار بیشتر از نیاز درخواست خودداری کنید. این پارامترها علاوه بر خروجی قابلمشاهده، توکنهای استدلال را نیز شامل میشوند؛ بنابراین هنگام استفاده از مدل استدلال، هر دو را در نظر بگیرید.
سطح مصرف خود را بررسی کنید
اگر پس از کاهش ارسال انبوه و بررسی مصرف توکن، خطاها ادامه داشتند، برای مشاهده راههای موجود افزایش محدودیتها به صفحه محدودیتها بروید.
با افزایش هزینه API، ممکن است OpenAI سازمان را بهطور خودکار به سطح مصرف بالاتری ارتقا دهد. این کار معمولاً محدودیتهای تعداد درخواست را در بیشتر مدلها افزایش میدهد.
محدودیت تأییدشده مصرف ماهانه شما از محدودیت تعداد درخواست و نرخ توکن جداست. افزایش یکی را نباید تأییدی بر تغییر دیگری دانست.
اگر مشکل ادامه داشت
پیش از ارجاع مشکل
پیام دقیق خطا، هرگونه کد خطا، شناسههای مرتبط درخواست، زمان بروز خطا همراه با منطقه زمانی و محدودیت مربوطه نمایشدادهشده در حسابتان را در دسترس نگه دارید. مراحلی را که تاکنون امتحان کردهاید یادداشت کنید.
تماس با پشتیبانی OpenAI
اگر پس از بررسی محدودیت گزارششده نتوانستید مشکل را برطرف کنید، از طریق مرکز راهنمایی با پشتیبانی OpenAI تماس بگیرید. کلیدهای API یا سایر اطلاعات محرمانه احراز هویت را ارسال نکنید.