功能与模型
官方当前首尾帧型号为 viduq3-turbo、viduq3-pro、viduq2-pro-fast、viduq2-pro、viduq2-turbo、viduq1、viduq1-classic 和 vidu2.0。下表只列当前插件离线核验的安全组合；新增型号需先确认当前 Key 的 GET /v1/models 结果。
| 当前插件已核验组合 | 模型 | 秒数 | 分辨率 |
|---|---|---|---|
| 首尾帧 | viduq1 | 5 | 1080p |
| 首尾帧 | vidu2.0 | 4 | 360p / 720p / 1080p |
| 首尾帧 | vidu2.0 | 8 | 720p |
官方型号（2026-10-02）：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 填 first_tail_to_video。
| 参数 | 类型 | 说明 |
|---|---|---|
model | string | 必填。当前插件离线核验为 viduq1、vidu2.0；官方首尾帧页面还列出 viduq3-turbo、viduq3-pro、viduq2-pro-fast、viduq2-pro、viduq2-turbo、viduq1-classic。新增型号需先由 GET /v1/models 确认开放。基础 viduq2 不等同于官方 Q2 Pro/Turbo 型号。 |
images | string[] | 必填，顶层数组，恰好 2 张；第一张为首帧，第二张为尾帧，顺序不可颠倒。 |
prompt | string | 选填，最多 5000 字符。描述从首帧到尾帧的运动过程。 |
metadata.is_rec | boolean | 选填，放入 metadata。true 使用官方推荐提示词并忽略手写 prompt，会增加上游用量；默认示例不启用。 |
seconds | integer | 选填；本站优先使用 seconds（单位：秒），不要同时设置 duration。模型组合见本页表格。 |
metadata.seed | integer | 选填，放入 metadata。整数随机种子；省略时由上游随机生成，不保证跨任务像素级一致。 |
resolution | string | 选填。显式使用本页允许的档位；不表示画面比例。 |
metadata.movement_amplitude | string | 选填，放入 metadata。auto（默认）、small、medium、large；viduq2 不生效。 |
metadata.bgm | boolean | 选填，放入 metadata，默认 false。true 为视频添加背景音乐；viduq2 的 9/10 秒任务不生效。不是独立音频生成。 |
metadata.audio | boolean | 本页不使用。官方首尾帧页将 audio 限定为 Q3，不能套用图生接口的音视频参数。 |
metadata.payload | string | 选填，放入 metadata。业务透传字符串，最多 1048576 字符；统一视频结果不会承诺回显，关联任务请自行保存返回 ID。 |
metadata.off_peak | boolean | 选填，放入 metadata，默认 false。初次接入建议保持 false；当前文档不提供取消任务入口，不承诺官方直连的退款规则适用于本站。 |
metadata.callback_url | string | 选填，上游回调地址，放入 metadata。不能用本站 API Key 验证厂商回调签名；建议先采用查询接口。详见状态码、错误与回调。 |
images 必须恰好两张，第一张是首帧、第二张是尾帧。两张图片的宽高比应接近：首图宽高比除以尾图宽高比需在 0.8–1.25 之间。图片支持 PNG、JPEG/JPG、WebP、公开 URL 或带 MIME 的 data URL；每张不超过 50MB，请求体不超过 20MB。
代码示例
点击标签切换 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/startend2video-1.jpeg",
"https://prod-ss-images.s3.cn-northwest-1.amazonaws.com.cn/vidu-maas/template/startend2video-2.jpeg"
],
"seconds": 5,
"resolution": "1080p",
"metadata": {
"action": "first_tail_to_video"
}
}'示例使用当前插件已核验的 viduq1、5 秒、1080p 组合。若使用 Q3/Q2 Pro，请按官方页面分别核对时长、分辨率和音频条件，不要把图生的字段表直接复制过来。
如果两张图是主体外观参考而不是首尾画面，应改用 reference_to_video，见非主体参考。
查询与下载
创建成功后保存返回的 id，按查询任务与下载视频查询。只有 status=completed 才下载；创建请求返回成功不等于视频已经生成。
官方首尾帧页面的 audio 属于 Q3 条件能力，本页示例不启用；metadata.bgm 仍表示视频背景音乐，而不是独立音频。
参考：官方首尾帧。