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

> 429 у моделей изображений Gemini — поминутный лимит, суточная квота, лимит расходов за 10 минут или проект без оплаты. Повтор помогает только в двух случаях.

- URL: https://blog.laozhang.ai/ru/posts/gemini-image-429-rate-limit
- Published: 2026-03-15
- Updated: 2026-10-05
- Author: LaoZhang AI Team (https://blog.laozhang.ai/ru/about)
- Topic: Руководства по API
- Tags: Gemini API, Ошибка 429, RESOURCE_EXHAUSTED, Nano Banana 2, Nano Banana Pro, Лимиты API

---
Ошибка 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 появляется при всплеске параллельных запросов и проходит через секунды или минуту; `rate_limit_exceeded` или `too_many_requests` | Поминутный лимит проекта: запросы (RPM), токены (TPM) или изображения в минуту (IPM) | Экспоненциальная задержка с джиттером, меньше параллельных запросов | Да, с растущей паузой |
| 429 держится часами, а на следующий день всё работает; `quota_exceeded` | Суточная квота запросов (RPD) | Ждать сброса в полночь по тихоокеанскому времени или запросить увеличение | Нет |
| 429 после серии дорогих запросов (Pro, 4K), хотя запросов в минуту немного | Лимит расходов за скользящие 10 минут: $10 на Tier 1 | Подождать, снизить долю дорогих запросов; при постоянных упорах запросить повышение | Да, но с паузой в минуты |
| 429 на первом же запросе, в тексте `free_tier` и `limit: 0` | Проект на бесплатном уровне вызывает модель изображений | Подключить оплату к этому проекту или взять ключ из платного проекта | Нет |
| Оплата подключена, трафика почти нет, а 429 не уходит | Ключ из другого проекта, у которого нет оплаты или квота уже израсходована | Сверить, к какому проекту привязан ключ, и проверить уровень этого проекта | Нет |

Рядом с 429 часто путают ещё два кода. HTTP 402 Payment Required — это закончившийся баланс предоплаты (Prepay): Google прямо пишет не повторять такой запрос, пока не пополнен счёт. HTTP 503 — перегрузка на стороне Google, а не ваш лимит; о ней отдельно — в разборе [ошибки 503 у Nano Banana Pro](https://blog.laozhang.ai/ru/posts/fix-gemini-3-pro-image-503-overloaded) и в материале про [ошибку Gemini High Demand](https://blog.laozhang.ai/ru/posts/gemini-high-demand-error). Повторять стоит только временные ошибки (429, 408, 5xx); 400, 402 и 403 повтор не исправит — об этом же говорит [руководство Google по устранению неполадок](https://ai.google.dev/gemini-api/docs/troubleshooting).

![Диагностика 429 по коду и условиям: когда повторить, ждать сброса или проверить оплату](https://blog.laozhang.ai/posts/ru/gemini-image-429-rate-limit/img/diagnostic-flowchart.webp)



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

Главное правило из [страницы лимитов Google](https://ai.google.dev/gemini-api/docs/rate-limits) (обновлена 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](https://blog.laozhang.ai/ru/posts/gemini-api-rate-limits-guide).

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

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

| Уровень | Лимит расходов за 10 минут | Pro 1K/2K ($0,1344) | Pro 4K ($0,24) | Nano Banana 2 1K ($0,0672) | Nano Banana 2 Lite 1K ($0,0336) |
|---|---|---|---|---|---|
| Free | нет | — | — | — | — |
| Tier 1 | $10 | 74 | 41 | 148 | 297 |
| Tier 2 | $50 | 372 | 208 | 744 | 1 488 |
| Tier 3 | $200 | 1 488 | 833 | 2 976 | 5 952 |

Цена изображения в заголовках столбцов — это выходные токены картинки, умноженные на ставку с [страницы цен Google](https://ai.google.dev/gemini-api/docs/pricing):

- 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](https://blog.laozhang.ai/ru/posts/gemini-image-api-guide-2026). Если оплата уже подключена, а ошибка с `free_tier_requests` всё равно идёт, разбирайте её по материалу [«free_tier_requests limit 0 на платном тарифе»](https://blog.laozhang.ai/ru/posts/paid-tier-getting-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: условия перехода

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

| Уровень | Условие | Потолок расходов уровня (billing tier cap) | Лимит расходов за 10 минут |
|---|---|---|---|
| Free | Активный проект или пробный период | — | — |
| Tier 1 | Привязан активный платёжный аккаунт | $250 | $10 |
| Tier 2 | Оплачено $100 и прошло 3 дня с первого успешного платежа | $2 000 | $50 |
| Tier 3 | Оплачено $1 000 и прошло 30 дней с первого успешного платежа | $20 000–100 000+ | $200 |

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

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

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

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

```python
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`, иначе попытки перемножатся:

```python
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 и восстановлении генерации](https://blog.laozhang.ai/ru/posts/resource-exhausted-error-nano-banana).

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

Если вы генерируете сотни изображений и результат не нужен сию минуту, повторы — не лучший инструмент. У [Batch API](https://ai.google.dev/gemini-api/docs/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](https://blog.laozhang.ai/ru/posts/nano-banana-pro-batch-api-cost-optimization). Для сравнения: сторонний шлюз laozhang.ai указывает $0,09 за вызов `gemini-3-pro-image` в 1K, 2K или 4K и $0,055 за `gemini-3.1-flash-image` (публичные цены на 24 сентября 2026 года); это отдельный договор со своими условиями, а изображения по-прежнему генерирует модель Google.

*Примечание: [laozhang.ai — наш собственный сервис](https://blog.laozhang.ai/ru/about#laozhang); его цены — наши тарифы, а не независимое сравнение.*

![Способы снизить 429: очередь, Batch, повышение уровня и официальный запрос лимита](https://blog.laozhang.ai/posts/ru/gemini-image-429-rate-limit/img/solution-comparison.webp)



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

В Vertex AI (в документации Google Cloud он теперь называется Gemini Enterprise Agent Platform) 429 на модели с оплатой по мере использования обычно означает, что запросу не хватило общей ёмкости, а не что вы исчерпали личную квоту; сообщение звучит как «Resource exhausted, please try again later». [Страница Google Cloud об ошибке 429](https://docs.cloud.google.com/gemini-enterprise-agent-platform/models/deploy/error-code-429) советует по возможности использовать глобальный эндпоинт вместо регионального, повторять с ограниченной экспоненциальной задержкой, сглаживать пики и наращивать трафик постепенно, для моделей с квотами — подать запрос на её увеличение, а для стабильной ёмкости — купить Provisioned Throughput. Уровни Tier 1–3 и лимит расходов из этой статьи относятся к Gemini Developer API, а не к Vertex AI.

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

Законных рычагов четыре: подождать (поминутный лимит и лимит расходов сбрасываются сами, суточная квота — в полночь по тихоокеанскому времени), снизить частоту и параллельность запросов, увести массовую генерацию в Batch и повысить уровень проекта или запросить увеличение лимита. Не помогают новые ключи в том же проекте, более агрессивные повторы и повторы ошибок 400, 402 и 403. Если наряду с 429 вы видите пустые ответы или блокировки, загляните в общий разбор [ошибок генерации изображений Gemini](https://blog.laozhang.ai/ru/posts/gemini-image-common-errors-fix).

### Что означает код 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](https://ai.google.dev/gemini-api/docs/available-regions) (список обновлён 28 апреля 2026 года). Что из сервисов Google с Nano Banana доступно и недоступно для России, разобрано в статье [«Nano Banana бесплатно: что даёт Google и что доступно из России»](https://blog.laozhang.ai/ru/posts/is-nano-banana-free).

## Источники

Внешние страницы, на которые ссылается это руководство, в порядке упоминания. Последнее обновление: 2026-10-05.

- [руководство Google по устранению неполадок](https://ai.google.dev/gemini-api/docs/troubleshooting) (ai.google.dev)
- [страницы лимитов Google](https://ai.google.dev/gemini-api/docs/rate-limits) (ai.google.dev)
- [страницы цен Google](https://ai.google.dev/gemini-api/docs/pricing) (ai.google.dev)
- [Batch API](https://ai.google.dev/gemini-api/docs/batch-api) (ai.google.dev)
- [Страница Google Cloud об ошибке 429](https://docs.cloud.google.com/gemini-enterprise-agent-platform/models/deploy/error-code-429) (docs.cloud.google.com)
- [список регионов Gemini API и Google AI Studio](https://ai.google.dev/gemini-api/docs/available-regions) (ai.google.dev)