获取 Kling 任务

GET

kling

{action}

{action2}

{task_id}

curl "https://api.cometapi.com/kling/v1/videos/text2video/<task_id>" \
  -H "Authorization: Bearer $COMETAPI_KEY"

{
  "task_id": "<task_id>",
  "task_status": "submitted",
  "task_info": {},
  "created_at": 1781080355827,
  "updated_at": 1781080355827
}

创建 Kling 任务后，使用此端点系列。这是 Kling 异步媒体任务的通用轮询步骤。

查询可以直接返回任务对象，也可以将其置于标准的 data 封装中。读取任务字段之前，先使用 task = payload.data ?? payload 对每个响应进行规范化，再读取任务字段。

首先检查什么

task.task_status；运动控制任务使用 submitted、processing， succeed或 failed
task.task_result.videos[0].url 来判断视频任务何时成功
task.task_status_msg ；当任务提前停止时，则检查其他返回的详细字段
code, message；当响应使用标准 request_id 时，检查封装。

轮询模式

从匹配的端点创建任务

先从适用于您的工作流的 Kling 创建页面开始，例如文本转视频, 图像转视频，或运动控制.

轮询直到任务进入终态

将响应结构规范化，然后使用返回的任务 ID 持续查询直至其进入终态。对于运动控制，终态为 succeed 和 failed。

继续执行下一工作流步骤

直接使用完成的输出；如果您的工作流支持链式操作，也可以进入下一个适用的操作页面。

常见路径配对

工作流	查询路径
文本转视频	`/kling/v1/videos/text2video/{task_id}`
图像转视频	`/kling/v1/videos/image2video/{task_id}`
运动控制	`/kling/v1/videos/motion-control/{task_id}`
多图像视频	`/kling/v1/videos/multi-image2video/{task_id}`
视频特效	`/kling/v1/videos/effects/{task_id}`
视频延长	`/kling/v1/videos/video-extend/{task_id}`
虚拟人视频	`/kling/v1/videos/avatar/image2video/{task_id}`

如需完整参数参考，请参阅 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.

Option 1
Option 2

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.

Show child attributes

watermark_info

object

Watermark information when returned by a compatible workflow.

Show child attributes

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.

Show child attributes

最后修改于 2026年7月31日

curl "https://api.cometapi.com/kling/v1/videos/text2video/<task_id>" \
  -H "Authorization: Bearer $COMETAPI_KEY"

{
  "task_id": "<task_id>",
  "task_status": "submitted",
  "task_info": {},
  "created_at": 1781080355827,
  "updated_at": 1781080355827
}

内容审核

API 密钥

首先检查什么

轮询模式

常见路径配对

授权

路径参数

响应

​首先检查什么

​轮询模式

​常见路径配对

授权

路径参数

响应

首先检查什么

轮询模式

常见路径配对