查询：单个任务

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

查询任务	查询接口
图片生成任务	/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": ""
    }
}