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

# Использование callback URL в Kling

> Настройте `callback_url` Kling в CometAPI, чтобы получать асинхронные обновления статуса задач видео/изображений и payload с результатами (от submitted до succeed/failed).

Используйте `callback_url` в асинхронных задачах Kling, если вам нужна push-доставка вместо одного только опроса.

## Где это использовать

* Задачи text-to-video и image-to-video
* Задачи avatar и video-effects
* Другие асинхронные маршруты Kling, в которых доступно необязательное поле `callback_url`

## Поведение доставки

* Kling отправляет POST-запросы на ваш callback endpoint при каждом изменении статуса задачи
* Распространённые статусы: `submitted`, `processing`, `succeed` и `failed`
* В payload могут присутствовать `task_result.images` или `task_result.videos` в зависимости от типа задачи
* Сохраняйте возможность ручного опроса для сверки, повторных попыток или обработки пропущенных webhook

## Чек-лист интеграции

* Используйте HTTPS callback endpoint, который вы контролируете
* Принимайте повторяющиеся обновления статуса для одного и того же task id
* Рассматривайте доставку webhook как асинхронную и в конечном итоге согласованную
* Быстро сохраняйте финальные URL ресурсов, если вашему workflow требуется долговременное хранение

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