Vidu 视频生成

视频生成用户调用文档

更新时间：2026-06-03

本文按当前线上口径整理，适用于本站 Vidu Q3 Pro / Q3 Turbo 视频模型调用。用户只需要使用本站展示的稳定模型名和视频任务接口，不要直接依赖上游或内部路由字段。

1. 可用模型

模型	系列	文生视频	单图生视频	首尾帧	多参考图
viduq3p-540p	Q3 Pro	支持	支持	支持，使用 image + last_image	支持，使用 reference_image_urls，最多 4 张
viduq3p-720p	Q3 Pro	支持	支持	支持，使用 image + last_image	支持，使用 reference_image_urls，最多 4 张
viduq3p-1080p	Q3 Pro	支持	支持	支持，使用 image + last_image	支持，使用 reference_image_urls，最多 4 张
viduq3t-540p	Q3 Turbo	支持	支持	支持，使用 image + last_image	支持，使用 reference_image_urls，最多 4 张
viduq3t-720p	Q3 Turbo	支持	支持	支持，使用 image + last_image	支持，使用 reference_image_urls，最多 4 张
viduq3t-1080p	Q3 Turbo	支持	支持	支持，使用 image + last_image	支持，使用 reference_image_urls，最多 4 张

说明：

• 当前线上模型列表只包含上表 6 个模型。
• 创建任务时只使用上表展示的模型名。
• Q3 Turbo 当前只按文生或单图生使用；多参考图请使用 Q3 Pro。

2. 接口

2.1 创建视频任务

POST /v1/video/generations

请求头：

Authorization: Bearer sk-***
Content-Type: application/json

2.2 查询视频任务

GET /v1/video/generations/{task_id}

兼容查询接口：

GET /v1/videos/{task_id}

3. 参数说明

参数	类型	必填	说明
model	string	是	使用上表 6 个模型之一
prompt	string	是	视频生成提示词
duration	integer/string	是	输出视频秒数，当前建议传 1-16 的整数
aspect_ratio	string	文生建议传	输出画幅比例，常用 16:9、9:16、1:1
image	string	单图/首尾帧必填	公开可访问的图片 URL；单图生视频时只传这一张图
last_image	string	首尾帧必填	尾帧图片 URL；和 image 配合使用，保持旧版文档字段不变
reference_image_urls	string[]	多参考图必填	Q3 Pro 多参考图字段，最多 4 张公开可访问图片 URL
extra_body.audio	boolean	否	是否生成声音；不需要声音时传 false
extra_body.seed	integer	否	随机种子
extra_body.bgm	boolean	否	是否开启背景音乐；不需要时传 false

字段使用约束：

• 文生视频：只传 prompt、model、duration，可选 aspect_ratio。
• 单图生视频：传 image，不要同时传多图数组。
• 首尾帧：传 image + last_image，不要把首尾帧塞进 images 数组。
• 多参考图：传 reference_image_urls，不要同时传 images、image_urls 或重复传同一批图片。
• reference_image_urls 只推荐用于 viduq3p-*，不要用于 viduq3t-*。

4. 请求示例

以下示例中的 {BASE_URL} 可替换为 https://api.aijisu.cn。

4.1 文生视频

curl -X POST "{BASE_URL}/v1/video/generations" \
  -H "Authorization: Bearer sk-***" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "viduq3p-720p",
    "prompt": "电影感航拍镜头，日出时分掠过未来海滨城市，光线柔和，镜头缓慢推进。",
    "aspect_ratio": "16:9",
    "duration": 5,
    "extra_body": {
      "audio": false,
      "seed": 42,
      "bgm": false
    }
  }'

4.2 单图生视频

curl -X POST "{BASE_URL}/v1/video/generations" \
  -H "Authorization: Bearer sk-***" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "viduq3t-540p",
    "prompt": "人物缓慢抬头并看向镜头，动作自然，镜头轻微前推。",
    "image": "https://example.com/source.png",
    "duration": 5,
    "extra_body": {
      "seed": 42
    }
  }'

