Skip to main content
POST
Проверка статуса видео
Опрашивайте эндпоинт, пока status не станет completed, rejected или failed. Рекомендуемый интервал опроса — 5–10 секунд. Генерация обычно занимает несколько минут; длинные ролики в 1080p могут генерироваться дольше.

Статусы

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

Ответ: в процессе

Ответ: готово

Ответ: отклонено

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

Ошибки

Ошибки выполнения задачи возвращаются в ответе /v1/videos/fetch в полях error и message.

Сообщения BadRequest

Примеры

Проверка статуса

Python: создание и ожидание результата

Authorizations

Authorization
string
header
required

Заголовок Authorization: Bearer <ваш API-ключ>.

Body

application/json
model
enum<string>
required

Модель, использованная при генерации.

Available options:
wan-3,
wan-3-prime
Example:

"wan-3"

id
string
required

task_id, полученный при создании задачи.

Example:

"b22c9ae2-0b55-4398-88df-0191aae664f0"

output_format
enum<string>

Если передано base64, поле video_url будет содержать строку base64 вместо ссылки.

Available options:
base64

Response

200 - application/json

Статус задачи

task_id
string
required

Идентификатор задачи.

Example:

"b22c9ae2-0b55-4398-88df-0191aae664f0"

status
enum<string>
required

processing — задача выполняется; completed — видео готово; rejected — запрос не прошёл проверку или модерацию; failed — внутренняя ошибка генерации.

Available options:
processing,
completed,
rejected,
failed
video_url
string

URL готового видео или строка base64 при output_format: "base64". Доступно при completed.

Example:

"https://cdn.nixai.ru/videos/b22c9ae2.mp4"

error
enum<string>

Код ошибки при rejected или failed.

Available options:
BadRequest,
ContentRejected,
UnknownError
Example:

"BadRequest"

message
string

Описание ошибки при rejected или failed.

Example:

"Reference videos plus output duration must not exceed 30s."