Skip to main content
GET
Use this endpoint family after you create a Kling task. It is the common polling step for Kling async media jobs.
A query can return the task object directly or inside the standard data envelope. Normalize each response with task = payload.data ?? payload before reading task fields.

​
What to check first

  • task.task_status; Motion Control tasks use submitted, processing, succeed, or failed
  • task.task_result.videos[0].url when a video task succeeds
  • task.task_status_msg or other returned detail fields when a task stops early
  • code, message, and request_id when the response uses the standard envelope

​
Polling pattern

1

Create the task from the matching endpoint

Start with the Kling creation page for your workflow, such as Text to Video, Image to Video, or Motion Control.
2

Poll until the task is terminal

Normalize the response shape, then keep querying with the returned task id until it reaches a terminal state. For Motion Control, the terminal states are succeed and failed.
3

Continue to the next workflow step

Use the finished output directly, or move into the next applicable action page if your workflow supports chained operations.

​
Common path pairs

For the full parameter reference, see the official Kling documentation.

Authorizations

​
Authorization
string
header
required

Bearer token authentication. Use your CometAPI key.

Path Parameters

​
action
string
required

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

​
action2
string
required

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
required

Task ID

Response

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
required

Kling task ID.

​
task_status
string
required

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.

Last modified on July 31, 2026