cURL
请先获取 API Key 并配置为环境变量。
模型概览
| 模型名 | 说明 |
|---|---|
vidu/viduq3-pro-fast_img2video | q3 旗舰极速版,最高 1080P,最长 16 秒 |
vidu/viduq3-pro_img2video | q3 旗舰版,最高 1080P,最长 16 秒 |
vidu/viduq3-turbo_img2video | q3 快速版,最高 1080P,最长 16 秒 |
vidu/viduq2-pro-fast_img2video | q2 旗舰极速版,最高 1080P,最长 10 秒 |
vidu/viduq2-pro_img2video | q2 旗舰版,最高 1080P,最长 10 秒 |
vidu/viduq2-turbo_img2video | q2 快速版,最高 1080P,最长 10 秒 |
输入限制
首帧图像要求
| 限制项 | 要求 |
|---|---|
| 格式 | JPG、JPEG、PNG、WEBP |
| 宽高比 | 1:4 到 4:1 |
| 文件大小 | 不超过 50 MB |
| URL 类型 | HTTP/HTTPS 公网可访问地址 |
| 数量 | 必须且仅能传入 1 张图片 |
- 支持中英文,最长 5000 字符,超出部分会自动截断。
- 编写方法请参见 Vidu 视频生成 Prompt 指南。
| 模型 | 支持分辨率 | 支持时长 |
|---|---|---|
vidu/viduq3-pro-fast_img2video | 720P、1080P | 1–16 秒 |
vidu/viduq3-pro_img2video | 540P、720P、1080P | 1–16 秒 |
vidu/viduq3-turbo_img2video | 540P、720P、1080P | 1–16 秒 |
vidu/viduq2-pro-fast_img2video | 720P、1080P | 1–10 秒 |
vidu/viduq2-pro_img2video | 540P、720P、1080P | 1–10 秒 |
vidu/viduq2-turbo_img2video | 540P、720P、1080P | 1–10 秒 |
背景音效
parameters.audio 参数仅 q3 模型(viduq3-pro、viduq3-pro-fast、viduq3-turbo)支持。设为 true 后,模型将根据视频内容自动生成 AI 背景音效。
其他参数
| 参数 | 说明 |
|---|---|
parameters.watermark | 是否添加水印,默认 false。水印位于视频右下角,文案固定为“内容由AI生成”。 |
parameters.seed | 随机数种子,取值 [0, 2147483647],未指定时自动生成。固定 seed 可提升可复现性,但生成具有概率性,不能保证结果完全一致。 |
parameters.duration、parameters.resolution | 直接影响费用,按秒与分辨率档位计费。 |
使用流程
- 调用本接口提交图生视频任务,获取
task_id。task_id有效期为 24 小时,请勿重复创建任务。 - 调用查询结果接口,建议每 15 秒轮询一次,直到获取生成的视频 URL。
错误码
大模型服务通用状态码请查阅错误信息。
- Python SDK
鉴权
string
header
必填
千问AI平台 API Key。详见获取 API Key。
Header 参数
enum<string>
必填
固定值 enable,启用异步模式。
enable
请求体
application/jsonenum<string>
必填
模型名称。可选值:
| 模型 | 最高分辨率 | 最长时长 |
|-------|---------------|-------------|
| vidu/viduq3-pro-fast_img2video | 1080P | 16 秒 |
| vidu/viduq3-pro_img2video | 1080P | 16 秒 |
| vidu/viduq3-turbo_img2video | 1080P | 16 秒 |
| vidu/viduq2-pro-fast_img2video | 1080P | 10 秒 |
| vidu/viduq2-pro_img2video | 1080P | 10 秒 |
| vidu/viduq2-turbo_img2video | 1080P | 10 秒 |
vidu/viduq3-pro-fast_img2video,vidu/viduq3-pro_img2video,vidu/viduq3-turbo_img2video,vidu/viduq2-pro-fast_img2video,vidu/viduq2-pro_img2video,vidu/viduq2-turbo_img2video
object
必填
object