查询

GET https://top.qingyuntop.ai/v1/videos/{task_id}

请求头：Authorization: Bearer YOUR_API_KEY。常见状态：queued（排队）、in_progress（生成中）、completed（完成）、failed（失败）。建议每 8–15 秒查询一次，并设置总超时；超时只表示观察窗口结束，不要重复创建。

下载

GET https://top.qingyuntop.ai/v1/videos/{task_id}/content

只有 completed 才调用此接口。它返回 MP4 字节流，不要把查询 JSON 中的预览文本当文件保存。

curl --fail-with-body "https://top.qingyuntop.ai/v1/videos/VIDEO_TASK_ID" -H "Authorization: Bearer YOUR_API_KEY"
curl --fail-with-body "https://top.qingyuntop.ai/v1/videos/VIDEO_TASK_ID/content" -H "Authorization: Bearer YOUR_API_KEY" -o sora-video.mp4

401/403 检查青云 Key 和模型权限；400 检查 prompt、seconds、size；429/5xx 只延迟重试查询。