功能与输入
文本放在 input 字符串或 input_text，普通图片可放在 input_image；首尾帧角色、参考视频和音频放在 metadata.content。本入口接受可访问的图片 URL 和完整 data URL，不要求所有图片先转换成 Base64，也不把 input_video 自动转换成参考视频。
请求地址：https://top.qingyuntop.ai/v1/responses。
第一步：鉴权
在控制台 API 密钥取得青云 API Key。每次创建、查询和下载请求都发送以下请求头：
Authorization: Bearer YOUR_API_KEY将 YOUR_API_KEY 替换为自己的 Key，保留 Bearer 和其后一个空格。无需先请求登录接口。
第二步：选择模式并调用
| 模式 | 参数 | 返回及后续 |
|---|---|---|
| 后台（推荐） | background: true，stream: false | 尽快返回 resp_…，随后 GET /v1/responses/{response_id}。 |
| 同步 | background: false，stream: false | 等待终态；观察超时可能返回 queued，仍需查询。 |
| 流式 | stream: true | SSE 推送进度及最终文本；不是边生成边传输视频字节。 |
background: true 与 stream: true 同时设置仍是 SSE，不能当作立即返回 JSON 的后台调用。需要稳定的异步任务处理时用第一行。
任务标识
| 字段 | 用途 |
|---|---|
| id（resp_…） | GET /v1/responses/{response_id} 查询。 |
| metadata.task_id | GET /v1/videos/{task_id}/content 下载。 |
响应中的 metadata.task_id 是青云生成的任务关联信息；请求里的 metadata 是豆包生成选项，不是任意业务标签容器。不要交换两个 ID。
开始阅读：创建文本和参考输入视频、模式示例、查询与下载。模型时长与清晰度见模型表。