查询：单个任务

对已经提交的任务进行查询状态：开发功能时可进行轮询查询，直到返回成功状态。

查询任务	查询接口
图片生成任务	/kling/v1/images/generations/:task_id
文生视频任务	/kling/v1/videos/text2video/:task_id
图生视频任务	/kling/v1/videos/image2video/:task_id

请求参数

Path 参数

action

string

必需

可选值：images | videos

示例值:

images

action2

string

必需

可选值：generations | text2video | image2video

示例值:

generations

task_id

string

任务ID

必需

示例值:

ClpKMGbyM0wAAAAAAFY2OA

Header 参数

Content-Type

string

可选

示例值:

application/json

Authorization

string

可选

示例值:

Bearer sk-xxxx

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

返回响应

🟢200成功

application/json

Body

code

integer

必需

message

string

必需

data

object

必需

task_id

string

必需

action

string

必需

status

string

必需

fail_reason

string

必需

submit_time

integer

必需

start_time

integer

必需

finish_time

integer

必需

progress

string

必需

data

object

必需

created_at

integer

必需

updated_at

integer

必需

task_result

object

必需

task_status

string

必需

task_status_msg

string

必需

request_id

string

必需

示例

{
  "code": 0,
  "message": "success",
  "request_id": "ClpKMGbyM0wAAAAAAFY2OA",
  "data": {
    "task_id": "ClpKMGbyM0wAAAAAAFY2OA",
    "created_at": 1727321278922,
    "updated_at": 1727321287018,
    "task_result": {
      "images": [
        {
          "url": "https://cdn.klingai.com/bs2/upload-kling-api/9575341070/image/ClpKMGbyM0wAAAAAAFY2OA-0_raw_image_0.png",
          "index": 0
        }
      ],
      "videos": null
    },
    "task_status": "succeed",
    "task_status_msg": ""
  }
}