Ошибки

#Формат ошибки

{
  "error": {
    "code": "invalid_request",
    "message": "Неверные параметры модели",
    "details": [
      {
        "code": "invalid_type",
        "expected": "string",
        "received": "undefined",
        "path": [
          "prompt"
        ],
        "message": "Required"
      },
      {
        "code": "invalid_enum_value",
        "options": [
          "1k",
          "2k",
          "4k"
        ],
        "path": [
          "resolution"
        ],
        "message": "Invalid enum value. Expected '1k' | '2k' | '4k', received '8k'"
      }
    ]
  }
}

code — машинный код, на него удобно ветвить логику. message — понятное человеку описание на русском. details — подробности, есть не у всех ошибок.

#Коды ошибок

400 invalid_request

Неверный запрос или параметры модели. В details — список проблем: поле (path) и описание. Исправьте запрос, повторять его в том же виде бесполезно.

401 unauthorized

Нет ключа, ключ неверный или отозван. Проверьте заголовок Authorization.

402 insufficient_balance

Не хватает денег на балансе. Пополните его в кабинете и повторите.

403 forbidden

Запрос запрещён ограничениями ключа: модель не разрешена, чужой IP-адрес или исчерпан месячный лимит расхода. Также — если аккаунт заблокирован.

404 not_found

Нет такой задачи, модели или метода. Проверьте ID и путь.

409 conflict

Запрос конфликтует с текущим состоянием. Обновите данные и повторите.

429 rate_limited

Слишком много запросов. Подождите и повторите с нарастающей паузой. Лимиты — в разделе Лимиты.

500 internal

Внутренняя ошибка сервера. Повторите через несколько секунд.

502 provider_error

Модель временно недоступна. Деньги не списаны — повторите позже.

503 unavailable

Сервис или функция временно недоступны. Повторите позже.

#Ошибки генерации

Если задача создана, но генерация не удалась, задача получает статус failed, а в поле error — причину:

{
  "id": "7e70388cf461f88d7149b1077e4ad098",
  "status": "failed",
  "error": {
    "code": "content_policy",
    "message": "Запрос не прошёл модерацию модели"
  },
  "price": {
    "amount": "3.360000",
    "currency": "RUB",
    "refunded": true
  }
}

Деньги за такую задачу возвращаются автоматически. Коды ошибок генерации:

content_policy

Промпт или изображение не прошли модерацию модели. Измените описание или входной файл.

invalid_input

Модель не приняла параметры или файл: например, ссылка на изображение недоступна без авторизации или формат не подходит.

generation_failed

Модель не вернула результат. Обычно помогает повтор.

provider_error

Временный сбой у модели. Повторите позже.

timeout

Модель не уложилась в отведённое время. Повторите позже или выберите меньшую длительность.

Если ошибка непонятна или повторяется, напишите в поддержку в Telegram и приложите ID задачи.