Skip to main content
GET
cURL
Используйте этот endpoint после создания задачи видео Vidu. Он возвращает состояние задачи и включает video_url после завершения задачи.

Проверьте эти поля

  • status показывает, находится ли задача в состоянии queued, in_progress, completed, failed или error.
  • progress — это приблизительный процент выполнения.
  • video_url появляется в завершённых ответах.
  • error появляется, когда задача завершается с ошибкой.

Процесс опроса

1

Сначала создайте задачу

Начните с Создать видео Vidu и сохраните возвращённый id.
2

Выполняйте опрос по ID задачи

Отправляйте ID задачи в этот endpoint, пока status не достигнет completed, failed или error.
3

Скачайте файл MP4

Когда status равен completed, вызовите Получить содержимое видео Vidu.

Авторизации

Authorization
string
header
обязательно

Bearer authentication. Use your CometAPI API key.

Параметры пути

task_id
string
обязательно

Task ID returned by POST /v1/videos.

Ответ

Current Vidu video task state.

id
string
обязательно

Task ID. Use this value as task_id in retrieve and content requests.

Пример:

"task_example"

object
string
обязательно

Object type. Vidu video tasks return video.

Пример:

"video"

model
string
обязательно

Model ID used for the task.

Пример:

"viduq3-turbo"

status
enum<string>
обязательно

Task lifecycle status. Poll until the value is completed, failed, or error.

Доступные опции:
queued,
in_progress,
completed,
failed,
error
Пример:

"queued"

progress
integer
обязательно

Task progress as a coarse percentage.

Требуемый диапазон: 0 <= x <= 100
Пример:

0

created_at
integer
обязательно

Task creation time as a Unix timestamp in seconds.

Пример:

1779938152

task_id
string

Compatibility alias for id. The value matches id when present.

Пример:

"task_example"

completed_at
integer

Task completion time as a Unix timestamp in seconds. This field appears on completed tasks.

Пример:

1779938219

video_url
string

Temporary video delivery URL. This field appears on completed tasks.

Пример:

"<temporary-video-url>"

error
object

Failure details. This field appears when the task fails.