Callback协议

Kling 回调通知功能特性允许您在异步任务（如视频资源产出、图像生成产出）完成后，自动完成收取任务输出结果推送。通过配置项回调地址，您无需反复轮询查询接口，系统会在任务进行处理完成后主动通知您的专属服务器。

异步任务回调协议

对于异步任务（图像生成产出/视频资源产出），若在创建生成任务时配置设置了 callback_url，当任务状态发生变更时，服务端会发出通知。

回调数据信息数据格式

{
  "task_id": "string", // 任务ID，系统生成
  "task_status": "string", // 任务状态
  "task_status_msg": "string", // 任务状态信息
  "created_at": 1722769557708, // 任务创建时间（Unix时间戳，单位ms）
  "updated_at": 1722769557708, // 任务更新时间（Unix时间戳，单位ms）
  "task_result": {
    "images": [ // 图片类任务的结果
      {
        "index": 0, // 图片编号，0-9
        "url": "string" // 生成图片的URL
      }
    ],
    "videos": [ // 视频类任务的结果
      {
        "id": "string", // 视频ID，全局唯一
        "url": "string", // 视频的URL
        "duration": "string" // 视频总时长，单位s
      }
    ]
  }
}

任务状态详细说明

task_status 可能的枚举值：

• submitted：已发起提交
• processing：进行处理中
• succeed：成功
• failed：失败

温馨提示事项

• 当任务失败时，task_status_msg 会展示失败原因（如触发平台的具体内容风控等）
• 图像URL代码示例：https://h1.inkwai.com/bs2/upload-ylab-stunt/1fa0ac67d8ce6cd55b50d68b967b3a59.png