功能介绍

Responses 查询用于恢复后台任务或断线后的状态。获取视频文件时，使用结果中的任务 ID 进入本站产物接口。

鉴权与操作步骤

所有请求发送到 https://top.qingyuntop.ai。在请求头填写 Authorization: Bearer YOUR_API_KEY，将 YOUR_API_KEY 替换为青云TOP API 控制台创建的 API Key；Bearer 与密钥之间保留一个空格。

  1. 使用创建响应中已保存的标识，携带鉴权请求头查询任务。
  2. 按状态继续等待或处理错误；成功且产物就绪后下载。无需再次创建任务。

GET 查询与下载不需要请求体。示例中的占位密钥需替换为你的 API Key。实际业务请在服务端保存密钥，不要放进公开网页。

查询响应

GET /v1/responses/{response_id}，无请求体。将 YOUR_RESPONSE_ID 替换为创建返回的 id，原样传入。

curl --fail-with-body "https://top.qingyuntop.ai/v1/responses/YOUR_RESPONSE_ID" \
  -H "Authorization: Bearer YOUR_API_KEY"

读取 status：queued / in_progress 继续等待，completed 读取结果，failed 查看 error。incomplete 表示观察未完整完成，应保留 ID 重查并查看错误详情；不能直接认定生成失败。建议每 5–10 秒查询，业务等待期限到达后稍后恢复查询。

完成后，output 中的 message.content 可能包含 type=output_text 的 <video controls src="..."> 预览字符串，不是 base64 视频。遍历 output 数组，不要假定它永远只有一个元素。

获取任务 ID 与产物

读取响应 metadata.task_id，替换下面的 YOUR_TASK_ID。不要使用 response ID 代替任务 ID，也不要自行转换前缀。查询产物列表：

GET /v1/tasks/{task_id}/artifacts

curl --fail-with-body "https://top.qingyuntop.ai/v1/tasks/YOUR_TASK_ID/artifacts" \
  -H "Authorization: Bearer YOUR_API_KEY"

本接口的视频产物 key 为 video；只在列表确认已就绪后下载。若列表为空，检查任务是否已完成并稍后重查。下载接口返回字节：

GET /v1/tasks/{task_id}/artifacts/video/content

curl --fail-with-body "https://top.qingyuntop.ai/v1/tasks/YOUR_TASK_ID/artifacts/video/content" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  --output result.mp4

下载接口仍使用本站 API Key，文件保存为 result.mp4。不要把 Key 拼入 URL，也不要把它转发给厂商 CDN。建议及时保存生成文件。