عبور از سهمیه Gemini API (429 RESOURCE_EXHAUSTED)
Gemini API وقتی از یک محدودیت نرخ یا سهمیه روزانه عبور کنید، خطای 429 RESOURCE_EXHAUSTED برمیگرداند. در سطح رایگان، محدودیتها کوچک هستند. این صفحه هر شکل از این خطا، محدودیتهای فعلی رایگان و راهحلهای کارآمد را توضیح میدهد.
کد، نام مدلها و برچسبهای زندهٔ کاتالوگ به زبان انگلیسی نمایش داده میشوند.
شکل خطا
یک خطای معمول سطح رایگان، همانطور که در انجمن توسعهدهندگان Google منتشر شده، این بخشها را دارد:
نمونه خطای 429 از سطح رایگان
429 RESOURCE_EXHAUSTED
You exceeded your current quota, please check your plan and billing details.
Quota exceeded for metric: generativelanguage.googleapis.com/generate_content_free_tier_requests, limit: 50
quotaId: GenerateRequestsPerDayPerProjectPerModel-FreeTier
Please retry in 11.615098148s.quotaMetricنشان میدهد چه چیزی تمام شده است.generate_content_free_tier_requestsدرخواستهای سطح رایگان را میشمارد.quotaIdبازه زمانی را نشان میدهد.PerDayسهمیه روزانه است. شناسهPerMinuteمحدودیت دقیقهای است.limitسهمیه شما برای آن مدل در آن بازه است.Please retry inمدت انتظاری را میدهد که Google پیشنهاد میکند.
سه کد 429 و یک کد 403
صفحه خطاهای API از Google سه کد خطا با HTTP 429 و یک کد مرتبط 403 را فهرست میکند:
| کد | HTTP | معنی | راهحل |
|---|---|---|---|
rate_limit_exceeded | 429 | به محدودیت درخواست یا توکن در دقیقه یا ثانیه رسیدهاید | با تأخیر تصاعدی دوباره امتحان کنید |
quota_exceeded | 429 | سهمیه روزانه تمام شده است | تا بازنشانی صبر کنید، یا افزایش سهمیه بخواهید |
too_many_requests | 429 | درخواستهای زیاد در یک بازه کوتاه | با تأخیر تصاعدی دوباره امتحان کنید |
permission_denied | 403 | پروژه محدود شده است، یا سطح رایگان برای آن در دسترس نیست | یک حساب صورتحساب متصل کنید و از سطح پولی استفاده کنید |
محدودیت دقیقهای در کمتر از یک دقیقه پاک میشود. سهمیه روزانه فقط در زمان بازنشانی پاک میشود. Google درخواستهای روزانه را در نیمهشب به وقت Pacific بازنشانی میکند. تلاش دوباره برای خطای سهمیه روزانه پیش از بازنشانی، درخواستها را هدر میدهد.
محدودیتهای سطح رایگان امروز
Google محدودیتها را برای هر پروژه Google Cloud اعمال میکند، نه برای هر کلید. محدودیتها برای هر مدل متفاوت است. Google محدودیتهای فعال شما را در AI Studio نشان میدهد. جدول، محدودیتهای رایگان Gemini و Gemma را در کاتالوگ FreeLLMAPI نشان میدهد.
| مدل | رایگان در | متن ورودی | محدودیتهای رایگان (بهترین پیشنهاد) | ابزارها | بینایی |
|---|---|---|---|---|---|
| Gemini 3.8 Flash | Google AI Studio | 1M | Recurring provider quota | بله | بله |
| Gemini Flash (latest alias) | Google AI Studio | - | 10 درخواست در دقیقه 20 درخواست در روز 250,000 توکن در دقیقه ~3M | بله | بله |
| Gemini 3.7 Flash | Google AI Studio | 1M | 10 درخواست در دقیقه 20 درخواست در روز 250,000 توکن در دقیقه ~3M | بله | بله |
| Gemini 3.6 Flash | Google AI Studio | 1M | 10 درخواست در دقیقه 20 درخواست در روز 250,000 توکن در دقیقه ~3M | بله | بله |
| Gemini 3.5 Flash | Google AI Studio | 1M | 10 درخواست در دقیقه 20 درخواست در روز 250,000 توکن در دقیقه ~3M | بله | بله |
| Gemini 3.8 Live | Google AI Studio | - | 10 درخواست در دقیقه 20 درخواست در روز 250,000 توکن در دقیقه ~3M | بله | بله |
| Gemini 3.8 Live Extended Thinking | Google AI Studio | - | 10 درخواست در دقیقه 20 درخواست در روز 250,000 توکن در دقیقه ~3M | بله | بله |
| Gemini 3.8 Flash TTS | Google AI Studio | - | Ongoing AI Studio free-tier quota; account limits apply | خیر | خیر |
| Gemini 3.8 Flash-Lite TTS | Google AI Studio | - | Ongoing AI Studio free-tier quota; account limits apply | خیر | خیر |
| Gemini Robotics-ER 2 Preview | Google AI Studio | 131K | 10 درخواست در دقیقه 20 درخواست در روز 250,000 توکن در دقیقه ~3M | خیر | بله |
| Gemini 3.5 Flash Lite | Google AI Studio | 1M | 15 درخواست در دقیقه 20 درخواست در روز 250,000 توکن در دقیقه ~3M | بله | بله |
| Gemini Flash Lite (latest alias) | Google AI Studio | - | 10 درخواست در دقیقه 20 درخواست در روز 250,000 توکن در دقیقه ~3M | بله | بله |
نمایش 12 مدل رایگان مطابق از 21 مدل. مشاهده همه مدلها.
دادههای زنده از کاتالوگ FreeLLMAPI (نسخه 2026.11.19، بررسیشده در 2026-11-19). محدودیتهای رایگان اغلب تغییر میکنند. کاتالوگ هر روز بررسی میشود.
بیشتر مدلهای Flash در سطح رایگان حدود 20 درخواست در روز مجاز میکنند. مدلهای Gemma درخواستهای روزانه بسیار بیشتری مجاز میکنند، اما پنجره متن کوچکتری دارند. Google میگوید محدودیتهای اعلامشده تضمین نشدهاند و ظرفیت واقعی ممکن است تغییر کند.
راهحلهای کارآمد
quotaIdرا بخوانید. اگرPerDayداشته باشد، متوقف شوید و تا بازنشانی نیمهشب به وقت Pacific صبر کنید.- برای محدودیت دقیقهای، با تأخیر تصاعدی و jitter دوباره امتحان کنید. یک حداکثر تعداد تلاش تعیین کنید.
- کارهای ساده را به مدلی با سقف روزانه بالاتر منتقل کنید، برای مثال یک مدل Gemma یا Flash-Lite.
- توکن کمتری بفرستید. درخواستهای بزرگ خیلی زود به محدودیت توکن در دقیقه میرسند.
- یک
max_tokensخیلی کوچک استفاده نکنید. Gemini Flash میتواند توکنهای استدلال پنهان را درون سقف خروجی مصرف کند.
| آنچه امتحان میکنید | کمک میکند؟ | چرا |
|---|---|---|
| یک کلید API جدید در همان پروژه بسازید | خیر | محدودیتها برای پروژه اعمال میشوند. Google میگوید کلید جدید این خطا را حل نمیکند. |
| پروژه را به سطح پولی ارتقا دهید | سهمیه پولی میدهد | Google میگوید سطح پولی سهمیه سطح رایگان به شما نمیدهد. استفاده پولی صورتحساب میشود. |
برای زمان retry in صبر کنید | بله، برای محدودیتهای دقیقهای | بازه دقیقهای ریست میشود |
| به یک مدل دیگر تغییر دهید | بله | هر مدل سهمیه خودش را دارد |
پیش از ارسال سهمیه را بررسی کنید
میتوانید مشکل را پیش از خطا ببینید. در AI Studio، صفحه محدودیت نرخ را از مستندات Gemini API باز کنید. محدودیتهای فعال پروژه شما را برای هر مدل نشان میدهد. صفحه Projects سطح شما را نشان میدهد.
اگر از FreeLLMAPI استفاده میکنید، از درگاه بپرسید کدام مدلها همین حالا آماده هستند. مدلی با وضعیت exhausted کلیدهایی دارد که همه در دوره استراحت هستند. این وضعیت وقتی دورههای استراحت تمام شوند، خودبهخود پاک میشود.
فهرست مدلهایی که اکنون میتوانند پاسخ دهند
curl "http://localhost:3001/v1/models?execution_status=ready" \
-H "Authorization: Bearer <unified-key>"استفاده روزانه خود را با عددهای ساده برنامهریزی کنید. با 20 درخواست در روز، یک مدل Flash در یک روز کامل حدود یک درخواست هر 72 دقیقه میدهد. یک عامل برنامهنویسی میتواند برای یک کار 20 درخواست مصرف کند. مدلهای Flash را فقط برای کارهای سخت نگه دارید و کارهای ساده را به مدلهایی با سقف روزانه بالاتر بفرستید.
جایگزینی با ارائهدهندگان رایگان دیگر
با حدود 20 درخواست Flash در روز، یک کلید Gemini برای کار عامل کافی نیست. FreeLLMAPI، Gemini را همراه با ارائهدهندگان رایگان دیگر پشت یک نقطه پایانی قرار میدهد. وقتی Gemini خطای 429 بفرستد، روتر درخواست را به مدل بعدی زنجیره شما میفرستد.
- روتر RPM، RPD، TPM و TPD را برای هر مدل و کلید میشمارد. پیش از رسیدن به یک محدودیت شناختهشده متوقف میشود.
- یک خطای 429 کوتاه، کلید را برای 90 ثانیه در دوره استراحت قرار میدهد. سهمیه روزانه پر، دوره استراحت طولانیتری دارد: 2 دقیقه، 10 دقیقه، 1 ساعت، سپس 24 ساعت.
- اگر Google زمان تلاش مجدد طولانیتری بدهد، روتر مقدار Google را استفاده میکند.
- هدر
X-Fallback-Trailهر مرحله ناموفق را فهرست میکند، برای مثالgoogle/gemini-2.5-flash key1=rate_limited.
ترافیک Gemini را از طریق درگاه بفرستید
curl -fsSL https://freellmapi.co/install.sh | bash
curl -i http://localhost:3001/v1/chat/completions \
-H "Authorization: Bearer <unified-key>" \
-H "Content-Type: application/json" \
-d '{"model": "auto", "messages": [{"role": "user", "content": "hi"}]}'Gemini CLI هم میتواند از سطح بومی /v1beta درگاه استفاده کند. درگاه سهمیه Gemini اضافه نمیکند. وقتی Gemini به محدودیت خود رسیده باشد، از ارائهدهندگان دیگر استفاده میکند.
نکتههای شناختهشده درباره Gemini
| ارائهدهنده | مشکل شناختهشده | چه کاری انجام دهید |
|---|---|---|
| Google AI Studio | Thinking tokens use output cap | Gemini Flash can spend hidden thinking tokens inside maxOutputTokens. Avoid tiny max_tokens values or set thinkingBudget to 0 when provider support is available. |
دادههای زنده از کاتالوگ FreeLLMAPI (نسخه 2026.11.19، بررسیشده در 2026-11-19). محدودیتهای رایگان اغلب تغییر میکنند. کاتالوگ هر روز بررسی میشود.
پرسشهای متداول
معنی 429 RESOURCE_EXHAUSTED در Gemini API چیست؟
یعنی پروژه شما از یک محدودیت نرخ یا سهمیه عبور کرده است. quotaId در بدنه خطا نشان میدهد که آیا محدودیت دقیقهای است یا سهمیه روزانه.
سهمیه سطح رایگان Gemini کی بازنشانی میشود؟
درخواستهای روزانه در نیمهشب به وقت Pacific بازنشانی میشوند. محدودیتهای دقیقهای در کمتر از یک دقیقه بازنشانی میشوند.
چرا یک کلید جدید Gemini API خطای سهمیه را برطرف نمیکند؟
Google محدودیتها را برای پروژه Google Cloud اعمال میکند، نه برای کلید. هر کلید در همان پروژه، سهمیه یکسانی دارد.
«limit: 0» در یک خطای سهمیه Gemini یعنی چه؟
یعنی پروژه شما در آن بازه سهمیه رایگان برای آن مدل ندارد. برخی پروژهها واجد شرایط سطح رایگان نیستند. محدودیتهای خود را در AI Studio بررسی کنید یا یک مدل دیگر امتحان کنید.
چگونه خطاهای 429 در Gemini را در یک عامل برنامهنویسی نگیرم؟
چند ارائهدهنده رایگان را پشت یک درگاه استفاده کنید. وقتی Gemini به محدودیت خود برسد، درگاه درخواست را به ارائهدهنده دیگری میفرستد و عامل ادامه میدهد.
راهنماهای مرتبط
- محدودیت نرخ API رایگان LLM
- free gemini api
- Gemini CLI با یک نقطه پایانی سفارشی و مدلهای رایگان
- محدودیت نرخ Groq رسیده است (429)
- محدودیت نرخ NVIDIA NIM API
منابع
- Google AI Studio: Rate limits (بررسیشده در 20 November 2026)
- Google AI Studio: API errors (بررسیشده در 20 November 2026)
- Google AI Studio: Troubleshooting (بررسیشده در 20 November 2026)
- Google developer forum: free tier quota error example (بررسیشده در 20 November 2026)
- FreeLLMAPI docs: Quota and cooldown engine (بررسیشده در 20 November 2026)
- FreeLLMAPI docs: Response headers (بررسیشده در 20 November 2026)