Ошибка 429 Gemini при генерации изображений: какой лимит сработал

Ошибка 429 (RESOURCE_EXHAUSTED, «Too Many Requests») при генерации изображений через Gemini API означает, что проект упёрся в один из лимитов Google, а не что модель сломалась. Лимитов несколько, и лечатся они по-разному: поминутный проходит сам через несколько секунд или минуту, суточная квота сбрасывается только в полночь по тихоокеанскому времени, лимит расходов считается за скользящие 10 минут, а у проекта на бесплатном уровне генерация изображений не заработает вовсе — для моделей изображений бесплатного вывода нет. Сначала определите, какой из них сработал, и только потом решайте, повторять ли запрос.

Всё ниже относится к Gemini Developer API (ключ из Google AI Studio) и трём текущим моделям изображений: Nano Banana 2 Lite (gemini-3.1-flash-lite-image), Nano Banana 2 (gemini-3.1-flash-image) и Nano Banana Pro (gemini-3-pro-image). Цены и правила — по состоянию на 5 октября 2026 года.

Какой 429 вы получили: таблица диагностики

В ответе Interactions API у ошибки есть поле code, и оно прямо называет причину: rate_limit_exceeded (поминутный или посекундный лимит), quota_exceeded (суточная квота) или too_many_requests (слишком много запросов за короткое время). В generateContent приходят HTTP 429 и статус RESOURCE_EXHAUSTED, а причину приходится читать в тексте сообщения и в его details. Если тип не назван, его выдаёт поведение ошибки:

Рядом с 429 часто путают ещё два кода. HTTP 402 Payment Required — это закончившийся баланс предоплаты (Prepay): Google прямо пишет не повторять такой запрос, пока не пополнен счёт. HTTP 503 — перегрузка на стороне Google, а не ваш лимит; о ней отдельно — в разборе ошибки 503 у Nano Banana Pro и в материале про ошибку Gemini High Demand. Повторять стоит только временные ошибки (429, 408, 5xx); 400, 402 и 403 повтор не исправит — об этом же говорит руководство Google по устранению неполадок.

Как Gemini API считает лимиты для изображений: проект, IPM и AI Studio

Главное правило из страницы лимитов Google (обновлена 2 сентября 2026 года): лимиты действуют на проект, а не на API-ключ. Пять ключей в одном проекте делят одну и ту же квоту, поэтому создание новых ключей 429 не снимает.

Внутри проекта использование сверяется сразу с несколькими лимитами, и превышение любого из них даёт ошибку:

• RPM — запросы в минуту;
• TPM — входные токены в минуту;
• RPD — запросы в сутки, сброс в полночь по тихоокеанскому времени. Для Москвы это 10:00, пока в США действует летнее время (до 1 ноября 2026 года), и 11:00 зимой;
• IPM — изображения в минуту. Этот лимит считается только у моделей, которые генерируют изображения (семейство Nano Banana), и по смыслу похож на TPM.

Конкретных чисел RPM, IPM и RPD для текущих моделей изображений на странице Google нет: таблица там до сих пор перечисляет старые preview-модели. Ваши действующие значения показывает только Google AI Studio (раздел лимитов проекта), и они меняются вместе с уровнем и состоянием аккаунта. Google отдельно оговаривает, что указанные лимиты не гарантированы и реальная ёмкость может отличаться. Поэтому таблицы вида «Tier 1 — столько-то изображений в минуту» из сторонних статей не годятся для расчётов: сверяйтесь с AI Studio.

Ещё два правила, которые влияют на 429:

• у Priority-обработки (Priority inference) свои лимиты — по умолчанию 0,3 от стандартных для той же модели и уровня, так что переход на Priority может сделать 429 чаще;
• у Batch API лимиты отдельные от обычных вызовов (подробнее ниже).

Общие правила лимитов для всех моделей Gemini — в отдельном руководстве по лимитам Gemini API и причинам 429.

