功能与限制

仅支持 input_reference 这个文件字段，且每次只能上传 1 个文件。示例使用当前插件离线核验的 viduq1、5 秒、1080p；官方图生页面还列出 Q3 Fast、Q3、Q2 Pro/Turbo 和 Q1 Classic，新增型号必须先确认当前 Key 的 GET /v1/models 结果。

文件上限为 15MiB（15728640 字节），支持 PNG、JPEG/JPG、WebP。上传文件会编码为 data URL，体积约增加三分之一，官方请求体还有 20MB 限制，接近上限时使用图片 URL 更稳妥。

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。使用表单字段 model、prompt、seconds；metadata 必须是 JSON 对象字符串，例如 {"action":"image_to_video","resolution":"1080p"}。布尔值也应在这个 JSON 中按布尔类型填写。

将图片保存为 first-frame.png，或修改示例中的文件路径。不要手写 Content-Type: application/json，也不要手动指定 multipart boundary，客户端会自动生成。

点击标签切换 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" \
  -F 'model=viduq1' \
  -F 'prompt=人物缓缓转头，保持自然光线。' \
  -F 'seconds=5' \
  -F 'metadata={"action":"image_to_video","resolution":"1080p"}' \
  -F "input_reference=@first-frame.png"

多图与重复字段

上传文件会替换顶层 images，而不是与已有图片合并。不要同时上传文件和填写 images；也不要重复提交同一个表单字段。metadata 不能是数组、空字符串或无效 JSON。

首尾帧和多图参考请使用 JSON 的图片 URL 数组：首尾帧、参考生视频。表单里的 images='["..."]' 不会自动解析成数组。Responses 接口也不接受这种 multipart 文件上传。

查询与下载

创建成功后保存返回的 id，按查询任务与下载视频查询。只有 status=completed 才下载；创建请求返回成功不等于视频已经生成。