Коротко
Ответ 429 со статусом "RESOURCE_EXHAUSTED" означает, что ваш проект Google Cloud превысил один из лимитов Gemini API: запросы в минуту (RPM), входные токены в минуту (TPM), запросы в сутки (RPD) или, на платных уровнях, лимит по расходам. На странице лимитов Google пишет, что превышение любого из них вызывает эту ошибку.
Что делать, зависит от того, какой лимит сработал:
- Поминутный лимит: подождите и повторите запрос с экспоненциальной задержкой. Официальные SDK уже делают это сами.
- Суточная квота: повторы не помогут до сброса в полночь по тихоокеанскому времени. Переведите проект на платный уровень, смените модель или подождите.
- Лимит по расходам (платные уровни): уменьшите число дорогих запросов или запросите повышение лимита.
Лимиты считаются на проект, а не на ключ, поэтому новый ключ в том же проекте упрётся в ту же стену. Если не хотите настраивать биллинг Google, Gemini можно вызывать через TeamoRouter — один ключ с оплатой по факту, пополнение от $5.
Как выглядит ошибка
Это тело ошибки суточной квоты из google-gemini/gemini-cli#9248 (сентябрь 2025 года, gemini-2.5-pro, бесплатный уровень). Экранирование убрано, ссылка Help опущена:
{
"error": {
"code": 429,
"message": "You exceeded your current quota, please check your plan and billing details. For more information on this error, head to: https://ai.google.dev/gemini-api/docs/rate-limits.\n* Quota exceeded for metric: generativelanguage.googleapis.com/generate_content_free_tier_requests, limit: 50\nPlease retry in 34.074824224s.",
"status": "RESOURCE_EXHAUSTED",
"details": [
{
"@type": "type.googleapis.com/google.rpc.QuotaFailure",
"violations": [
{
"quotaMetric": "generativelanguage.googleapis.com/generate_content_free_tier_requests",
"quotaId": "GenerateRequestsPerDayPerProjectPerModel-FreeTier",
"quotaDimensions": { "location": "global", "model": "gemini-2.5-pro" },
"quotaValue": "50"
}
]
},
{
"@type": "type.googleapis.com/google.rpc.RetryInfo",
"retryDelay": "34s"
}
]
}
}
В сообщении предлагается повторить через 34 секунды, но это суточная квота — через 34 секунды запрос снова не пройдёт. Надёжное поле — quotaId.
Какой лимит сработал
Смотрите quotaId в блоке google.rpc.QuotaFailure:
quotaId содержит |
Лимит | Что делать |
|---|---|---|
PerMinute, например GenerateRequestsPerMinutePerProjectPerModel-FreeTier |
Запросы или токены в минуту | Подождать и повторить после retryDelay |
PerDay, например GenerateRequestsPerDayPerProjectPerModel-FreeTier |
Запросы в сутки | Не повторять; ждать полуночи по тихоокеанскому времени, сменить уровень или модель |
FreeTier |
Лимиты бесплатного уровня | Привязка биллинга переводит проект на Tier 1 |
Собственный Gemini CLI от Google считает quotaId с PerDay или Daily окончательной ошибкой и не повторяет запрос (UKGovernmentBEIS/inspect_ai#5526 указывает на этот код). Если в сообщении limit: 0, у проекта вообще нет квоты на эту модель; проект inspect_ai сразу завершает такие запросы с ошибкой, потому что это значит «модель или функция полностью ограничена» (inspect_ai#3215).
Лимиты по расходам. На платных уровнях Google также ограничивает расходы в скользящем 10-минутном окне: $10 на Tier 1, $200 на Tier 2 и $200 на Tier 3 (страница лимитов Google, данные на 18 ноября 2026 года). Превышение возвращает ту же 429 RESOURCE_EXHAUSTED. Google советует подождать, отправлять меньше дорогих запросов (короче контекст и ответы) или запросить повышение лимита.
Gemini 4 быстро упирается в лимит Tier 1. Gemini 4 Argon и Carbon по вводной цене стоят $10 за миллион выходных токенов, а токены размышлений считаются выходными. Миллион выходных токенов за 10 минут — это реально для долгого агентного запуска или нескольких параллельных задач — уже $10, то есть весь лимит Tier 1. С 1 декабря 2026 года обе модели стоят $20 за миллион выходных токенов, и тот же лимит наступает вдвое быстрее. Gemini 4 Hydrogen стоит $7,50 за миллион выходных токенов. Для Tier 2 нужно $100 оплат и 3 дня с первой из них.
Это не то же самое, что закончившиеся средства. Когда баланс Prepay доходит до $0, Gemini API возвращает 402, а не 429. В руководстве по устранению неполадок Google пишет, что 402 повторять вообще не нужно — нужно пополнить баланс.
Как исправить на стороне Google
- Проверьте действующие лимиты. Они зависят от модели и уровня и показываются в Google AI Studio. Google отмечает, что опубликованные лимиты не гарантируются.
- Не создавайте новые ключи в том же проекте. Лимиты считаются на проект, дополнительные ключи делят ту же квоту.
- На поминутных ошибках делайте паузу. Официальный Python SDK сам повторяет 429 и 5xx до четырёх раз, начиная примерно с 1 секунды и до 60 секунд. Для прямых REST-вызовов используйте экспоненциальную задержку со случайным разбросом и ограничением числа повторов.
- На суточной квоте останавливайтесь. Ищите
PerDayвquotaIdи сразу завершайте:
from google import genai
from google.genai import errors
client = genai.Client()
def quota_ids(err: errors.APIError) -> list[str]:
body = err.details or {}
body = body.get("error", body)
ids = []
for detail in body.get("details", []):
if detail.get("@type", "").endswith("google.rpc.QuotaFailure"):
ids += [v.get("quotaId", "") for v in detail.get("violations", [])]
return ids
try:
resp = client.models.generate_content(model="gemini-3.8-flash", contents="Hello")
except errors.ClientError as e:
if e.code == 429 and any("PerDay" in q or "Daily" in q for q in quota_ids(e)):
raise RuntimeError("Daily Gemini quota used up; retrying won't help today") from e
raise
- Уйдите с бесплатного уровня. Привязка платёжного аккаунта и предоплата от $5 переводят бесплатный проект на Tier 1; по словам Google, обычно сразу. Следующие уровни зависят от суммарных расходов и возраста аккаунта.
- Переведите массовые задачи на Batch API. У пакетных запросов свои лимиты, отдельные от интерактивных вызовов.
Вызывайте Gemini через TeamoRouter
Если не хотите настраивать биллинг Google для проекта, TeamoRouter — другой способ вызывать Gemini. Это API-шлюз с одним ключом для Gemini, Claude, GPT и DeepSeek, с оплатой по факту из предоплаченного баланса и без подписки. Квота вашего проекта Google не меняется; запросы с ключом TeamoRouter списываются с баланса TeamoRouter.
TeamoRouter поддерживает нативный формат Gemini (/v1beta/models/{model}:generateContent) и совместимый с OpenAI /v1/chat/completions.
- Создайте API-ключ в консоли TeamoRouter. Он начинается с
sk-teamo-. - Пополните баланс от $5. Принимаются карты, а также USDT, USDC и ETH.
- Вызовите Gemini:
curl https://api.teamorouter.com/v1beta/models/gemini-4-hydrogen:generateContent \
-H "Authorization: Bearer sk-teamo-..." \
-H "content-type: application/json" \
-d '{"contents": [{"role": "user", "parts": [{"text": "Hello"}]}]}'
С Google Gen AI Python SDK укажите base URL:
from google import genai
from google.genai import types
client = genai.Client(
api_key="sk-teamo-...",
http_options=types.HttpOptions(base_url="https://api.teamorouter.com"),
)
resp = client.models.generate_content(model="gemini-4-hydrogen", contents="Hello")
print(resp.text)
Для Gemini CLI задайте три переменные (например, в ~/.gemini/.env):
GOOGLE_GEMINI_BASE_URL=https://api.teamorouter.com
GEMINI_API_KEY=sk-teamo-...
GEMINI_API_KEY_AUTH_MECHANISM=bearer
GET /v1/models показывает доступные ID моделей, в том числе gemini-4-hydrogen, gemini-4-carbon и gemini-4-argon. Остальное — в документации по подключению API.
Частые вопросы
Когда сбрасывается суточная квота? По данным страницы лимитов Google, квоты запросов в сутки сбрасываются в полночь по тихоокеанскому времени.
Я создал новый API-ключ, но всё равно получаю 429. Почему? Лимиты считаются на проект, а не на ключ. Ключ в том же проекте делит ту же квоту. Проверьте в AI Studio, к какому проекту относится ключ.
Почему для суточной квоты написано «повторить через 34 секунды»?
Задержка RetryInfo не различает поминутные и суточные лимиты. Решайте, повторять ли запрос, по quotaId.
429 RESOURCE_EXHAUSTED — это закончились деньги? Нет. Когда заканчиваются средства Prepay, возвращается 402. 429 означает, что сработал лимит скорости или расходов.
Почему с Gemini 4 Argon / Carbon 429 появляется особенно часто? На Tier 1 можно тратить только $10 за 10 минут, а эти модели по вводной цене стоят $10 за миллион выходных токенов (размышления считаются выходом), с 1 декабря — $20. Долгие или параллельные задачи быстро упираются в этот лимит.