Лимит расходов $10 за 10 минут: сколько это изображений

Кроме лимитов по запросам и токенам, Gemini API ограничивает расходы за скользящее 10-минутное окно. При превышении приходит тот же 429 RESOURCE_EXHAUSTED. Действует этот лимит не на всех аккаунтах: Google пишет, что это зависит от истории оплат, уровня и состояния аккаунта.

Цена изображения в заголовках столбцов — это выходные токены картинки, умноженные на ставку с страницы цен Google:

• Nano Banana Pro, 1K и 2K: 1 120 токенов × $120 за 1 млн = $0,1344 (Google округляет до $0,134); 4K: 2 000 × $120 / 1 000 000 = $0,24;
• Nano Banana 2, 1K: 1 120 × $60 / 1 000 000 = $0,0672 (в прайсе $0,067);
• Nano Banana 2 Lite, 1K: 1 120 × $30 / 1 000 000 = $0,0336.

Число изображений — лимит, делённый на цену, с округлением вниз: для Tier 1 и Pro 1K это 10 / 0,1344 = 74,4, то есть 74 изображения; для Nano Banana 2 — 10 / 0,0672 = 148,8, то есть 148. В среднем это около 7 изображений Pro в минуту на Tier 1 (74 / 10). Реальное число будет меньше: в расчёт не вошли входные токены (промпт, референсы — у Pro один референс стоит около $0,0011) и «размышления» Pro, которые включены по умолчанию и оплачиваются как текстовый вывод по $12 за 1 млн токенов.

Что делать при этом 429, Google перечисляет сам: подождать и повторить через короткое время, снизить частоту дорогих запросов, а если лимит мешает при обычной работе — запросить его повышение. На практике проще всего разнести 4K-запросы Pro во времени или перевести массовые задачи в Batch.

Бесплатный проект и limit: 0: у моделей изображений нет бесплатного уровня

Если 429 приходит на первом же запросе к модели изображений, а в тексте ошибки, как обычно бывает в таких случаях, есть free_tier_requests и limit: 0, проект работает на бесплатном уровне. На странице цен Google у всех трёх моделей изображений в колонке бесплатного уровня для вывода изображений стоит «Not available», поэтому квота такого проекта для них равна нулю. Ждать сброса бессмысленно: ноль не вырастет.

Чтобы генерировать изображения, к проекту нужно привязать платёжный аккаунт. Новые аккаунты с 23 марта 2026 года по умолчанию работают по предоплате, минимальное пополнение — $5. Пошаговая настройка ключа и оплаты — в руководстве по Gemini Image API. Если оплата уже подключена, а ошибка с free_tier_requests всё равно идёт, разбирайте её по материалу «free_tier_requests limit 0 на платном тарифе»: почти всегда дело в том, что приложение отправляет ключ другого проекта.

429 при нулевом использовании: обычно не тот проект или ключ

Когда в AI Studio видно, что проект почти не тратил квоту, а приложение получает 429, проверьте связку «ключ — проект — оплата — модель» по порядку:

1. Какому проекту принадлежит ключ. В AI Studio на странице ключей у каждого ключа указан проект. Ключ из старого тестового проекта будет упираться в лимиты бесплатного уровня, даже если оплату вы подключили к другому проекту.
2. Привязан ли платёжный аккаунт именно к этому проекту и есть ли положительный баланс предоплаты. При нулевом балансе Google отвечает 402, а не 429.
3. Какой уровень у проекта. Уровни видны на странице Projects в AI Studio. Переход с Free на Tier 1 после настройки оплаты обычно срабатывает сразу, следующие повышения — в течение 10 минут.
4. Какая модель указана в коде. Текущие ID — gemini-3.1-flash-lite-image, gemini-3.1-flash-image и gemini-3-pro-image. Preview-версии отключены 25 июня 2026 года, а gemini-2.5-flash-image (первая Nano Banana) — 2 октября 2026 года; код со старыми ID нужно переписать, и лимиты тут ни при чём.
5. Не работает ли параллельно другое приложение или задание с ключом того же проекта: квота у них общая.

