Створення відео Vidu

POST

videos

curl https://api.cometapi.com/v1/videos \
  -H "Authorization: Bearer $COMETAPI_KEY" \
  -F model=viduq3-turbo \
  -F 'prompt=An astronaut walks through soft blue fog with a slow cinematic camera move.' \
  -F seconds=1

{
  "id": "task_example",
  "task_id": "task_example",
  "object": "video",
  "model": "viduq3-turbo",
  "status": "queued",
  "progress": 0,
  "created_at": 1779938152
}

Використовуйте цей endpoint, щоб створити завдання для перетворення тексту або зображення на відео Vidu Q3. API негайно повертає ідентифікатор завдання, тому збережіть повернений id і перевіряйте стан завдання, доки воно не досягне кінцевого статусу. POST /v1/videos використовує multipart/form-data. Передавайте скалярні параметри як поля форми, а референсні зображення — як файлові поля input_reference.

Вибір режиму введення

Мета	Обов’язкові поля	Необов’язкові поля
Текст у відео	`model`, `prompt`	`seconds`, `size`
Зображення у відео	`model`, `prompt`, один файл `input_reference`	`seconds`, `size`

Щоб підтвердити ідентифікатор моделі Vidu, доступний для вашого ключа API, використайте Перелік доступних моделей.

Використання референсних зображень

Для перетворення зображення на відео завантажте одне референсне зображення через multipart-поле input_reference. Розмір файлу може становити до 20 МБ. Зображення визначає композицію та вигляд згенерованого відео. Використовуйте Prompt, щоб описати рух, поведінку камери та деталі, які відео має зберегти.

Налаштування тривалості та розміру

Ідентифікатор моделі	`seconds`	За замовчуванням
`viduq3-turbo`	ціле число `1`-`16`	`5` секунди, `1280x720`
`viduq3`	ціле число `1`-`16`	`5` секунди, `1280x720`

Установіть size одним зі значень WxH, наведених нижче.

Рівень роздільної здатності	Співвідношення сторін	`size` (`WxH`)
`540p`	`16:9`	`960x528`
`720p`	`16:9`	`1280x720`
`1080p`	`16:9`	`1920x1080`

Процес виконання завдання

Створення завдання

Надішліть multipart-запит і збережіть повернений id.

Перевірка стану завдання

Викличте Отримання відео Vidu доки status не матиме значення completed, failed або error.

Завантаження результату

Коли завдання має статус completed, викличте Отримання вмісту відео Vidu щоб завантажити файл MP4.

Авторизації

Authorization

string

header

обов'язково

Bearer authentication. Use your CometAPI API key.

Тіло

multipart/form-data

model

string

обов'язково

Vidu Q3 model ID for this route. Choose an available model from the Models page.

Приклад:

"viduq3-turbo"

prompt

string

обов'язково

Text prompt that describes the video to generate. For image-to-video, describe the motion and camera behavior that should animate the reference image.

Приклад:

"An astronaut walks through soft blue fog with a slow cinematic camera move."

seconds

string

Requested clip duration in seconds. Use an integer from 1 through 16. Default is 5.

Приклад:

"1"

size

string

Supported WxH size values: 960x528, 1280x720, 1920x1080. Default is 1280x720.

input_reference

file

One reference image file for image-to-video. Omit this field for text-to-video. The file can be up to 20 MB. The image guides the composition and appearance of the generated video.

Відповідь

Task created. Store the returned id and poll GET /v1/videos/{task_id}.

string

обов'язково

Task ID. Use this value with retrieve and content endpoints.

Приклад:

"task_example"

object

string

обов'язково

Object type. 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 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.

Останнє оновлення 12 серпня 2026 р.

curl https://api.cometapi.com/v1/videos \
  -H "Authorization: Bearer $COMETAPI_KEY" \
  -F model=viduq3-turbo \
  -F 'prompt=An astronaut walks through soft blue fog with a slow cinematic camera move.' \
  -F seconds=1

{
  "id": "task_example",
  "task_id": "task_example",
  "object": "video",
  "model": "viduq3-turbo",
  "status": "queued",
  "progress": 0,
  "created_at": 1779938152
}

Модерація контенту

API-ключі

Вибір режиму введення

Використання референсних зображень

Налаштування тривалості та розміру

Процес виконання завдання

Авторизації

Тіло

Відповідь

​Вибір режиму введення

​Використання референсних зображень

​Налаштування тривалості та розміру

​Процес виконання завдання

Авторизації

Тіло

Відповідь

Вибір режиму введення

Використання референсних зображень

Налаштування тривалості та розміру

Процес виконання завдання