跳转到主要内容
当你希望使用推送交付而不是纯轮询时，可在 Kling 异步任务中使用 callback_url。

​
使用位置

  • 文生视频和图生视频任务
  • 数字人和视频特效任务
  • 其他暴露了可选 callback_url 字段的 Kling 异步路由

​
交付行为

  • 每当任务状态发生变化时，Kling 会向你的回调端点发送请求
  • 常见状态包括 submitted、processing、succeed 和 failed
  • 根据任务类型，负载中可能包含 task_result.images 或 task_result.videos
  • 仍应保留手动轮询机制，用于对账、重试或处理遗漏的 webhook

​
集成检查清单

  • 使用由你控制的 HTTPS 回调端点
  • 接受同一任务 id 的重复状态更新
  • 将 webhook 交付视为异步且最终一致
  • 如果你的工作流需要持久化存储，请尽快保存最终资源 URL
{
  "task_id": "string",
  "task_status": "string",
  "task_status_msg": "string",
  "created_at": 1722769557708,
  "updated_at": 1722769557708,
  "task_result": {
    "images": [
      {
        "index": 0,
        "url": "https://example.com/generated-image.png"
      }
    ],
    "videos": [
      {
        "id": "string",
        "url": "https://example.com/generated-video.mp4",
        "duration": "5"
      }
    ]
  }
}