图生视频：上传图片 | 青云TOP API 文档

没有公开图片 URL 时使用 multipart。本接口只接受一个名为 `input_reference` 的文件字段，其它文件字段会被拒绝；不要手动设置 multipart boundary。

第一步：鉴权

每次请求使用 Authorization: Bearer YOUR_API_KEY，将占位符替换为青云TOP API Key，保留 Bearer 后的空格。无需先调用登录接口。

第二步：调用模型

向 POST https://top.qingyuntop.ai/v1/videos 提交 model、非空 prompt 和一张起始图片。模型使用 sora-2 或 sora-2-pro；seconds 选 4、8、12，size 按参数说明选择。

multipart 使用文件字段 input_reference，请准备示例中的本地图片。metadata 如需填写则使用 JSON 字符串；Content-Type 和 boundary 由客户端生成。

代码示例

cURL 使用 Bash 语法；Python 需要 requests；Node.js 使用 22+，含 import 的示例保存为 .mjs。

curl --fail-with-body "https://top.qingyuntop.ai/v1/videos" -H "Authorization: Bearer YOUR_API_KEY" -F "model=sora-2" -F "prompt=让图片中的人物抬头看向镜头，镜头轻微推进。" -F "seconds=8" -F "size=1280x720" -F "input_reference=@./reference.png"

上传后仍按查询和下载轮询。