Что вы создадите
Вы отправите задачу Kling text-to-video, сохраните возвращённый ID задачи, будете опрашивать соответствующий endpoint задачи Kling и решите, когда добавитьcallback_url для push-уведомлений.
Предварительные требования
- Ключ API CometAPI, сохранённый в
COMETAPI_KEY - Python 3.10+ с
requestsили Node.js 18+ - Серверный worker для polling или HTTPS callback endpoint для webhook-уведомлений
API key, базовый URL, аутентификация
Создайте задачу Kling text-to-video с помощью:Примеры кода
Используйте вкладки ниже, чтобы скопировать примеры для cURL, Python и Node.js.Объяснение процесса
Генерация видео Kling выполняется асинхронно. Endpoint создания возвращаетdata.task_id. Опрашивайте GET /kling/v1/videos/text2video/<task_id>, пока data.task_status не достигнет succeed или failed. Когда задача успешно завершится, скопируйте URL готового ресурса из data.task_result в собственное хранилище, если вам нужен долговременный доступ.
Добавьте callback_url, если хотите, чтобы обновления статуса задачи отправлялись на контролируемый вами HTTPS endpoint. Сохраняйте polling доступным для сверки и на случай пропущенной доставки callback.
Общие параметры
Устранение неполадок / FAQ
Форма ответа отличается от video routes OpenAI
Форма ответа отличается от video routes OpenAI
Kling использует специфичные для провайдера JSON-поля, такие как
data.task_id, data.task_status и data.task_result. Не разбирайте его так же, как OpenAI-совместимые routes /v1/videos.Задача так и не достигает succeed
Задача так и не достигает succeed
Используйте ограниченный polling и проверяйте
data.task_status_msg, если задача завершилась с ошибкой. Сохраните ID задачи для последующей диагностики.Стоит использовать callback_url или polling
Стоит использовать callback_url или polling
Используйте polling как базовый вариант. Добавьте
callback_url для push-доставки, затем сверяйте финальное состояние через polling.Следующие шаги
- Прочитайте справочник API Kling text-to-video.
- Выполняйте polling через Получить задачу Kling.
- Настройте callback через Использование callback URLs Kling.
- Найдите видеомодели Kling в разделе Models.
- Ознакомьтесь с Использованием polling и webhooks для генерации видео.
- Оцените стоимость задачи с помощью Оценка стоимости запроса перед вызовом модели.