Callback URL

Використовуйте callback_url в асинхронних завданнях Kling, коли вам потрібна push-доставка замість виключно polling.

Де це використовувати

Завдання text-to-video та image-to-video
Завдання avatar і video-effects
Інші асинхронні маршрути Kling, які мають необов’язкове поле callback_url

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

Kling надсилає запит до вашого callback endpoint щоразу, коли змінюється статус завдання
Поширені статуси: submitted, processing, succeed і failed
Payload може містити task_result.images або task_result.videos залежно від типу завдання
Залишайте manual polling доступним для звірки, повторних спроб або обробки пропущених webhook

Чекліст інтеграції

Використовуйте HTTPS callback endpoint, яким ви керуєте
Приймайте повторні оновлення статусу для того самого id завдання
Розглядайте доставку webhook як асинхронну та зрештою узгоджену
Швидко зберігайте фінальні URL ресурсів, якщо вашому workflow потрібне надійне сховище

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