Если всё совпадает, а 429 с нулевой квотой остаётся, повторами его не исправить — остановите их и обратитесь в поддержку Google.

Уровни Tier 1, Tier 2 и Tier 3: условия перехода

Уровень проекта определяет и лимиты по запросам, и лимит расходов. Повышение происходит автоматически, когда проект выполняет условия:

Условия Tier 2 и Tier 3 считаются по всем расходам на Google Cloud в платёжном аккаунте, привязанном к проекту, а не только по Gemini API. Google предупреждает, что в редких случаях повышение могут не одобрить даже при выполненных условиях. Если лимитов текущего уровня стабильно не хватает, подайте запрос на увеличение лимитов платного уровня (ссылка на форму есть на странице лимитов Google); гарантий Google не даёт, но обещает рассмотреть.

Повтор с экспоненциальной задержкой на Python

Для поминутного лимита и лимита расходов правильная реакция — повтор с растущей паузой: 1, 2, 4, 8 секунд и так далее, плюс случайная добавка (джиттер), чтобы ваши воркеры не возвращались одновременно, и ограничение числа попыток. Суточную квоту и limit: 0 повторять бесполезно.

По руководству Google официальный Python SDK сам повторяет временные ошибки до четырёх раз с паузой примерно от 1 до 60 секунд. В текущей версии пакета google-genai (2.28.0) это не так: клиент, созданный как genai.Client(), отправляет один запрос и сразу выбрасывает ClientError с кодом 429. Это касается client.models.generate_content: client.interactions.create в той же версии повторяет 429 сам (четыре запроса примерно за 3 секунды). Повторы включаются явно:

from google import genai
from google.genai import types

client = genai.Client(
    http_options=types.HttpOptions(
        retry_options=types.HttpRetryOptions()  # 5 попыток, пауза от ~1 до 60 с, коды 408, 429, 5xx
    )
)

С пустым HttpRetryOptions() SDK делает до пяти попыток, считая первую. Число попыток и паузы задаются параметрами attempts, initial_delay, max_delay. Минус такого варианта — SDK повторяет любой 429, включая суточную квоту. Если нужно отличать один 429 от другого, напишите цикл сами и не включайте при этом HttpRetryOptions, иначе попытки перемножатся:

import random
import time

from google import genai
from google.genai import errors

client = genai.Client()  # ключ из переменной окружения GEMINI_API_KEY

# Признаки квоты, которую ожидание в пределах минуты не вернёт
STOP_MARKERS = ("limit: 0", "PerDay")


def generate_with_backoff(prompt: str, max_attempts: int = 6, cap: float = 60.0):
    for attempt in range(max_attempts):
        try:
            return client.models.generate_content(
                model="gemini-3.1-flash-image",
                contents=prompt,
            )
        except errors.APIError as e:
            if e.code not in (429, 500, 503):
                raise  # 400, 402, 403, 404: повтор не поможет
            if e.code == 429 and any(m in str(e) for m in STOP_MARKERS):
                raise  # суточная или нулевая квота: ждать минуту бесполезно
            if attempt == max_attempts - 1:
                raise
            time.sleep(min(cap, 2 ** attempt) + random.uniform(0, 1))

Поведение обоих вариантов воспроизводится с google-genai 2.28.0 на локальном сервере-заглушке, который отвечает 429: без retry_options уходит один запрос, с HttpRetryOptions — несколько с растущей паузой; цикл выше после двух ответов 429 получает ответ с третьей попытки, а на сообщении с limit: 0 останавливается сразу. С реальной квотой Google этот код не запускался. Строки limit: 0 и PerDay — эвристика по тексту ошибки, а не документированный контракт: посмотрите, что пишет ваш собственный 429, и поправьте список. Если у ответа есть заголовок Retry-After или retryDelay в details, ждите не меньше указанного. Полная версия с этими заголовками, очередью заданий и пропуском уже сохранённых картинок — в материале о RESOURCE_EXHAUSTED в Nano Banana Pro и восстановлении генерации.

