> ## Documentation Index
> Fetch the complete documentation index at: https://docs.laozhang.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Оплата запросов к API изображений: ошибки, модерация, таймауты

> Когда LaoZhang API списывает плату за запросы к Nano Banana, GPT Image и Grok Imagine: ошибки, модерация, HTTP 200 без изображения, таймауты, повторы и параллельность.

LaoZhang API тарифицирует модели изображений за вызов или за каждое возвращённое изображение. Списание зависит от того, дошёл ли запрос до генерации и что вернул апстрим, а не только от HTTP-статуса. Правила для всех трёх семейств собраны в одной таблице; последняя проверка — **10 октября 2026**.

| Параметр | Значение |
| - | - |
| Единица оплаты | Nano Banana — за вызов; GPT Image с официальной пересылкой — по токенам, модели `-vip` и web — за вызов; Grok Imagine — за каждое успешно возвращённое изображение |
| Лимит параллельных запросов платформы | Нет ни на аккаунт, ни на токен; `429` приходит из-за ёмкости апстрима или баланса, см. [Параллельность и 429](https://docs.laozhang.ai/ru/faq/api-concurrency.md) |
| Стоимость запроса | [Журнал вызовов](https://docs.laozhang.ai/en/faq/call-logs.md) в консоли фиксирует модель, статус, расход и сумму каждого запроса |
| Правила по моделям | [Оплата Nano Banana](https://docs.laozhang.ai/ru/api-capabilities/nano-banana-image.md), [GPT Image 2.5](https://docs.laozhang.ai/ru/api-capabilities/gpt-image-2-5.md), [Grok Imagine](https://docs.laozhang.ai/ru/api-capabilities/grok-imagine-image.md) |

## Списания в зависимости от результата запроса

| Результат запроса | Nano Banana | GPT Image с официальной пересылкой | GPT Image VIP / web | Grok Imagine |
| - | - | - | - | - |
| Неверные параметры (400) | Не доходит до генерации, плата не списывается | Не списывается | Не списывается | Изображение не тарифицируется |
| Ошибка аутентификации (401) | Не списывается | Не списывается | Не списывается | Изображение не тарифицируется |
| Лимит или нехватка ёмкости апстрима (429, 503) | Не списывается | Не списывается | Не списывается | Изображение не тарифицируется |
| Ошибка 5xx апстрима | Не списывается | Не списывается | Не списывается | Изображение не тарифицируется |
| Блокировка модерацией | Google возвращает HTTP 200 с текстовым отказом без изображения, **списывается один вызов** | Возвращается ошибка, не списывается | Возвращается ошибка, не списывается | Возвращается ошибка, изображение не тарифицируется |
| HTTP 200 без изображения | **Списывается один вызов** | Токены списываются только после возврата изображения | Плата за вызов списывается только после возврата изображения | Плата за каждое возвращённое изображение, поэтому 0 изображений — 0 |
| Таймаут или разрыв соединения на стороне клиента | Сервер может завершить запрос и списать плату | То же | То же | То же |
| Изображение вернулось, но не сохранено | Списывается | Списывается | Списывается | Списывается; возвращённые URL временные |
| Несколько изображений в одном запросе | По числу не поддерживается; одно изображение за вызов | Фактические токены | За вызов | `n` от 1 до 10, плата за каждое возвращённое изображение |

Для всех трёх семейств правило одно: ответы апстрима не со статусом 200 не тарифицируются. Решающее значение имеет журнал вызовов: если записи о запросе в нём нет, списания не было.

HTTP 200 без изображения у Nano Banana — единственный случай «нет изображения» среди трёх семейств, за который списывается плата: на блокировку модерацией Google отвечает коротким отказом, а не кодом ошибки, и LaoZhang API засчитывает апстрим-ответ HTTP 200 как один вызов. Типичные причины и способы избежать оплаты пустых ответов описаны в руководстве по [Nano Banana](https://docs.laozhang.ai/ru/api-capabilities/nano-banana-image.md).

## Таймауты и повторы

Таймаут клиента не означает сбой: изображение могло уже сгенерироваться и быть оплачено на сервере. В пакетных заданиях действуйте в таком порядке:

1. Записывайте время отправки, ID модели, параметры и ответ каждого запроса.
2. После таймаута или разрыва найдите запрос в [журнале вызовов](https://api.laozhang.ai/log) по времени и модели и проверьте его статус и стоимость.
3. Если журнал показывает успех, не отправляйте запрос повторно: используйте возвращённое изображение или попросите поддержку помочь его получить.
4. Повторяйте `429` и `5xx` с экспоненциальной задержкой; каждый повтор — новый запрос, и при успехе он оплачивается отдельно.
5. Не отправляйте повторно без изменений запрос Nano Banana, вернувший HTTP 200 без изображения. Сначала измените промпт или референсы: тот же контент обычно блокируется снова и каждый раз оплачивается.
6. Задавайте таймауты клиента так, как рекомендует материал [Таймауты запросов](https://docs.laozhang.ai/ru/faq/request-timeout.md): 360 секунд для запросов к изображениям, 600 секунд для 4K или множества референсных изображений. Если в руководстве по модели есть свой совет по таймауту, он приоритетнее.

## Параллельность и лимиты запросов

LaoZhang API не ограничивает параллельные запросы на аккаунт или токен, а разнесение трафика по токенам никакой лимит не повышает. Если при нагрузке приходит `429`:

* тело ошибки с `insufficient_user_quota` означает, что баланс слишком мал, поэтому сначала пополните его;
* любой другой `429` приходит из-за лимита скорости или ёмкости апстрим-модели: вдвое снизьте параллельность в локальной очереди и повышайте её постепенно;
* устойчивая ошибка `503` означает нехватку ёмкости апстрима, а не неверные параметры: подождите и повторите запрос.

Примеры очереди и семафора есть в материале [Параллельность и 429](https://docs.laozhang.ai/ru/faq/api-concurrency.md).

## Как оспорить списание

Отправьте в поддержку следующее, но никогда не присылайте полный API-ключ:

* email аккаунта;
* время запроса, ID модели и идентификатор запроса из журнала вызовов;
* статус ответа и текст ошибки с закрытыми секретами;
* желаемое решение.

Пишите на [hi@laozhang.ai](mailto:hi@laozhang.ai) или в Telegram [@laozhang\_cn](https://t.me/laozhang_cn). Возвраты и корректировки баланса регулирует раздел 6 [Условий](https://www.laozhang.ai/terms).

## Частые вопросы

### Всегда ли бесплатен неудачный запрос?

Ответы апстрима не со статусом 200 не тарифицируются: неверные параметры, ошибки аутентификации, лимиты запросов и ошибки 5xx апстрима. Исключение — блокировка модерацией у Nano Banana: Google возвращает HTTP 200 вместо кода ошибки, и такой запрос списывается один раз.

### Как не заплатить дважды в пакетном задании?

Присвойте каждому целевому изображению ID задания, после таймаута проверяйте журнал вызовов и повторяйте запрос, только если исходный не удался. Не позволяйте таймауту клиента запускать автоматическую повторную отправку. Grok Imagine может вернуть до 10 изображений в одном запросе и тарифицирует каждое возвращённое.

### Как узнать стоимость одного запроса?

Журнал вызовов фиксирует модель, группу, статус, расход и сумму каждого запроса. Для моделей с оплатой за вызов показана фиксированная сумма, для GPT Image с официальной пересылкой — входные и выходные токены с пересчитанной суммой, а для Nano Banana при включённом заземлении через Google Search — число поисков и их стоимость. Поля журнала объясняет материал [Как читать журнал вызовов](https://docs.laozhang.ai/en/faq/call-logs.md).

## Связанные материалы

* [Обзор Nano Banana API](https://docs.laozhang.ai/ru/api-capabilities/nano-banana-image.md): цены и правила оплаты пяти моделей
* [GPT Image 2.5 API](https://docs.laozhang.ai/ru/api-capabilities/gpt-image-2-5.md): оплата на маршрутах официальной пересылки, VIP и web
* [Grok Imagine API](https://docs.laozhang.ai/ru/api-capabilities/grok-imagine-image.md): оплата за изображение и обработка ошибок
* [Сравнение API изображений](https://docs.laozhang.ai/ru/api-capabilities/image-generation-guide.md): три семейства рядом
* [Таймауты запросов](https://docs.laozhang.ai/ru/faq/request-timeout.md): как отличить таймаут от лимита запросов


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.