Перейти к основному содержанию

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, когда вам нужна 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 в зависимости от типа задачи
  • Сохраняйте возможность ручного 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"
      }
    ]
  }
}