跳轉到主要內容
當你希望使用推送傳遞，而不是純輪詢時，可在 Kling 非同步任務中使用 callback_url。

​
使用位置

  • 文字轉影片與圖片轉影片任務
  • Avatar 與影片特效任務
  • 其他提供可選 callback_url 欄位的 Kling 非同步路由

​
傳遞行為

  • 每當任務狀態變更時，Kling 都會向你的回呼端點發送請求
  • 常見狀態包括 submitted、processing、succeed 和 failed
  • payload 可能會根據任務類型包含 task_result.images 或 task_result.videos
  • 建議保留手動輪詢機制，以便進行資料核對、重試或處理遺漏的 webhook

​
整合檢查清單

  • 使用你可控制的 HTTPS 回呼端點
  • 接受同一個 task 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"
      }
    ]
  }
}