Skip to main content
GET
Використовуйте це сімейство кінцевих точок після створення завдання Kling. Це стандартний крок опитування для асинхронних медіазавдань Kling.
Запит може повертати об’єкт завдання безпосередньо або в стандартній оболонці data Виконуйте нормалізацію кожної відповіді за допомогою task = payload.data ?? payload перед читанням полів завдання.

Що перевірити насамперед

  • task.task_status; для завдань Motion Control використовуйте submitted, processing, succeed, або failed
  • task.task_result.videos[0].url коли завдання відео успішно завершується
  • task.task_status_msg або інші повернуті поля з докладними відомостями, коли завдання завершується достроково
  • code, message, а також request_id, коли відповідь використовує стандартну оболонку

Шаблон опитування

1

Створіть завдання за допомогою відповідної кінцевої точки

Почніть зі сторінки створення Kling для вашого робочого процесу, наприклад Текст у відео, Зображення у відео, або Motion Control.
2

Опитуйте, доки завдання не досягне кінцевого стану

Нормалізуйте структуру відповіді, а потім продовжуйте надсилати запити з поверненим ідентифікатором завдання доки воно не досягне кінцевого стану. Для Motion Control кінцевими станами є succeed і failed.
3

Перейдіть до наступного кроку робочого процесу

Використовуйте готовий результат безпосередньо або перейдіть на сторінку наступної застосовної дії, якщо ваш робочий процес підтримує ланцюгові операції.

Поширені пари шляхів

Повний довідник параметрів див. в офіційній документації Kling.

Авторизації

Authorization
string
header
обов'язково

Bearer token authentication. Use your CometAPI key.

Параметри шляху

action
string
обов'язково

Resource type. One of: images, videos, audio.

action2
string
обов'язково

Sub-action matching the resource type. For images: generations, kolors-virtual-try-on. For videos: text2video, image2video, motion-control, lip-sync, effects, multi-image2video, multi-elements. For audio: text-to-audio, video-to-audio.

task_id
string
обов'язково

Task ID

Відповідь

200 - application/json

Current Kling task state.

A query can return the task object directly or inside the standard response envelope. Normalize both shapes before reading task fields.

task_id
string
обов'язково

Kling task ID.

task_status
string
обов'язково

Current task state. Compatible Motion Control tasks use submitted, processing, succeed, or failed.

task_status_msg
string

Failure or status detail when returned.

task_info
object

Additional task metadata. The object can be empty.

task_result
object

Absent on an initial submitted task, commonly empty while processing or after failure, and populated when a task succeeds.

watermark_info
object

Watermark information when returned by a compatible workflow.

created_at
integer<int64>

Task creation timestamp in milliseconds.

updated_at
integer<int64>

Last task update timestamp in milliseconds.

final_unit_deduction
string

Final unit deduction value, when returned.

final_balance_deduction
object

Final balance deduction values, when returned.

Останнє оновлення 31 липня 2026 р.