05-查询任务
查询任务
查询任务
GET https://platform.shuyanai.com/kling/tasks请求头
| 参数 | 类型 | 必填 | 默认值 | 说明 |
|---|---|---|---|---|
Content-Type | string | 是 | application/json | 数据交换格式 |
Authorization | string | 是 | 鉴权信息，参考接口鉴权 |
查询参数
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
task_ids | string | 可选 | 需要查询的系统任务 ID（创建任务响应中的 data.id）- 支持批量查询，多个 ID 用 , 分隔- task_ids 与 external_task_ids 至少且只能选择一种，不可同时使用 |
external_task_ids | string | 可选 | 需要查询的自定义任务 ID（创建任务时 options.external_task_id 传入的值）- 支持批量查询，多个 ID 用 , 分隔- task_ids 与 external_task_ids 至少且只能选择一种，不可同时使用 |
请求示例
响应示例
{
"code": 0, // 错误码；具体定义见错误码
"message": "string", // 错误信息
"request_id": "string", // 请求ID，系统生成，用于跟踪请求、排查问题
"data": [
{
"id": "string", // 被查询的任务ID
"status": "string", // 任务状态，枚举值：submitted（已提交）、processing（处理中）、succeeded（成功）、failed（失败）
"message": "string", // 任务状态信息，当任务失败时展示失败原因（如触发平台的内容风控等）
"create_time": 1781080778802, // 任务创建时间，Unix时间戳、单位ms
"update_time": 1781080794151, // 任务更新时间，Unix时间戳、单位ms
"external_id": "string", // 该任务的自定义任务ID（如有）
"outputs": [
{
"type": "video", // 生成结果类型，视频生成任务为 video
"id": "string", // 视频ID，由系统生成
"url": "string", // 生成结果的URL，防盗链格式（请注意，为保障信息安全，生成的视频会在30天后被清理，请及时转存）
"watermark_url": "string", // 含水印视频下载URL，防盗链格式
"duration": "string" // 生成的视频的时长，单位：秒
}
]
}
]
}说明
data 为数组：单任务查询返回一个元素，批量查询按传入 ID 返回多个元素。succeeded 状态且 outputs 非空时，即可通过 outputs[].url 下载生成结果。task_ids 中的任务不存在时返回 HTTP 400，code 为 task_not_exist；按 external_task_ids 查询无匹配任务时返回空数组 []。options.callback_url，由服务端在任务状态变更时主动通知，减少轮询。