> ## Documentation Index
> Fetch the complete documentation index at: https://apidoc.cometapi.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Sử dụng callback URL của Kling

> Cấu hình `callback_url` của Kling trong CometAPI để nhận cập nhật trạng thái tác vụ video/hình ảnh bất đồng bộ và payload kết quả (từ submitted đến succeed/failed).

Sử dụng `callback_url` trên các tác vụ bất đồng bộ của Kling khi bạn muốn nhận dữ liệu theo cơ chế push thay vì chỉ polling.

## Nơi sử dụng

* Tác vụ text-to-video và image-to-video
* 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

## Hành vi phân phối

* Kling gửi yêu cầu POST đến endpoint callback của bạn mỗi khi 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ụ
* Vẫn nên duy trì polling thủ công để đối soát, thử lại, hoặc xử lý 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 phân phối webhook là bất đồng bộ và có tính nhất quán sau cùng
* Lưu lại nhanh các URL tài sản cuối cùng nếu quy trình của bạn cần lưu trữ bền vững

```jsonc theme={null}
{
  "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"
      }
    ]
  }
}
```