Vidu图生视频API
更新时间 2026-10-10 18:30:13
最近更新时间: 2026-10-10 18:30:13
本文介绍Vidu Q3系列图生视频调用API。
模型简介
Q3 系列为 Vidu 新一代图生视频模型，支持音视频直出能力，可由单张输入图片作为首帧生成动态视频，可同步输出人声 + 背景音效；视频时长支持 1‑16 秒，最高支持 1080p 分辨率。
支持的模型
| 模型 | 模型说明 |
|---|---|
| viduq3‑pro | 效果最优，画面生动立体细节表现力强；Q3 系列默认开启音视频直出。 |
| viduq3‑turbo | 相比 viduq3‑pro 生成速度更快，效果保持高水准。 |
| viduq3‑pro‑fast | 高性价比，生成速度快，兼顾视频画质与产出效率。 |
调用流程
接口采用异步任务模式，分两步执行：
step1：调用创建任务接口，成功返回task_id
step2：调用查询任务接口查询对应task_id，直到state值为success，获取生成视频url
创建任务接口详情
http调用
请求方式：POST
请求路径：https://ai.ctaigw.cn/v1/img2video
请求头
| 参数 | 必填 | 说明 |
|---|---|---|
| Content‑Type | 是 | 固定application/json |
| Authorization | 是 | Token ${YOUR_APP_KEY} |
请求参数
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
| model | string | 是 | 模型调用名称或模型 ID |
| images | array | 是 | 首帧图像 模型将以此参数中传入的图片为首帧画面来生成视频。 注1：支持传入图片 Base64 编码或图片URL（确保可访问）； 注2：只支持输入 1 张图； 注3：图片支持 png、jpeg、jpg、webp格式； 注4：图片比例需要小于 1:4 或者 4:1 ； 注5：图片大小不超过 50 MB； 注6：请注意，http请求的post body不超过20MB，且编码必须包含适当的内容类型字符串，示例 data:image/png;base64,{base64_encode} |
| prompt | string | 否 | 视频生成提示词 |
| duration | integer | 否 | 视频时长，Q3 取值 1‑16，默认 5 秒 |
| seed | integer | 否 | 随机种子； 不传 / 传 0 使用随机种子，指定值可复现生成效果 |
| resolution | string | 否 | 分辨率 - viduq3‑pro‑fast：默认 720p，取值范围为720p、1080p - viduq3‑pro /viduq3‑turbo：默认 720p，取值范围为540p、720p、1080p |
| audio | bool | 否 | 是否使用音视频直出能力，默认为true，枚举值为： - false：不需要音视频直出，输出静音视频 - true：需要音画同步，输出声音的视频（包括台词和音效） |
| payload | string | 否 | 透传参数 不做任何处理，仅数据传输 注：最多 1048576个字符 |
| watermark | bool | 否 | 是否添加水印； true 添加，false 不添加；默认 false |
| wm_position | integer | 否 | 水印位置；默认 3 取值范围：1 左上、2 右上、3 右下、4 左下； |
| wm_url | string | 否 | 自定义水印图片 URL； 不传使用平台默认水印 |
| meta_data | string | 否 | JSON 字符串格式元数据透传，业务自定义标签 |
响应参数
| 参数 | 类型 | 描述 |
|---|---|---|
| task_id | string | 任务唯一 ID，用于轮询查询任务结果 |
| state | string | 处理状态 取值范围： created 创建成功 queueing 任务排队中 processing 任务处理中 success 任务成功 failed 任务失败 |
| model | string | 调用模型名称 |
| prompt | string | 请求传入提示词 |
| images | array | 请求传入首帧图片 |
| duration | integer | 视频时长 |
| seed | integer | 随机种子 |
| resolution | string | 输出分辨率 |
| payload | string | 透传参数 |
| watermark | bool | 是否开启水印 |
| created_at | string | 任务创建 UTC 时间 |
请求/响应示例
请求
curl -X POST https://ai.ctaigw.cn/v1/img2video\
-H "Authorization: Token {YOUR_APP_KEY}" \
-H "Content-Type: application/json" \
-d '{
"model": "viduq3-pro",
"images": ["https://aaaa.ctyun.cn/demo.jpg"],
"prompt": "A girl walks slowly, the camera slowly pans to the side",
"audio": true,
"duration": 5,
"seed": 0,
"resolution": "1080p"
}' 响应
{
"task_id": "q3-silent-task-xxxxxx",
"state": "created",
"model": "viduq3-pro",
"images": ["https://aaaa.ctyun.cn/demo.jpg"],
"prompt": "A girl walks slowly, the camera slowly pans to the side",
"duration": 8,
"audio": false,
"audio_type": null,
"seed": 876543,
"resolution": "720p",
"payload": "",
"watermark": false,
"created_at": "2026-09-06T02:15:10.654321Z"
}
