任务查询（Legacy）

本页仅覆盖 /kling/v1/** 的 Legacy 任务。新版创建响应为 data.id，请使用 API 2.0 查询，不要混用本页字段。任务状态

状态	含义	说明
`submitted`	已提交	任务已进入队列
`processing`	处理中	任务正在生成
`succeed`	成功	任务完成，可获取结果
`failed`	失败	任务失败，查看 `task_status_msg`

任务ID说明

task_id：上游原始任务 ID（由可灵官方生成）
platform_id：Kapon 平台统一追踪 ID，格式为 video_<ULID>（视频）或 image_<ULID>（图像）
external_task_id：用户自定义的任务ID，用于业务关联；建议使用UUID，不把重复提交视为平台幂等创建承诺

查询接口支持以上任一 ID 进行查询。通用响应字段

字段	说明
`task_id`	上游原始任务 ID
`platform_id`	Kapon 平台统一追踪 ID
`task_status`	任务状态：`submitted`/`processing`/`succeed`/`failed`
`task_status_msg`	失败原因（仅失败时返回）
`task_info.external_task_id`	回显创建任务时传入的自定义ID
`task_result`	任务结果（成功时返回）
`watermark_info`	水印回显（创建任务时启用后返回）
`final_unit_deduction`	实际扣减积分（成功后回写）
`created_at`/`updated_at`	毫秒级时间戳

计费字段

响应包含 final_unit_deduction 时，按积分计费：
- 视频：1 积分 = 1 元
- 图像：1 积分 = 0.025 元
若未返回 final_unit_deduction，不再回退模型默认价格，任务不计费。

视频生成任务查询

文生视频

# 查询单个任务
curl "https://models.kapon.cloud/kling/v1/videos/text2video/$TASK_ID" \
  -H "Authorization: Bearer $TOKEN"

# 查询任务列表
curl "https://models.kapon.cloud/kling/v1/videos/text2video?pageNum=1&pageSize=30" \
  -H "Authorization: Bearer $TOKEN"

图生视频

# 查询单个任务
curl "https://models.kapon.cloud/kling/v1/videos/image2video/$TASK_ID" \
  -H "Authorization: Bearer $TOKEN"

# 查询任务列表
curl "https://models.kapon.cloud/kling/v1/videos/image2video?pageNum=1&pageSize=30" \
  -H "Authorization: Bearer $TOKEN"

Omni 视频

# 查询单个任务
curl "https://models.kapon.cloud/kling/v1/videos/omni-video/$TASK_ID" \
  -H "Authorization: Bearer $TOKEN"

# 查询任务列表
curl "https://models.kapon.cloud/kling/v1/videos/omni-video?pageNum=1&pageSize=30" \
  -H "Authorization: Bearer $TOKEN"

多图参考生视频

# 查询单个任务
curl "https://models.kapon.cloud/kling/v1/videos/multi-image2video/$TASK_ID" \
  -H "Authorization: Bearer $TOKEN"

# 查询任务列表
curl "https://models.kapon.cloud/kling/v1/videos/multi-image2video?pageNum=1&pageSize=30" \
  -H "Authorization: Bearer $TOKEN"

视频特效

# 查询单个任务
curl "https://models.kapon.cloud/kling/v1/videos/effects/$TASK_ID" \
  -H "Authorization: Bearer $TOKEN"

# 查询任务列表
curl "https://models.kapon.cloud/kling/v1/videos/effects?pageNum=1&pageSize=30" \
  -H "Authorization: Bearer $TOKEN"

视频延长

# 查询单个任务
curl "https://models.kapon.cloud/kling/v1/videos/video-extend/$TASK_ID" \
  -H "Authorization: Bearer $TOKEN"

# 查询任务列表
curl "https://models.kapon.cloud/kling/v1/videos/video-extend?pageNum=1&pageSize=30" \
  -H "Authorization: Bearer $TOKEN"

视频延长需要上游接受的源视频 video_id。若源视频不满足可延长条件，上游会返回失败，平台不会创建成功任务或产生成功扣费。

对口型

# 查询单个任务
curl "https://models.kapon.cloud/kling/v1/videos/advanced-lip-sync/$TASK_ID" \
  -H "Authorization: Bearer $TOKEN"

# 查询任务列表
curl "https://models.kapon.cloud/kling/v1/videos/advanced-lip-sync?pageNum=1&pageSize=30" \
  -H "Authorization: Bearer $TOKEN"

/kling/v1/videos/advanced-lip-sync 透传官方请求体；官方前置 identify-face 本期暂不开放。

图像生成任务查询

单图生成

# 查询单个任务
curl "https://models.kapon.cloud/kling/v1/images/generations/$TASK_ID" \
  -H "Authorization: Bearer $TOKEN"

# 查询任务列表
curl "https://models.kapon.cloud/kling/v1/images/generations?pageNum=1&pageSize=30" \
  -H "Authorization: Bearer $TOKEN"

Omni 图像

# 查询单个任务
curl "https://models.kapon.cloud/kling/v1/images/omni-image/$TASK_ID" \
  -H "Authorization: Bearer $TOKEN"

# 查询任务列表
curl "https://models.kapon.cloud/kling/v1/images/omni-image?pageNum=1&pageSize=30" \
  -H "Authorization: Bearer $TOKEN"

多图参考生图

# 查询单个任务
curl "https://models.kapon.cloud/kling/v1/images/multi-image2image/$TASK_ID" \
  -H "Authorization: Bearer $TOKEN"

# 查询任务列表
curl "https://models.kapon.cloud/kling/v1/images/multi-image2image?pageNum=1&pageSize=30" \
  -H "Authorization: Bearer $TOKEN"

多模态编辑任务查询

# 查询单个任务
curl "https://models.kapon.cloud/kling/v1/videos/multi-elements/$TASK_ID" \
  -H "Authorization: Bearer $TOKEN"

# 查询任务列表
curl "https://models.kapon.cloud/kling/v1/videos/multi-elements?pageNum=1&pageSize=30" \
  -H "Authorization: Bearer $TOKEN"

分页参数

参数	类型	默认值	范围	说明
`pageNum`	int	1	[1, 1000]	页码
`pageSize`	int	30	[1, 500]	每页数量

视频任务成功响应示例

{
  "code": 0,
  "message": "success",
  "request_id": "req_...",
  "data": {
    "task_id": "task_01JGHS...",
    "task_status": "succeed",
    "task_info": {
      "external_task_id": "my-custom-id-123"
    },
    "watermark_info": {
      "enabled": true
    },
    "final_unit_deduction": "7",
    "task_result": {
      "videos": [
        {
          "id": "vid_abc123",
          "url": "https://cdn.example.com/generated-video.mp4",
          "duration": "5"
        }
      ]
    },
    "created_at": 1735558800000,
    "updated_at": 1735559100000
  }
}

图像任务成功响应示例

{
  "code": 0,
  "message": "success",
  "request_id": "req_...",
  "data": {
    "task_id": "task_01JGHT...",
    "task_status": "succeed",
    "watermark_info": {
      "enabled": true
    },
    "final_unit_deduction": "4",
    "task_result": {
      "images": [
        {"index": 0, "url": "https://cdn.example.com/image-0.jpg"},
        {"index": 1, "url": "https://cdn.example.com/image-1.jpg"}
      ]
    },
    "created_at": 1735558800000,
    "updated_at": 1735559000000
  }
}

任务失败响应示例

{
  "code": 0,
  "message": "success",
  "data": {
    "task_id": "task_01JGHU...",
    "task_status": "failed",
    "task_status_msg": "Content moderation failed",
    "created_at": 1735558800000,
    "updated_at": 1735558900000
  }
}

图片结果与列表

普通图片使用 task_result.images；Omni组图使用 task_result.series_images，并返回 result_type。图片项包含 index、url 与可选 watermark_url。列表接口以 data 数组返回本用户的任务；data_list 是保留给旧客户端的兼容别名。分页继续使用 pageNum/pageSize，不与新版游标混用。

概述

API 2.0

Legacy 视频生成

图像生成

视频编辑

任务管理

视频生成任务查询

文生视频

图生视频

Omni 视频

多图参考生视频

视频特效

视频延长

对口型

图像生成任务查询

单图生成

Omni 图像

多图参考生图

多模态编辑任务查询

分页参数

视频任务成功响应示例

图像任务成功响应示例

任务失败响应示例

图片结果与列表

​视频生成任务查询

​文生视频

​图生视频

​Omni 视频

​多图参考生视频

​视频特效

​视频延长

​对口型

​图像生成任务查询

​单图生成

​Omni 图像

​多图参考生图

​多模态编辑任务查询

​分页参数

​视频任务成功响应示例

​图像任务成功响应示例

​任务失败响应示例

​图片结果与列表

视频生成任务查询

文生视频

图生视频

Omni 视频

多图参考生视频

视频特效

视频延长

对口型

图像生成任务查询

单图生成

Omni 图像

多图参考生图

多模态编辑任务查询

分页参数

视频任务成功响应示例

图像任务成功响应示例

任务失败响应示例

图片结果与列表