Запрос видео
Запрашивайте статусы и результаты нативных задач Kling 4.0 по тексту, изображениям и Omni.
Используйте data.id из создания; при успехе читайте URL в outputs и сохраняйте. Возвращаются только доступные текущему пользователю задачи.
/kling/tasks/{task_id}Одна задача текущего пользователя Kling 4.0: текст, изображения, Omni. Используйте системный ID, не options.external_task_id. Статусы submitted, processing, succeeded, failed. Остановка опроса не отменяет задачу. billing публикует цену по прейскуранту и валюту, не счета аккаунта и внутренние списания.
Аутентификация
bearerAuth API Key платформы: Authorization: Bearer your-api-key.
Расположение: header
Параметры пути
Системный ID из создания. Новые ID строковые: не преобразуйте в число, чтобы не потерять точность.
1 <= lengthТело ответа
application/json
application/json
application/json
billing.list_price — прейскурантная цена в указанной валюте, не итоговое списание. Цена может появиться позже видео; отсутствие цены не означает бесплатность.
Статусы и сохранение
data — массив даже для одного ID. code запроса отличается от status генерации; сначала проверьте статус задачи.
status | Значение |
|---|---|
submitted | Отправлено, ожидает обработки |
processing | Обрабатывается; запросите позже |
succeeded | Успех; результат в outputs |
failed | Сбой генерации; читайте message и прекратите опрос |
У видео type равен video; id — ID видео, duration — секунды строкой. url — URL с защитой от прямых ссылок. Для водяного знака смотрите возвращённый watermark_url.
Результаты поставщика удаляются через 30 дней. Скачивайте вовремя. Это не гарантия действительности защищённого URL в течение 30 дней.
Ошибки запроса и сбои задач
| Ситуация | Проверка и действие |
|---|---|
HTTP 400, task_not_exist | Используйте системный ID создания, проверьте Key/сайт; не options.external_task_id |
HTTP 401, Invalid token | Проверьте Bearer и ключ; отсутствующий/неверный могут давать одинаковую ошибку |
HTTP 200, задача status: "failed" | Запрос успешен, генерация нет; читайте message и остановите опрос |
Ошибки HTTP могут отличаться от успешного data[]. Не путайте HTTP 400/401 со статусом failed. При ошибке авторизации или отсутствии задачи опрос прекращают.