id 查询,GET 无请求体。| status | 含义 | 客户端处理 |
|---|---|---|
| queued / in_progress | 排队或处理中 | 约 5 秒后继续查询 |
| completed | 成功 | 停止轮询,调用内容接口下载 |
| failed | 失败或取消 | 停止轮询,检查 error |
progress 只是 0/100 标记,并非实时百分比。成功时可选返回 usage.total_tokens/input_tokens/output_tokens,客户端不能依赖用量对象判断成功,也不要依赖本文未定义的上游响应字段。GET /v1/videos/{id}/content 使用相同 Bearer Key,正常响应 HTTP 200、Content-Type: video/mp4;请保存二进制响应。尚未完成返回 HTTP 409(error.code 为 NotReady);任务不存在或无权限返回 404;文件暂不可用可返回 502。先检查 HTTP 状态码,失败响应按错误 JSON 处理,不要把 JSON 错误内容当视频使用。