可灵Kling 任务查询API文档

推荐看官方文档

所有格式和参数都和官方文档一致。 仅在调用path前加上/kling。 我们更新不及时，建议直接查看官方文档

https://app.klingai.com/cn/dev/document-api/apiReference/updateNotice

概念说明

本API用于查询文生视频/图片、图生视频等AI生成任务的状态和结果。

通过任务ID(task_id)可以获取任务执行进度和生成内容URL。

接口地址

GET https://www.dmxapi.cn/kling/v1/{media_type}/{task_type}/{task_id}

路径参数

参数	类型	必填	说明
media_type	string	是	媒体类型：images或videos
task_type	string	是	任务类型： - 图片类：generations - 视频类：text2video/image2video/lip-sync - 试穿类：kolors-virtual-try-on
task_id	string	是	任务唯一标识ID

Python调用示例

import requests

# API配置
url = "https://www.dmxapi.cn/kling/v1/videos/text2video/784998939837341722"
api_key = "sk-************************************"  # 替换为你的 DMXAPI 令牌

# 请求头设置
headers = {
    "Authorization": f"Bearer {api_key}",
}

# 发送GET请求
response = requests.get(url, headers=headers)

# 打印响应结果
print(response.json())  # 解析JSON格式的响应数据

视频类返回示例

{
  "code": 0,                     // 状态码(0表示成功)
  "message": "成功",             // 状态描述
  "request_id": "784998939837341722", // 请求ID
  "data": {
    "task_id": "784998939837341722", // 任务ID
    "task_status": "succeed",       // 任务状态(succeed/failed/processing)
    "created_at": 1755186850621,    // 任务创建时间戳(毫秒)
    "updated_at": 1755187158592,    // 最后更新时间戳
    "task_info": {},                // 任务附加信息
    "task_result": {                // 任务结果
      "videos": [{
        "id": "784998939938013279", // 视频ID
        // 视频结果 URL
		"url": "https://v15-kling.klingai.com/bs2/upload-ylab-stunt-sgp/se/stream_lake_m2v_txt2video_1080p_std_v16/0842803e-c54d-479c-9cee-fd8ff97b2d80_raw_video.mp4?x-kcdn-pid=112372",
        "duration": "10.041"        // 视频时长(秒)
      }]
    }
  }
}

图片类返回示例

{
  "code": 0,
  "message": "成功",
  "request_id": "785023758959509518",
  "data": {
    "task_id": "785023758959509518",
    "task_status": "succeed",
    "created_at": 1755192767954,
    "updated_at": 1755192782372,
    "task_info": {
      "parent_video": {}
    },
    "task_result": {
      "images": [
        {
          "url": "https://s15-kling.klingai.com/bs2/upload-ylab-stunt-sgp/se/stream_lake_mmu_txt2img_aiweb/417d7469-6ab0-4620-8851-b42151942f0a_raw_image.png?x-kcdn-pid=112372"
        }
      ]
    }
  }
}

常见状态码

状态码	说明
0	请求成功
400	参数错误
401	认证失败
404	任务不存在
500	服务器内部错误

注意：请妥善保管API密钥，不要在客户端代码中明文存储

官方文档

https://app.klingai.com/cn/dev/document-api/apiReference/updateNotice