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

​

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

• Задачи 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 требуется долговременное хранение

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