cURL
请先获取 API Key 并配置为环境变量。
模型概览
| 模型名 | 说明 |
|---|---|
vidu/viduq3-pro_img2video | q3 旗舰版,最高 1080P,最长 16 秒 |
vidu/viduq3-turbo_img2video | q3 快速版,最高 1080P,最长 16 秒 |
vidu/viduq2-pro_img2video | q2 旗舰版,最高 1080P,最长 10 秒 |
vidu/viduq2-turbo_img2video | q2 快速版,最高 1080P,最长 10 秒 |
输入限制
首帧图像要求
| 限制项 | 要求 |
|---|---|
| 格式 | JPG、PNG、WEBP |
| 宽高比 | 1:4 到 4:1 |
| 文件大小 | 不超过 50 MB |
| URL 类型 | HTTP/HTTPS 公网可访问地址 |
| 数量 | 必须且仅能传入 1 张图片 |
| 模型 | 支持分辨率 | 支持时长 |
|---|---|---|
vidu/viduq3-pro_img2video | 540P、720P、1080P | 1–16 秒 |
vidu/viduq3-turbo_img2video | 540P、720P、1080P | 1–16 秒 |
vidu/viduq2-pro_img2video | 720P、1080P | 1–10 秒 |
vidu/viduq2-turbo_img2video | 720P、1080P | 1–10 秒 |
背景音效
parameters.audio 参数仅 q3 模型(viduq3-pro、viduq3-turbo)支持。设为 true 后,模型将根据视频内容自动生成 AI 背景音效。
使用流程
- 调用本接口提交图生视频任务,获取
task_id。 - 调用查询图生视频任务结果(基于首帧)接口,使用
task_id轮询任务状态,直到获取生成的视频 URL。
错误码
大模型服务通用状态码请查阅错误信息。鉴权
string
header
必填
千问云 API Key。详见获取 API Key。
Header 参数
enum<string>
必填
固定值 enable,启用异步模式。
enable
请求体
application/jsonenum<string>
必填
模型名称。可选值:
vidu/viduq3-pro_img2video:q3 旗舰版,最高 1080P,最长 16 秒vidu/viduq3-turbo_img2video:q3 快速版,最高 1080P,最长 16 秒vidu/viduq2-pro_img2video:q2 旗舰版,最高 1080P,最长 10 秒vidu/viduq2-turbo_img2video:q2 快速版,最高 1080P,最长 10 秒
vidu/viduq3-pro_img2video,vidu/viduq3-turbo_img2video,vidu/viduq2-pro_img2video,vidu/viduq2-turbo_img2video
object
必填
object

