Skip to main content
所有可灵的异步任务均可通过对应的查询接口获取任务状态和结果。 任务状态
状态含义说明
submitted已提交任务已进入队列
processing处理中任务正在生成
succeed成功任务完成，可获取结果
failed失败任务失败，查看 task_status_msg
任务ID说明
  • task_id：平台返回的任务ID，格式为 task_<ULID>
  • external_task_id：用户自定义的任务ID，可用于幂等控制和业务关联
支持任一 ID 进行查询。

​
视频生成任务查询

​
文生视频

# 查询单个任务
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"

​
多图参考生视频

# 查询单个任务
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/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"

​
多图参考生图

# 查询单个任务
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"

​
分页参数

参数类型默认值范围说明
pageNumint1[1, 1000]页码
pageSizeint30[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"
    },
    "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",
    "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
  }
}