Перевищено квоту 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 скидає запити на добу о півночі за тихоокеанським часом. Повторна спроба з помилкою добової квоти до скидання марнує запити.
Безкоштовні ліміти тарифу сьогодні
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, зупиніться і дочекайтеся скидання о півночі за тихоокеанським часом. - Для ліміту на хвилину повторюйте з експоненційною затримкою і джитером. Задайте максимальну кількість повторів.
- Перенесіть прості завдання на модель з вищим добовим лімітом, наприклад на 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?
Запити на добу скидаються о півночі за тихоокеанським часом. Ліміти на хвилину скидаються протягом однієї хвилини.
Чому новий ключ API Gemini не усуває помилку квоти?
Google застосовує ліміти до проєкту Google Cloud, а не до ключа. Кожен ключ у тому самому проєкті ділить одну квоту.
Що означає limit: 0 у помилці квоти Gemini?
Це означає, що ваш проєкт не має безкоштовної квоти для цієї моделі в цьому вікні. Деякі проєкти не мають права на безкоштовний тариф. Перевірте ліміти в AI Studio або спробуйте іншу модель.
Як уникнути помилок 429 Gemini в агенті програмування?
Використовуйте кількох безкоштовних постачальників за одним шлюзом. Коли Gemini досягає ліміту, шлюз надсилає запит іншому постачальнику, і агент продовжує роботу.
Схожі посібники
- Ліміти запитів безкоштовного LLM API
- free gemini api
- Gemini CLI з власною кінцевою точкою та безкоштовними моделями
- Досягнуто ліміту Groq (429)
- Ліміт API NVIDIA NIM
Джерела
- 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)