查询与下载(可灵统一格式)
提交任务后,用提交响应中的 id 调用查询接口轮询,任务成功后直接拿到成片直链——查询与取片一次完成,无需再调其他下载接口。
端点
GET /kling-video/v1/videos/{task_id}
task_id 为提交响应中的 id(见提交任务 · 响应体)。
请求示例
轮询直到 SUCCESS / FAILURE,取 result_url 下载:
响应体
任务状态由平台后台自动推进,不依赖客户轮询;轮询只是为了拿到 result_url。
状态机:
响应示例
下载成片
result_url 为成片直链:浏览器直接打开即可预览 / 保存;代码里 HTTP GET 下载、网页 <video> 播放、前端 fetch 读取均可。
直链有时效,请在生成后尽快下载取用,不要把直链当作长期有效的分发链接。
失败与错误处理
- 任务失败:
data.status为FAILURE,data.fail_reason给出可读原因(如素材不合规);失败任务不计费; - 任务不存在(HTTP 404):
- 提交期参数错误的包络与
error_code表见提交任务 · 错误处理。
