خانه / راهنماها / عبور از سهمیه Gemini API (429 RESOURCE_EXHAUSTED)

عبور از سهمیه 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 را فهرست می‌کند:

از صفحه خطاهای Gemini API
کدHTTPمعنیراه‌حل
rate_limit_exceeded429به محدودیت درخواست یا توکن در دقیقه یا ثانیه رسیده‌ایدبا تأخیر تصاعدی دوباره امتحان کنید
quota_exceeded429سهمیه روزانه تمام شده استتا بازنشانی صبر کنید، یا افزایش سهمیه بخواهید
too_many_requests429درخواست‌های زیاد در یک بازه کوتاهبا تأخیر تصاعدی دوباره امتحان کنید
permission_denied403پروژه محدود شده است، یا سطح رایگان برای آن در دسترس نیستیک حساب صورتحساب متصل کنید و از سطح پولی استفاده کنید

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

محدودیت‌های سطح رایگان امروز

Google محدودیت‌ها را برای هر پروژه Google Cloud اعمال می‌کند، نه برای هر کلید. محدودیت‌ها برای هر مدل متفاوت است. Google محدودیت‌های فعال شما را در AI Studio نشان می‌دهد. جدول، محدودیت‌های رایگان Gemini و Gemma را در کاتالوگ FreeLLMAPI نشان می‌دهد.

محدودیت‌های رایگان Gemini و Gemma از کاتالوگ امروز
مدلرایگان درمتن ورودیمحدودیت‌های رایگان (بهترین پیشنهاد)ابزارهابینایی
Gemini 3.8 FlashGoogle AI Studio1MRecurring provider quotaبلهبله
Gemini Flash (latest alias)Google AI Studio-10 درخواست در دقیقه
20 درخواست در روز
250,000 توکن در دقیقه
~3M
بلهبله
Gemini 3.7 FlashGoogle AI Studio1M10 درخواست در دقیقه
20 درخواست در روز
250,000 توکن در دقیقه
~3M
بلهبله
Gemini 3.6 FlashGoogle AI Studio1M10 درخواست در دقیقه
20 درخواست در روز
250,000 توکن در دقیقه
~3M
بلهبله
Gemini 3.5 FlashGoogle AI Studio1M10 درخواست در دقیقه
20 درخواست در روز
250,000 توکن در دقیقه
~3M
بلهبله
Gemini 3.8 LiveGoogle AI Studio-10 درخواست در دقیقه
20 درخواست در روز
250,000 توکن در دقیقه
~3M
بلهبله
Gemini 3.8 Live Extended ThinkingGoogle AI Studio-10 درخواست در دقیقه
20 درخواست در روز
250,000 توکن در دقیقه
~3M
بلهبله
Gemini 3.8 Flash TTSGoogle AI Studio-Ongoing AI Studio free-tier quota; account limits applyخیرخیر
Gemini 3.8 Flash-Lite TTSGoogle AI Studio-Ongoing AI Studio free-tier quota; account limits applyخیرخیر
Gemini Robotics-ER 2 PreviewGoogle AI Studio131K10 درخواست در دقیقه
20 درخواست در روز
250,000 توکن در دقیقه
~3M
خیربله
Gemini 3.5 Flash LiteGoogle AI Studio1M15 درخواست در دقیقه
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 می‌گوید محدودیت‌های اعلام‌شده تضمین نشده‌اند و ظرفیت واقعی ممکن است تغییر کند.

راه‌حل‌های کارآمد

  1. quotaId را بخوانید. اگر PerDay داشته باشد، متوقف شوید و تا بازنشانی نیمه‌شب به وقت Pacific صبر کنید.
  2. برای محدودیت دقیقه‌ای، با تأخیر تصاعدی و jitter دوباره امتحان کنید. یک حداکثر تعداد تلاش تعیین کنید.
  3. کارهای ساده را به مدلی با سقف روزانه بالاتر منتقل کنید، برای مثال یک مدل Gemma یا Flash-Lite.
  4. توکن کمتری بفرستید. درخواست‌های بزرگ خیلی زود به محدودیت توکن در دقیقه می‌رسند.
  5. یک 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 StudioThinking tokens use output capGemini 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). محدودیت‌های رایگان اغلب تغییر می‌کنند. کاتالوگ هر روز بررسی می‌شود.

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

پرسش‌های متداول

معنی 429 RESOURCE_EXHAUSTED در Gemini API چیست؟

یعنی پروژه شما از یک محدودیت نرخ یا سهمیه عبور کرده است. quotaId در بدنه خطا نشان می‌دهد که آیا محدودیت دقیقه‌ای است یا سهمیه روزانه.

سهمیه سطح رایگان Gemini کی بازنشانی می‌شود؟

درخواست‌های روزانه در نیمه‌شب به وقت Pacific بازنشانی می‌شوند. محدودیت‌های دقیقه‌ای در کمتر از یک دقیقه بازنشانی می‌شوند.

چرا یک کلید جدید Gemini API خطای سهمیه را برطرف نمی‌کند؟

Google محدودیت‌ها را برای پروژه Google Cloud اعمال می‌کند، نه برای کلید. هر کلید در همان پروژه، سهمیه یکسانی دارد.

«limit: 0» در یک خطای سهمیه Gemini یعنی چه؟

یعنی پروژه شما در آن بازه سهمیه رایگان برای آن مدل ندارد. برخی پروژه‌ها واجد شرایط سطح رایگان نیستند. محدودیت‌های خود را در AI Studio بررسی کنید یا یک مدل دیگر امتحان کنید.

چگونه خطاهای 429 در Gemini را در یک عامل برنامه‌نویسی نگیرم؟

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

راهنماهای مرتبط

منابع

همه راهنماها · مرور همه مدل‌های رایگان