Ошибки

Как читать ошибку

HTTP-статус описывает сам запрос к API, а error.code — причину сбоя. Это разные поля: HTTP 200 не является бизнес-кодом ошибки.

• Отклонённая отправка возвращает HTTP-статус ошибки вместе с объектом error.
• Успешный запрос состояния задачи возвращает HTTP 200. По полю status определяйте, находится ли генерация в состоянии processing, completed или failed.
• Для неуспешной задачи ветвитесь по error.code, а не по тексту в message. Разным причинам сбоя соответствуют разные коды; одна и та же причина использует один и тот же код во всех моделях.
• 60002 используется как запасной вариант, когда более конкретную публичную причину определить нельзя. Незнакомые коды, которые появятся в будущем, обрабатывайте как общий сбой.

Коды и сообщения в таблице ниже API возвращает дословно, поэтому они остаются на английском: они посимвольно совпадают с error.message, который реально получает ваш клиент.

Request errors

These HTTP statuses describe a rejected or unconfirmed submission, or a failed task query. A submission timeout does not prove that no task was created.

Task failures

A successful task query returns HTTP 200 even when generation failed. Check status: "failed" and error.code in the response. These codes describe the task outcome, not the HTTP request. Failed tasks are not charged.

{
  "id": "task_...",
  "status": "failed",
  "error": {
    "code": 60002,
    "message": "Generation could not be completed. Please try again."
  }
}

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