Chuyển đến nội dung chính
Sử dụng callback_url cho các tác vụ bất đồng bộ của Kling khi bạn muốn nhận dữ liệu được đẩy tới thay vì chỉ polling.

​
Dùng ở đâu

  • Các tác vụ text-to-video và image-to-video
  • Các tác vụ avatar và video-effects
  • Các route bất đồng bộ khác của Kling có cung cấp trường callback_url tùy chọn

​
Cách thức gửi dữ liệu

  • Kling gửi POST tới endpoint callback của bạn bất cứ khi nào trạng thái tác vụ thay đổi
  • Các trạng thái phổ biến là submitted, processing, succeed, và failed
  • Payload có thể bao gồm task_result.images hoặc task_result.videos tùy theo loại tác vụ
  • Hãy duy trì polling thủ công để đối soát, retry hoặc xử lý các webhook bị bỏ lỡ

​
Danh sách kiểm tra tích hợp

  • Sử dụng endpoint callback HTTPS do bạn kiểm soát
  • Chấp nhận các cập nhật trạng thái lặp lại cho cùng một task id
  • Xem việc gửi webhook là bất đồng bộ và chỉ nhất quán theo thời gian
  • Lưu trữ nhanh các URL asset cuối cùng nếu quy trình của bạn cần lưu trữ bền vững
{
  "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"
      }
    ]
  }
}