Документация APIДокументация API
Ошибки
Стабильная структура ошибок, коды и статусы HTTP
Ошибки возвращаются в фиксированной обёртке и никогда не содержат закрытой диагностики:
{
"success": false,
"error": {
"code": "INVALID_REQUEST",
"message": "The request is invalid.",
"request_id": "req_012345"
}
}| HTTP | Код | Значение |
|---|---|---|
| 400 | INVALID_REQUEST | некорректное тело, поле формы, заголовок или изображение |
| 400 | CONTENT_POLICY_VIOLATION | запрос не может быть обработан |
| 401 | UNAUTHORIZED | ключ API отсутствует или недействителен |
| 402 | INSUFFICIENT_CREDITS | доступного баланса недостаточно |
| 403 | FORBIDDEN | нет нужного права или бета-доступа |
| 404 | JOB_NOT_FOUND | задача отсутствует или принадлежит другому аккаунту |
| 409 | IDEMPOTENCY_CONFLICT | ключ переиспользован с другим содержимым |
| 409 | JOB_CANCELED | задача была отменена |
| 429 | RATE_LIMIT_EXCEEDED | превышен лимит запросов |
| 500 | JOB_FAILED | задачу с изображением не удалось выполнить |
| 500 | INTERNAL_ERROR | запрос не удалось выполнить |
Превышение размера загрузки возвращается как HTTP 413 с кодом
INVALID_REQUEST. Считайте 429 и незавершённые задачи пригодными для повтора с
указанной в документации задержкой. При остальных ошибках измените запрос или
обратитесь в поддержку, указав request_id; не разбирайте предназначенное для
человека сообщение в программной логике.