查询视频
查询 Kling 4.0 原生文生、图生和 Omni 任务的状态与结果。
使用创建响应中的 data.id 查询任务,成功后从 outputs 读取视频地址并及时保存。平台只返回当前用户可访问的任务数据。
/kling/tasks/{task_id}查询当前用户的单个 Kling 4.0 任务,适用于文生、图生和 Omni 生成。 使用系统返回的任务 ID,不是 options.external_task_id。 任务状态为 submitted、processing、succeeded 或 failed。停止轮询不等于取消任务。 billing 仅公开当前任务的刊例价与币种,不包含账户账单或内部扣费明细。
Authorization
bearerAuth 使用平台 API Key:Authorization: Bearer your-api-key。
In: header
Path Parameters
创建接口返回的系统任务 ID。新任务 ID 为字符串,不能转换为数字以免丢失精度。
1 <= lengthResponse Body
application/json
application/json
application/json
billing.list_price 是对应币种的刊例价,不是平台最终扣费金额。价格可能晚于视频结果出现,未返回价格不代表免费。
状态与结果保存
查询响应中的 data 是任务数组,即使通过单个任务 ID 查询,也应按数组读取。查询请求的 code 与生成任务的 status 含义不同,需要检查任务状态后再使用结果。
status | 含义 |
|---|---|
submitted | 已提交,等待处理 |
processing | 处理中,可稍后继续查询 |
succeeded | 生成成功,从 outputs 读取视频结果 |
failed | 生成失败,查看任务的 message 了解原因并停止轮询 |
视频结果的 type 为 video,id 为视频 ID,duration 是以字符串返回的秒数。url 为视频防盗链地址;需要带水印结果时,查看实际返回的 watermark_url。
上游生成结果将在 30 天后清理,请及时下载保存。这是结果清理规则,不代表防盗链 URL 保证持续有效 30 天。
查询错误与任务失败
| 情况 | 检查与处理 |
|---|---|
HTTP 400,task_not_exist | 使用创建时返回的系统任务 ID,检查 API Key 和所属站点;不要使用 options.external_task_id |
HTTP 401,Invalid token | 检查 Bearer 鉴权格式及 Key 是否有效;缺少 Key 和无效 Key 可能返回相同错误 |
HTTP 200,任务 status: "failed" | 查询本身成功,但生成失败;读取该任务的 message,停止轮询 |
HTTP 错误的响应包装不一定与成功的 data[] 一致。不要把 HTTP 400/401 当作任务的 failed 状态,也不要在鉴权错误或任务不存在时持续轮询。