Списания в зависимости от результата запроса
Для всех трёх семейств правило одно: ответы апстрима не со статусом 200 не тарифицируются. Решающее значение имеет журнал вызовов: если записи о запросе в нём нет, списания не было.
HTTP 200 без изображения у Nano Banana — единственный случай «нет изображения» среди трёх семейств, за который списывается плата: на блокировку модерацией Google отвечает коротким отказом, а не кодом ошибки, и LaoZhang API засчитывает апстрим-ответ HTTP 200 как один вызов. Типичные причины и способы избежать оплаты пустых ответов описаны в руководстве по Nano Banana.
Таймауты и повторы
Таймаут клиента не означает сбой: изображение могло уже сгенерироваться и быть оплачено на сервере. В пакетных заданиях действуйте в таком порядке:- Записывайте время отправки, ID модели, параметры и ответ каждого запроса.
- После таймаута или разрыва найдите запрос в журнале вызовов по времени и модели и проверьте его статус и стоимость.
- Если журнал показывает успех, не отправляйте запрос повторно: используйте возвращённое изображение или попросите поддержку помочь его получить.
- Повторяйте
429и5xxс экспоненциальной задержкой; каждый повтор — новый запрос, и при успехе он оплачивается отдельно. - Не отправляйте повторно без изменений запрос Nano Banana, вернувший HTTP 200 без изображения. Сначала измените промпт или референсы: тот же контент обычно блокируется снова и каждый раз оплачивается.
- Задавайте таймауты клиента так, как рекомендует материал Таймауты запросов: 360 секунд для запросов к изображениям, 600 секунд для 4K или множества референсных изображений. Если в руководстве по модели есть свой совет по таймауту, он приоритетнее.
Параллельность и лимиты запросов
LaoZhang API не ограничивает параллельные запросы на аккаунт или токен, а разнесение трафика по токенам никакой лимит не повышает. Если при нагрузке приходит429:
- тело ошибки с
insufficient_user_quotaозначает, что баланс слишком мал, поэтому сначала пополните его; - любой другой
429приходит из-за лимита скорости или ёмкости апстрим-модели: вдвое снизьте параллельность в локальной очереди и повышайте её постепенно; - устойчивая ошибка
503означает нехватку ёмкости апстрима, а не неверные параметры: подождите и повторите запрос.
Как оспорить списание
Отправьте в поддержку следующее, но никогда не присылайте полный API-ключ:- email аккаунта;
- время запроса, ID модели и идентификатор запроса из журнала вызовов;
- статус ответа и текст ошибки с закрытыми секретами;
- желаемое решение.
Частые вопросы
Всегда ли бесплатен неудачный запрос?
Ответы апстрима не со статусом 200 не тарифицируются: неверные параметры, ошибки аутентификации, лимиты запросов и ошибки 5xx апстрима. Исключение — блокировка модерацией у Nano Banana: Google возвращает HTTP 200 вместо кода ошибки, и такой запрос списывается один раз.Как не заплатить дважды в пакетном задании?
Присвойте каждому целевому изображению ID задания, после таймаута проверяйте журнал вызовов и повторяйте запрос, только если исходный не удался. Не позволяйте таймауту клиента запускать автоматическую повторную отправку. Grok Imagine может вернуть до 10 изображений в одном запросе и тарифицирует каждое возвращённое.Как узнать стоимость одного запроса?
Журнал вызовов фиксирует модель, группу, статус, расход и сумму каждого запроса. Для моделей с оплатой за вызов показана фиксированная сумма, для GPT Image с официальной пересылкой — входные и выходные токены с пересчитанной суммой, а для Nano Banana при включённом заземлении через Google Search — число поисков и их стоимость. Поля журнала объясняет материал Как читать журнал вызовов.Связанные материалы
- Обзор Nano Banana API: цены и правила оплаты пяти моделей
- GPT Image 2.5 API: оплата на маршрутах официальной пересылки, VIP и web
- Grok Imagine API: оплата за изображение и обработка ошибок
- Сравнение API изображений: три семейства рядом
- Таймауты запросов: как отличить таймаут от лимита запросов