Responses 后台任务 | 青云TOP API 文档

设置 `background: true` 后，连接关闭不会取消生成。创建响应中的 Response ID 要保存起来，稍后用 GET 查询。

第一步：鉴权

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

第二步：调用模型

向 POST https://top.qingyuntop.ai/v1/responses 提交 JSON，设置 Content-Type: application/json。必填 model 和非空 input；时长使用 seconds，尺寸使用 size。模型与图片规则见输入与参数。

代码示例

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

curl --fail-with-body "https://top.qingyuntop.ai/v1/responses" -H "Authorization: Bearer YOUR_API_KEY" -H "Content-Type: application/json" -d '{"model":"sora-2-pro","input":"夜晚城市上空的航拍镜头，霓虹倒映在雨水中。","seconds":8,"size":"1792x1024","background":true,"stream":false}'

后台模式不改变查询和下载规则。按查询和下载 Responses 视频读取 metadata.task_id，不要因创建响应没有视频 URL 就再次创建。