مرور کلی
استفاده از API مشمول محدودیت تعداد درخواست است. این محدودیت‌ها تعداد درخواست‌ها، توکن‌ها یا سایر موارد مصرف را در یک بازهٔ زمانی مشخص محدود می‌کنند.
پاسخ 429 می‌تواند نشان‌دهندهٔ محدودیت موقت تعداد درخواست، اتمام موجودی پیش‌پرداخت، یا رسیدن به سقف هزینه یا مصرف باشد. پیش از تلاش مجدد یا تغییر تنظیمات صورت‌حساب، جزئیات خطا را بررسی کنید.
علت را شناسایی کنید
پیام خطا و در صورت ارائه، مقدار 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 تولید تصویر را بررسی کنید
محدودیت تعداد درخواست در API تولید تصویر به مدل و سطح مصرف شما بستگی دارد. مدل خود را در صفحهٔ مدل‌ها انتخاب کنید تا محدودیت‌های آن را ببینید.
برای دستورالعمل‌های راه‌اندازی، به راهنمای تولید تصویر برای توسعه‌دهندگان مراجعه کنید. برای اطلاعات بیشتر دربارهٔ سطوح مصرف، به راهنمای محدودیت تعداد درخواست API مراجعه کنید.
سازمانی را که درخواست شما از آن استفاده می‌کند بررسی کنید
اگر عضو چند سازمان هستید، مطمئن شوید درخواست‌هایتان از سازمان و پروژهٔ موردنظر استفاده می‌کنند.
اگر کلید API شما از سازمان پیش‌فرض استفاده می‌کند، تنظیم سازمان پیش‌فرض خود را بررسی کنید. سازمان‌های مختلف ممکن است شرایط صورت‌حساب و سطوح مصرف متفاوتی داشته باشند.
خطاهای موقت ناشی از محدودیت تعداد درخواست را کاهش دهید
درخواست‌ها را با فاصله ارسال کنید و از ارسال انبوه و ناگهانی بپرهیزید
به‌جای ارسال تعداد زیادی درخواست به‌صورت هم‌زمان، آن‌ها را در طول زمان پخش کنید.
محدودیت تعداد درخواست ممکن است در بازه‌هایی کوتاه‌تر از بازهٔ نمایش‌داده‌شده اعمال شود. برای مثال، محدودیت ۶۰ درخواست در دقیقه ممکن است در بازه‌های ۱ ثانیه‌ای نیز اعمال شود. بنابراین، ارسال تعداد زیادی درخواست در زمانی کوتاه می‌تواند باعث خطا شود، حتی اگر میانگین مصرف شما کمتر از سقف دقیقه‌ای به نظر برسد.
اعلان‌های طولانی و تعیین سقف بیش‌ازحد بالا برای توکن‌های خروجی نیز می‌توانند به بروز خطاهای محدودیت نرخ توکن منجر شوند.
پس از کمی تأخیر دوباره تلاش کنید
برای خطاهای موقت ناشی از محدودیت تعداد درخواست:
بررسی کنید آیا پاسخ دارای سرآیند Retry-After است.
اگر سرآیند حاوی زمان انتظار معتبری است، پیش از تلاش مجدد دست‌کم به همان اندازه صبر کنید.
اگر سرآیند وجود ندارد یا نامعتبر است، زمان انتظار را به‌صورت نمایی و با کمی تغییر تصادفی افزایش دهید: پس از هر تلاش ناموفق، زمان انتظار را بیشتر کنید و تأخیر تصادفی کوتاهی به آن بیفزایید.
هم تعداد تلاش‌های مجدد و هم کل زمان صرف‌شده برای آن‌ها را محدود کنید.
SDKهای رسمی OpenAI خودشان در صورت بروز خطاهای قابل‌تکرارِ محدودیت تعداد درخواست، دوباره تلاش می‌کنند و در صورت وجود Retry-After، آن را رعایت می‌کنند. پیش از افزودن حلقهٔ دیگری برای تلاش مجدد، این تلاش‌های خودکار را در نظر بگیرید.
درخواست‌های ناموفق نیز در محاسبهٔ محدودیت‌های دقیقه‌ای لحاظ می‌شوند. ارسال پی‌درپی همان درخواست می‌تواند مشکل را طولانی‌تر کند.
برای راهنمایی و نمونه‌های پیاده‌سازی، به راهنمای محدودیت تعداد درخواست API مراجعه کنید. پیش از استفاده از هر کتابخانهٔ شخص ثالث برای تلاش مجدد در برنامهٔ خود، آن را بررسی کنید.
اندازهٔ اعلان و خروجی را بررسی کنید
دستورالعمل‌ها و مثال‌های غیرضروری و اطلاعات زمینه‌ای تکراری را از اعلان‌های خود حذف کنید. اعلان بازبینی‌شده را آزمایش کنید تا مطمئن شوید همچنان نتیجهٔ موردنیازتان را تولید می‌کند.
از پارامتر توکن خروجی که نقطه پایان و مدل شما پشتیبانی می‌کنند استفاده کنید:
Chat Completions از max_completion_tokens استفاده می‌کند.
Responses از max_output_tokens استفاده می‌کند.
سقفی بسیار بالاتر از نیاز درخواست تعیین نکنید. این پارامترها هم توکن‌های استدلال و هم خروجی قابل‌مشاهده را شامل می‌شوند؛ بنابراین هنگام استفاده از مدل استدلال، برای هر دو ظرفیت کافی در نظر بگیرید.
سطح مصرف خود را بررسی کنید
اگر پس از کاهش ارسال‌های انبوه و ناگهانی و بررسی مصرف توکن همچنان خطا دریافت می‌کنید، برای دیدن راه‌های موجود برای افزایش سقف‌ها، صفحهٔ محدودیت‌ها را بررسی کنید.
وقتی مجموع خرید اعتبار سازمان شما به حدنصاب‌های Build، Launch و Grow برسد، سطح مصرف پولی آن به‌طور خودکار ارتقا می‌یابد. سطوح بالاتر معمولاً سقف بالاتری برای محدودیت تعداد درخواست دارند. برای آگاهی از شرایط هر سطح، به راهنمای محدودیت تعداد درخواست API مراجعه کنید.
سقف مصرف ماهانهٔ تأییدشدهٔ شما از محدودیت تعداد درخواست و توکن در بازهٔ زمانی مشخص جداست. افزایش یکی به معنای تأیید تغییر دیگری نیست.
اگر مشکل ادامه داشت
پیش از ارجاع به پشتیبانی
متن دقیق پیام خطا، هر کد خطای موجود، شناسه‌های درخواست مرتبط، زمان وقوع خطا همراه با منطقهٔ زمانی، و محدودیت مربوط که در حسابتان نمایش داده می‌شود را آماده داشته باشید. اقداماتی را که تاکنون امتحان کرده‌اید یادداشت کنید.
با پشتیبانی OpenAI تماس بگیرید
اگر پس از بررسی محدودیت گزارش‌شده نتوانستید مشکل را برطرف کنید، از طریق مرکز راهنمایی با پشتیبانی OpenAI تماس بگیرید. کلیدهای API یا سایر اطلاعات محرمانهٔ احراز هویت را ارسال نکنید.