创建 Vidu 视频 - CometAPI Documentation

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
}

使用此端点创建 Vidu Q3 文生视频或图生视频任务。API 会立即返回任务 ID，因此请保存返回的 id，并轮询任务，直到其达到终止状态。 POST /v1/videos 使用 multipart/form-data。将标量控制参数作为表单字段发送，并将参考图像作为 input_reference 文件字段传递。

选择输入模式

目标	必填字段	可选字段
文生视频	`model`, `prompt`	`seconds`, `size`
图生视频	`model`, `prompt`，一个 `input_reference` 文件	`seconds`, `size`

要确认 API 密钥可用的 Vidu 模型 ID，请使用列出可用模型.

使用参考图像

对于图生视频，请通过 input_reference 多部分表单字段上传一张参考图像。文件大小最多为 20 MB。图像会引导生成视频的构图和外观。使用 Prompt 描述动作、摄像机行为以及视频应保留的细节。

设置时长和尺寸

模型 ID	`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`

任务流程

创建任务

发送多部分表单请求，并保存返回的 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.

最后修改于 2026年8月12日

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
}

​选择输入模式

​使用参考图像

​设置时长和尺寸

​任务流程

授权

请求体

响应

选择输入模式

使用参考图像

设置时长和尺寸

任务流程