Ошибки
Все HTTP-статусы и коды ошибок API Cheapest Imagen: что означает каждый, списываются ли кредиты и что делать дальше.
Ошибки имеют ту же форму, что и у OpenAI:
{
"error": {
"message": "Not enough credits for this request.",
"type": "invalid_request_error",
"param": null,
"code": "insufficient_credits"
}
}Каждый ответ содержит заголовок x-request-id. Указывайте его, когда пишете в поддержку.
| Статус | code | Значение | Что делать |
|---|---|---|---|
| 400 | missing_required_parameter | Не хватает обязательного поля | Добавьте поле, указанное в param |
| 400 | invalid_value | Значение поля не принимается | Исправьте поле, указанное в param |
| 400 | unsupported_parameter | Поле недоступно или недоступно для этой модели (например, svg для модели без вывода SVG) | Уберите поле или выберите модель, где оно есть |
| 400 | model_not_found | Модели нет или она не открыта | Используйте модель из GET /v1/models |
| 400 | moderation_blocked | Промпт или изображение отклонены проверкой контента | Измените промпт. Плата не берётся, кроме стабильных каналов Nano Banana (-1k, -2k, -4k) |
| 401 | invalid_api_key | Ключ отсутствует или неверен | Проверьте заголовок Authorization |
| 402 | insufficient_credits | Не хватает кредитов | Пополните баланс |
| 403 | account_suspended | Аккаунт или ключ отключены | Обратитесь в поддержку |
| 409 | idempotency_key_in_use | Idempotency-Key уже использован | Дождитесь первого запроса или используйте новый ключ |
| 413 | request_too_large | Запрос или изображение слишком велики | Отправьте изображения меньшего размера или меньше |
| 429 | rate_limit_exceeded | Больше 300 запросов в минуту | Снизьте темп и повторите |
| 429 | concurrency_limit_exceeded | Больше 50 запросов одновременно | Дождитесь завершения одного |
| 429 | moderation_paused | Больше 10 отклонённых запросов за час | Подождите час |
| 502 | upstream_error | Не удалось создать изображение | Повторите. Плата не берётся |
| 504 | upstream_timeout | Генерация заняла больше 420 секунд | Повторите. Плата не берётся |
Когда списываются кредиты
Только за изображения, которые вы получили. Неудавшиеся запросы, запросы с истёкшим временем и отклонённые запросы ничего не стоят. Исключение: стабильные каналы Nano Banana (-1k, -2k, -4k) берут плату за изображения, отклонённые из-за содержимого, потому что её берёт поставщик.
Лимиты запросов и массовая генерация
Лимиты запросов API Cheapest Imagen (300 в минуту, 50 одновременно), ошибка 429 и массовая генерация тысяч изображений с повторами, которые не оплачиваются дважды.
Переход с OpenAI
Перенесите код OpenAI Images API в Cheapest Imagen, сменив только базовый URL и API-ключ; поля запроса и ответа остаются прежними.