Tạo video 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
}

Sử dụng endpoint này để tạo tác vụ text-to-video hoặc image-to-video Vidu Q3. API ngay lập tức trả về ID tác vụ, vì vậy hãy lưu id được trả về và thăm dò tác vụ cho đến khi tác vụ đạt trạng thái kết thúc. POST /v1/videos sử dụng multipart/form-data. Gửi các tham số vô hướng dưới dạng trường biểu mẫu và tham chiếu hình ảnh dưới dạng trường tệp input_reference.

Chọn chế độ đầu vào

Mục tiêu	Các trường bắt buộc	Các trường tùy chọn
Text-to-video	`model`, `prompt`	`seconds`, `size`
Image-to-video	`model`, `prompt`, một tệp `input_reference`	`seconds`, `size`

Để xác nhận model ID Vidu khả dụng với API key của bạn, hãy sử dụng Liệt kê các model khả dụng.

Sử dụng hình ảnh tham chiếu

Đối với image-to-video, hãy tải lên một hình ảnh tham chiếu thông qua trường multipart input_reference. Tệp có thể có kích thước tối đa 20 MB. Hình ảnh định hướng bố cục và diện mạo của video được tạo. Sử dụng Prompt để mô tả chuyển động, hành vi của camera và các chi tiết mà video cần giữ lại.

Thiết lập thời lượng và kích thước

ID model	`seconds`	Mặc định
`viduq3-turbo`	số nguyên `1`-`16`	`5` giây, `1280x720`
`viduq3`	số nguyên `1`-`16`	`5` giây, `1280x720`

Đặt size thành một trong các giá trị WxH dưới đây.

Cấp độ độ phân giải	Tỷ lệ khung hình	`size` (`WxH`)
`540p`	`16:9`	`960x528`
`720p`	`16:9`	`1280x720`
`1080p`	`16:9`	`1920x1080`

Quy trình tác vụ

Tạo tác vụ

Gửi yêu cầu biểu mẫu multipart và lưu id được trả về.

Thăm dò tác vụ

Gọi Truy xuất video Vidu cho đến khi status là completed, failed hoặc error.

Tải xuống kết quả

Khi tác vụ ở trạng thái completed, hãy gọi Truy xuất nội dung video Vidu để tải xuống tệp MP4.

Ủy quyền

Authorization

string

header

bắt buộc

Bearer authentication. Use your CometAPI API key.

Nội dung

multipart/form-data

model

string

bắt buộc

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

Ví dụ:

"viduq3-turbo"

prompt

string

bắt buộc

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

Ví dụ:

"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.

Ví dụ:

"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.

Phản hồi

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

string

bắt buộc

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

Ví dụ:

"task_example"

object

string

bắt buộc

Object type. Video tasks return video.

Ví dụ:

"video"

model

string

bắt buộc

Model ID used for the task.

Ví dụ:

"viduq3-turbo"

status

enum<string>

bắt buộc

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

Tùy chọn có sẵn:

queued,

in_progress,

completed,

failed,

error

Ví dụ:

"queued"

progress

integer

bắt buộc

Task progress as a coarse percentage.

Phạm vi bắt buộc: 0 <= x <= 100

Ví dụ:

0

created_at

integer

bắt buộc

Task creation time as a Unix timestamp in seconds.

Ví dụ:

1779938152

task_id

string

Compatibility alias for id when present.

Ví dụ:

"task_example"

completed_at

integer

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

Ví dụ:

1779938219

video_url

string

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

Ví dụ:

"<temporary-video-url>"

error

object

Failure details. This field appears when the task fails.

Lần sửa đổi cuối 12 tháng 8, 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
}

Kiểm duyệt nội dung

Khóa API

Chọn chế độ đầu vào

Sử dụng hình ảnh tham chiếu

Thiết lập thời lượng và kích thước

Quy trình tác vụ

Ủy quyền

Nội dung

Phản hồi

​Chọn chế độ đầu vào

​Sử dụng hình ảnh tham chiếu

​Thiết lập thời lượng và kích thước

​Quy trình tác vụ

Ủy quyền

Nội dung

Phản hồi

Chọn chế độ đầu vào

Sử dụng hình ảnh tham chiếu

Thiết lập thời lượng và kích thước

Quy trình tác vụ