第一步：鉴权
每次请求使用 Authorization: Bearer YOUR_API_KEY，将占位符替换为青云TOP API Key，保留 Bearer 后的空格。无需先调用登录接口。
第二步：调用模型
创建地址为 POST https://top.qingyuntop.ai/v1/videos。JSON 请求设置 Content-Type: application/json；上传图片时使用 multipart，由客户端生成 Content-Type 和 boundary。
| 参数 | 类型 | 说明 |
|---|---|---|
model | string | 必填，sora-2 或 sora-2-pro。 |
prompt | string | 必填且非空，描述主体、动作、镜头和风格。 |
seconds | number | 使用 4、8 或 12 秒，按模型限制选择，不要填写任意时长。 |
duration | number | seconds 兼容别名；两者同时存在时优先 seconds。 |
size | string | 720x1280、1280x720、1792x1024、1024x1792，具体按所选模型选择。 |
input_reference | string 或文件 | 图生起始图片；multipart 字段名必须是它，且只能一个文件。 |
image | string | JSON 图生兼容别名。应提供可直接读取的图片地址。 |
metadata | object | 可选对象；multipart 中作为 JSON 字符串发送。 |
不要照搬 Veo、Wan 或旧接口的 orientation、watermark、enhance_prompt、messages 等字段；未列出的字段不属于本文支持的参数。
代码示例
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" -H "Content-Type: application/json" -d '{"model":"sora-2","prompt":"雨后的老街，镜头缓慢向前推进。","seconds":8,"size":"1280x720"}'