4.3 首尾帧生视频

curl -X POST "{BASE_URL}/v1/video/generations" \
  -H "Authorization: Bearer sk-***" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "viduq3p-720p",
    "prompt": "人物从正面自然转向侧面，身份保持稳定，动作连贯。",
    "image": "https://example.com/head.png",
    "last_image": "https://example.com/tail.png",
    "duration": 6,
    "extra_body": {
      "seed": 42
    }
  }'

4.4 多参考图生视频

curl -X POST "{BASE_URL}/v1/video/generations" \
  -H "Authorization: Bearer sk-***" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "viduq3p-720p",
    "prompt": "A @Image1 walking through a beach in the visual style of @Image2",
    "reference_image_urls": [
      "https://example.com/ref-1.png",
      "https://example.com/ref-2.png"
    ],
    "aspect_ratio": "16:9",
    "duration": 5,
    "extra_body": {
      "audio": false,
      "seed": 42,
      "bgm": false
    }
  }'

5. 响应示例

创建任务成功时：

{
  "id": "task_xxxxx",
  "task_id": "task_xxxxx",
  "object": "video.generation.job",
  "model": "viduq3p-720p",
  "status": "queued",
  "progress": 0,
  "created_at": 1774507626
}

查询任务完成时：

{
  "id": "task_xxxxx",
  "task_id": "task_xxxxx",
  "object": "video.generation.job",
  "model": "viduq3p-720p",
  "status": "completed",
  "progress": 100,
  "video_url": "https://example.com/output.mp4",
  "created_at": 1774507626
}

常见状态：

状态	含义
queued	排队中
in_progress	生成中
completed	已完成
failed	失败

6. 常见错误

6.1 把多张图放进 images

不要这样传：

{
  "model": "viduq3p-720p",
  "prompt": "首尾帧变化",
  "images": [
    "https://example.com/head.png",
    "https://example.com/tail.png"
  ],
  "duration": 6
}

当前线上口径下，多图 images 可能被路由为不匹配的 reference 分支。首尾帧请使用 image + last_image；多参考图请使用 reference_image_urls。

6.2 Q3 Turbo 使用多参考图

不要对 viduq3t-* 传 reference_image_urls。Q3 Turbo 当前只按文生或单图生使用。

6.3 使用未展示的模型名

创建任务时只使用本文模型表中的 6 个模型名。未在模型表中展示的模型名不要作为 model 参数传入。

7. 与旧版文档的主要区别

项目	旧版文档口径	当前口径
文生视频说明	prompt 字段描述为“只传 prompt 视为图生视频”	只传 prompt 应为文生视频
必填字段	OpenAPI schema 把 image、last_image、reference_image_urls、aspect_ratio、extra_body 等都列为必填	只有 model、prompt、duration 基础必填；图片字段按场景条件必填
首尾帧字段	使用 image + last_image	保持 image + last_image，旧用户不需要改字段名
首尾帧传图方式	未说明不要传 images	明确不要把首尾帧放进 images 数组；images 多图不是首尾帧写法
多参考图模型	旧版示例包含未在当前模型表展示的模型名	当前使用 viduq3p-* + reference_image_urls
多参考图数量	未说明上限	当前建议最多 4 张
Q3 Turbo 多参考图	未限制	当前 viduq3t-* 不用于多参考图
示例模型	旧版示例包含未在当前模型表展示的模型名	当前用户文档只保留 6 个线上可用模型
duration 类型	schema 写 string，示例传 number	当前建议传整数；兼容数字字符串
extra_body.bgm 类型	schema 写 string	当前按 boolean 使用
查询任务	旧文档只展示创建接口	当前补充 GET /v1/video/generations/{task_id} 和兼容 GET /v1/videos/{task_id}