Callback URL

​

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

• Завдання 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"
      }
    ]
  }
}