Когда вместо повторов нужен Batch API

Если вы генерируете сотни изображений и результат не нужен сию минуту, повторы — не лучший инструмент. У Batch API лимиты отдельные от обычных вызовов (до 100 одновременных пакетных запросов, свой лимит токенов в очереди на модель), а цена — половина стандартной. Целевое время выполнения — до 24 часов, хотя многие задания завершаются заметно быстрее.

Batch-цены на изображение по состоянию на 4 октября 2026 года: Nano Banana Pro — $0,067 за 1K/2K и $0,12 за 4K; Nano Banana 2 — $0,034 за 1K (точнее $0,0336); Nano Banana 2 Lite — $0,0168. Расчёт счёта и сравнение с другими вариантами — в статье про цены Nano Banana Pro Batch API. Для сравнения: сторонний шлюз laozhang.ai указывает $0,09 за вызов gemini-3-pro-image в 1K, 2K или 4K и $0,055 за gemini-3.1-flash-image (публичные цены на 24 сентября 2026 года); это отдельный договор со своими условиями, а изображения по-прежнему генерирует модель Google.

Примечание: laozhang.ai — наш собственный сервис; его цены — наши тарифы, а не независимое сравнение.

429 в Vertex AI: общая ёмкость, а не ваша квота

В Vertex AI (в документации Google Cloud он теперь называется Gemini Enterprise Agent Platform) 429 на модели с оплатой по мере использования обычно означает, что запросу не хватило общей ёмкости, а не что вы исчерпали личную квоту; сообщение звучит как «Resource exhausted, please try again later». Страница Google Cloud об ошибке 429 советует по возможности использовать глобальный эндпоинт вместо регионального, повторять с ограниченной экспоненциальной задержкой, сглаживать пики и наращивать трафик постепенно, для моделей с квотами — подать запрос на её увеличение, а для стабильной ёмкости — купить Provisioned Throughput. Уровни Tier 1–3 и лимит расходов из этой статьи относятся к Gemini Developer API, а не к Vertex AI.

Как устранить ошибку 429 и не получить её снова

Законных рычагов четыре: подождать (поминутный лимит и лимит расходов сбрасываются сами, суточная квота — в полночь по тихоокеанскому времени), снизить частоту и параллельность запросов, увести массовую генерацию в Batch и повысить уровень проекта или запросить увеличение лимита. Не помогают новые ключи в том же проекте, более агрессивные повторы и повторы ошибок 400, 402 и 403. Если наряду с 429 вы видите пустые ответы или блокировки, загляните в общий разбор ошибок генерации изображений Gemini.

Что означает код 429 в Gemini API?

Это HTTP 429 Too Many Requests со статусом RESOURCE_EXHAUSTED: проект превысил один из лимитов — в минуту, в сутки, по расходам за 10 минут — или у него нулевая квота на модель изображений. Ошибка не значит, что запрос неверен, и не значит, что Google лёг: при перегрузке Google отвечает 503.

Помогут ли несколько API-ключей в одном проекте?

Нет, если ключи созданы в одном проекте: Google считает лимиты на проект, и все ключи делят одну квоту. Отдельные проекты получают отдельные лимиты, но каждому нужен свой платёжный аккаунт и свой уровень, а условия Tier 2 и Tier 3 считаются по расходам платёжного аккаунта.

Работает ли Gemini API из России?

Нет: по состоянию на 5 октября 2026 года Россия не входит в список регионов Gemini API и Google AI Studio (список обновлён 28 апреля 2026 года). Что из сервисов Google с Nano Banana доступно и недоступно для России, разобрано в статье «Nano Banana бесплатно: что даёт Google и что доступно из России».