Ошибки и ограничения
Каждая ошибка использует один конверт. Код стабилен; сообщение — это англоязычный запасной вариант, который вы можете показать пользователю.
{
"error": {
"code": "insufficient_credits",
"message": "You need more credits to generate."
}
}Статусы
| HTTP | Типичный код | Что делать |
|---|---|---|
| 400 | invalid_request, prompt_too_long, invalid_reference_image | Исправьте запрос; не повторяйте попытку без изменений |
| 401 | unauthorized | Проверь ключ; не повторяй попытки в цикле |
| 402 | insufficient_credits | Пополните кредиты; не повторяйте попытку |
| 403 | unauthorized | Создание ключа без оплаты или запрос аудио без премиум-подписки |
| 404 | not_found | Неизвестное задание или оно принадлежит не этому аккаунту |
| 409 | invalid_request | Idempotency-Key конфликт; используйте новый ключ |
| 413 / 415 | invalid_request / unsupported_image_type | Загрузите JPEG, PNG или WebP меньшего размера |
| 429 | rate_limited | Дождитесь Retry-After |
| 500 / 503 | internal | Повторить с задержкой |
400
- Типичный код
invalid_request,prompt_too_long,invalid_reference_image- Что делать
- Исправьте запрос; не повторяйте попытку без изменений
401
- Типичный код
unauthorized- Что делать
- Проверь ключ; не повторяй попытки в цикле
402
- Типичный код
insufficient_credits- Что делать
- Пополните кредиты; не повторяйте попытку
403
- Типичный код
unauthorized- Что делать
- Создание ключа без оплаты или запрос аудио без премиум-подписки
404
- Типичный код
not_found- Что делать
- Неизвестное задание или оно принадлежит не этому аккаунту
409
- Типичный код
invalid_request- Что делать
Idempotency-Keyконфликт; используйте новый ключ
413 / 415
- Типичный код
invalid_request/unsupported_image_type- Что делать
- Загрузите JPEG, PNG или WebP меньшего размера
429
- Типичный код
rate_limited- Что делать
- Дождитесь
Retry-After
500 / 503
- Типичный код
internal- Что делать
- Повторить с задержкой
Неудачная генерация — это ответ задания с кодом 200, содержащий status: "failed" и объект error с кодом internal. Завершённое задание окончательно: не отправляйте его повторно.
Политика повторных попыток
- Повторяйте только ответы HTTP
429,timeoutиinternal. - Никогда не повторяйте попытку при
insufficient_creditsи никогда не отправляйте повторно задание, которое уже завершилось со статусомfailed. - Используйте
Idempotency-Keyпри создании, чтобы повторная попытка не привела к двойному списанию. - Экспоненциально увеличивайте задержку с джиттером, начиная примерно с одной секунды.
Лимиты запросов
Лимиты действуют для каждого ключа в фиксированных одноминутных окнах, если не указано иное. Значения по умолчанию:
- 60 запросов/минуту в целом.
- 10 генераций в минуту.
- 5 загрузок/минуту.
- 120 запросов
GET /v1/modelsв минуту на IP-адрес клиента (маршрут публичный). - 5 созданий API-ключей в час на аккаунт.
429 содержит X-RateLimit-Limit, X-RateLimit-Remaining, X-RateLimit-Reset и Retry-After.
Доступность
Если /v1 временно недоступен, каждый маршрут отвечает 503 с кодом internal. Повторите попытку позже с экспоненциальной задержкой.