功能与模型
官方当前图生型号包括 viduq3-pro-fast、viduq3-turbo、viduq3-pro、viduq2-pro-fast、viduq2-pro、viduq2-turbo、viduq1、viduq1-classic 和 vidu2.0。下表只列当前插件离线核验的安全组合；新增型号必须先通过 GET /v1/models 和分组权限检查。
| 当前插件已核验组合 | 模型 | 秒数 | 分辨率 |
|---|---|---|---|
| 图生视频 | viduq1 | 5 | 1080p |
| 图生视频 | vidu2.0 | 4 | 360p / 720p / 1080p |
| 图生视频 | vidu2.0 | 8 | 720p |
官方型号（2026-10-02）：viduq3-pro-fast、viduq3-turbo、viduq3-pro、viduq2-pro-fast、viduq2-pro、viduq2-turbo、viduq1、viduq1-classic、vidu2.0。这是 Vidu 官方动作页面的型号清单；青云TOP 当前 pricing 快照未匹配到 Vidu，且本地插件离线核验范围仍为旧型号。提交前请用当前 API Key 调用GET /v1/models，只有返回该型号且分组开放时才可使用；不能只替换model字符串。
1. 设置鉴权
所有本站请求使用基础地址 https://top.qingyuntop.ai。请求头为 Authorization: Bearer YOUR_API_KEY，将 YOUR_API_KEY 替换为青云TOP API 的 API Key，保留 Bearer 后的一个空格。无需额外登录接口，也不需要 Vidu 厂商 Token。
2. 调用模型生成
POST https://top.qingyuntop.ai/v1/videos，Content-Type: application/json。metadata.action 填 image_to_video。
| 参数 | 类型 | 说明 |
|---|---|---|
model | string | 必填。当前插件离线核验为 viduq1、vidu2.0；官方图生页面还列出 viduq3-pro-fast、viduq3-turbo、viduq3-pro、viduq2-pro-fast、viduq2-pro、viduq2-turbo、viduq1-classic。新增型号需先由 GET /v1/models 确认开放。基础 viduq2 不等同于官方图生的 Q2 Pro/Turbo 型号。 |
images | string[] | 必填，顶层数组，恰好 1 张首帧图片。使用可公开下载的 URL 或带 MIME 前缀的 data URL。 |
prompt | string | 选填，最多 5000 字符；建议说明画面内动作和镜头变化。 |
metadata.voice_id | string | 选填，放入 metadata。需 audio=true 且使用上游有效音色 ID；本目录不提供音色列表或克隆接口。 |
metadata.is_rec | boolean | 选填，放入 metadata。true 使用官方推荐提示词并忽略手写 prompt，会增加上游用量；默认示例不启用。 |
metadata.bgm | boolean | 选填，放入 metadata，默认 false。true 为视频添加背景音乐；viduq2 的 9/10 秒任务不生效。不是独立音频生成。 |
metadata.audio | boolean | 选填，放入 metadata，官方图生页默认 false。true 请求带对白/音效的视频；启用前请确认所选模型的音视频能力，不能套用到文生或首尾帧，也不输出独立音频。 |
metadata.audio_type | string | 音频类型，放入 metadata；官方说明默认 all，并区分音效加人声、仅人声、仅音效。正文枚举存在大小写和连字符混用，接入前需确认上游当前取值，基础示例不启用。 |
seconds | integer | 选填；本站优先使用 seconds（单位：秒），不要同时设置 duration。模型组合见本页表格。 |
metadata.seed | integer | 选填，放入 metadata。整数随机种子；省略时由上游随机生成，不保证跨任务像素级一致。 |
resolution | string | 选填。显式使用本页允许的档位；不表示画面比例。 |
metadata.movement_amplitude | string | 选填，放入 metadata。auto（默认）、small、medium、large；viduq2 不生效。 |
metadata.payload | string | 选填，放入 metadata。业务透传字符串，最多 1048576 字符；统一视频结果不会承诺回显，关联任务请自行保存返回 ID。 |
metadata.off_peak | boolean | 选填，放入 metadata，默认 false。初次接入建议保持 false；当前文档不提供取消任务入口，不承诺官方直连的退款规则适用于本站。 |
metadata.callback_url | string | 选填，上游回调地址，放入 metadata。不能用本站 API Key 验证厂商回调签名；建议先采用查询接口。详见状态码、错误与回调。 |
输入恰好 1 张 PNG、JPEG/JPG 或 WebP 图片。图片应至少为 128×128，宽高比保持在约 1:4 到 4:1 之间；每张图片不超过 50MB，JSON 请求体不超过 20MB；data URL 必须带 MIME 前缀。本站 multipart 上传另有 15MiB 限制，见上传本地图片。
代码示例
点击标签切换 cURL、Python 或 Node.js。cURL 为 Bash 写法；Python 需安装 requests；Node.js 使用 18 或更新版本（含导入语句时保存为 .mjs）。图片示例使用 Vidu 官方示例素材，也可换成你自己的公开可访问图片 URL。
curl --fail-with-body "https://top.qingyuntop.ai/v1/videos" \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "viduq1",
"prompt": "宇航员缓缓挥手，镜头平稳上移。",
"images": [
"https://prod-ss-images.s3.cn-northwest-1.amazonaws.com.cn/vidu-maas/template/image2video.png"
],
"seconds": 5,
"resolution": "1080p",
"metadata": {
"action": "image_to_video"
}
}'示例使用当前插件已核验的 viduq1、5 秒、1080p 组合。is_rec=true 会让上游生成推荐提示词并可能增加用量；它与手写 prompt 的优先级依官方动作处理，示例未启用。
本地文件不能直接写进 images 字符串，请使用上传本地图片。
查询与下载
创建成功后保存返回的 id，按查询任务与下载视频查询。只有 status=completed 才下载；创建请求返回成功不等于视频已经生成。
图生官方页面还描述了条件性的 audio、audio_type 和 voice_id。这些字段只影响视频中的声音，必须按具体模型确认，不能当作独立音频生成，也不能把图生规则套到文生或首尾帧。
参考：官方图生视频。