第一步:鉴权
每次请求使用 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 按参数说明选择。
JSON 请求设置 Content-Type: application/json;图片地址放在 input_reference。
请提供可直接读取的图片地址,本接口不代为上传本地文件或转换地址。请使用公开、无需 Cookie、在任务完成前不会过期的 HTTPS 地址。本页推荐 HTTPS 图片地址,data URL 不作为通用接入方式。
代码示例
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","input_reference":"https://example.com/your-image.png"}'统一格式只传一张图片。创建后按查询和下载处理;若上游无法读取图片,换成稳定的公开 HTTPS 地址。