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.

status
string

Optional compatibility response status. For a direct legacy Kling task response, synthesized values are PENDING, RUNNING, SUCCEEDED, or FAILED; use task_status as the canonical task state.

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