URL Callback

​

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"
      }
    ]
  }
}