> ## 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.

# Kling 콜백 URL 사용하기

> CometAPI에서 Kling `callback_url`을 구성하여 비동기 비디오/이미지 작업 상태 업데이트와 결과 payload(`submitted`부터 `succeed`/`failed`까지)를 수신합니다.

순수 폴링 대신 푸시 전달이 필요할 때 Kling 비동기 작업에서 `callback_url`을 사용하세요.

## 사용 위치

* 텍스트-투-비디오 및 이미지-투-비디오 작업
* 아바타 및 비디오 효과 작업
* 선택적 `callback_url` 필드를 제공하는 기타 Kling 비동기 라우트

## 전달 동작

* 작업 상태가 변경될 때마다 Kling이 콜백 엔드포인트로 POST 요청을 보냅니다
* 일반적인 상태는 `submitted`, `processing`, `succeed`, `failed`입니다
* payload에는 작업 유형에 따라 `task_result.images` 또는 `task_result.videos`가 포함될 수 있습니다
* 조정, 재시도 또는 누락된 webhook 처리를 위해 수동 폴링도 사용할 수 있도록 유지하세요

## 통합 체크리스트

* 직접 제어할 수 있는 HTTPS 콜백 엔드포인트를 사용하세요
* 동일한 task id에 대해 반복되는 상태 업데이트를 허용하세요
* webhook 전달은 비동기적이며 결국 일관성에 도달하는 방식으로 처리하세요
* 워크플로에 영구 저장소가 필요하다면 최종 asset URL을 빠르게 저장하세요

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