Блог

Gemini API «429 RESOURCE_EXHAUSTED»: какой лимит вы превысили и как это исправить

Коротко

Ответ 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 опущена:

text
{
  "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

  1. Проверьте действующие лимиты. Они зависят от модели и уровня и показываются в Google AI Studio. Google отмечает, что опубликованные лимиты не гарантируются.
  2. Не создавайте новые ключи в том же проекте. Лимиты считаются на проект, дополнительные ключи делят ту же квоту.
  3. На поминутных ошибках делайте паузу. Официальный Python SDK сам повторяет 429 и 5xx до четырёх раз, начиная примерно с 1 секунды и до 60 секунд. Для прямых REST-вызовов используйте экспоненциальную задержку со случайным разбросом и ограничением числа повторов.
  4. На суточной квоте останавливайтесь. Ищите PerDay в quotaId и сразу завершайте:
python
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
  1. Уйдите с бесплатного уровня. Привязка платёжного аккаунта и предоплата от $5 переводят бесплатный проект на Tier 1; по словам Google, обычно сразу. Следующие уровни зависят от суммарных расходов и возраста аккаунта.
  2. Переведите массовые задачи на 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.

  1. Создайте API-ключ в консоли TeamoRouter. Он начинается с sk-teamo-.
  2. Пополните баланс от $5. Принимаются карты, а также USDT, USDC и ETH.
  3. Вызовите Gemini:
bash
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:

python
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):

bash
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. Долгие или параллельные задачи быстро упираются в этот лимит.

Похожие статьи

Готовы подключиться?Войдите в консоль, пополните баланс и создайте API-ключ.