Главная / Руководства / Превышена квота 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 сбрасывает дневные запросы в полночь по тихоокеанскому времени. Повтор запроса при ошибке дневной квоты до сброса тратит запросы впустую.

Лимиты бесплатного тарифа сегодня

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, остановитесь и дождитесь сброса в полночь по тихоокеанскому времени.
  2. При минутном лимите повторяйте запрос с экспоненциальной задержкой и джиттером. Задайте максимальное число повторов.
  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?

Запросы в день сбрасываются в полночь по тихоокеанскому времени. Минутные лимиты сбрасываются в течение одной минуты.

Почему новый ключ Gemini API не исправляет ошибку квоты?

Google применяет лимиты к проекту Google Cloud, а не к ключу. Каждый ключ в одном проекте использует одну и ту же квоту.

Что означает limit: 0 в ошибке квоты Gemini?

Это значит, что в вашем проекте нет бесплатной квоты для этой модели в этом окне. Некоторые проекты не имеют права на бесплатный тариф. Проверьте лимиты в AI Studio или попробуйте другую модель.

Как избежать ошибок Gemini 429 в агенте для программирования?

Используйте несколько бесплатных провайдеров за одним шлюзом. Когда Gemini достигает лимита, шлюз отправляет запрос другому провайдеру, и агент продолжает работу.

Похожие руководства

Источники

Все руководства · Смотреть все бесплатные модели