Превышена квота 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?
Запросы в день сбрасываются в полночь по тихоокеанскому времени. Минутные лимиты сбрасываются в течение одной минуты.
Почему новый ключ Gemini API не исправляет ошибку квоты?
Google применяет лимиты к проекту Google Cloud, а не к ключу. Каждый ключ в одном проекте использует одну и ту же квоту.
Что означает limit: 0 в ошибке квоты Gemini?
Это значит, что в вашем проекте нет бесплатной квоты для этой модели в этом окне. Некоторые проекты не имеют права на бесплатный тариф. Проверьте лимиты в AI Studio или попробуйте другую модель.
Как избежать ошибок Gemini 429 в агенте для программирования?
Используйте несколько бесплатных провайдеров за одним шлюзом. Когда Gemini достигает лимита, шлюз отправляет запрос другому провайдеру, и агент продолжает работу.
Похожие руководства
- Лимиты запросов бесплатного LLM API
- 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)