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

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

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

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

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

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

  • Используйте HTTPS endpoint обратного вызова, который вы контролируете
  • Принимайте повторяющиеся обновления статуса для одного и того же task 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"
      }
    ]
  }
}