数眼智能
官网主页控制台API文档
条款与协议
官网主页控制台API文档
条款与协议
  1. 可灵AI视频生成-新版接口
  • 快速开始
    • 平台简介
    • 控制台(入门)
    • API key
    • Base URL
  • 开发工具接入
    • OpenClaw
    • Claude Code
    • Claude Code IDE
    • Codex
    • OpenCode
    • Cline
    • Grok CLI
    • Gemini CLI
    • N8N
    • AutoClaw
    • 其他工具
  • AI大模型API
    • 文本生成API
      • 对话补全 Chat Completions
    • 视频生成接口API
      • 豆包Seedance视频生成
        • 00-概述
        • 01-创建视频生成任务
        • 02-查询视频生成任务
        • 03-查询视频生成任务列表
        • 04-取消或删除视频生成任务
        • Seedance 私域素材库 API
      • 海螺Hailuo视频生成
        • 00-概述
        • 01-文生视频-T2V
        • 02-图生视频-I2V
        • 03-首尾帧生成视频-FL2V
        • 04-主体参考视频-S2V
        • 05-查询任务状态
        • 06-视频下载
        • 07-附录-运镜指令与回调
      • MiniMax-H3视频生成
        • 00-概述
        • 01-创建视频生成任务
        • 02-创建视频再生成任务
        • 03-创建H3-Context-IR任务
        • 04-查询任务
        • 05-查询任务列表
        • 06-取消或删除任务
      • 可灵AI视频生成-新版接口
        • 00-概述
        • 01-文生视频
        • 02-图生视频
        • 03-Omni视频生成
        • 04-动作控制
        • 05-查询任务
      • 可灵AI视频生成-原版接口
        • 00-概述
        • 01-文生视频
        • 02-图生视频
        • 03-视频Omni
        • 04-多图参考生视频
        • 05-动作控制
        • 06-多模态视频编辑
        • 07-视频延长
        • 08-对口型
        • 09-数字人
        • 10-文生音效
        • 11-视频配音效
        • 12-语音合成
        • 13-音色克隆
        • 14-图像识别
        • 15-主体管理
        • 16-视频特效
      • Vidu视频生成
        • 00-概述
        • 01-文生视频
        • 02-图生视频
        • 03-参考生视频
        • 04-首尾帧
        • 05-智能多帧
        • 06-场景特效模板
        • 07-模板成片
        • 08-查询任务
      • 即梦视频生成
        • 00-概述
        • 01-3.0Pro视频生成
        • 02-720P文生视频
        • 03-720P图生视频-首帧
        • 04-720P图生视频-首尾帧
        • 05-720P图生视频-运镜
        • 06-1080P文生视频
        • 07-1080P图生视频-首帧
        • 08-1080P图生视频-首尾帧
        • 09-错误码
      • 万相视频生成
        • 00-概述
        • 01-文生视频
        • 02-图生视频
        • 03-参考生视频
        • 04-视频编辑
        • 05-首尾帧生视频
        • 06-动作迁移与视频换人
        • 07-数字人视频
        • 08-通用视频编辑-VACE
        • 09-查询任务
      • HappyHorse
        • HappyHorse-文生视频
        • HappyHorse-图生视频-基于首帧
        • HappyHorse-参考生视频
        • HappyHorse-视频编辑
      • 通用视频生成API
        • 通用视频生成 API 接口调用文档
    • 通用图像生成API
      • 图像生成接口文档
    • Rerank重排序模型
      • 重排序
  • 搜索/阅读API
    • 网页阅读API
      • Web Reader API
    • 联网搜索API
      • 搜索API
      • 搜索+阅读API
    • 模态卡API
      • 天气
        • 天气模态卡
        • 国内外城市ID
        • 天气查询API
      • 搜索 API(旧)
      • 热搜 API
    • 文件OCR解析API
      • PDF文件
      • URL解析
  • 进阶与系统接口
    • CODE&错误码
    • HTTP注意事项
    • 身份验证
    • 接入指南
    • 在线调试
    • 数据更新相关
    • API 密钥与额度查询接口
    • API 密钥管理接口文档
    • 额度与密钥查询
    • Models(列出模型)
    • 查询账户信息
  1. 可灵AI视频生成-新版接口

05-查询任务

查询任务#

文档版本:v1.0.0 | 最后更新:2026-09-02
本平台已完整适配可灵 AI 官方新版视频生成 API,请求与响应均为透传,参数语义与官方一致。
新版接口提供统一的任务查询端点:无论任务由文生视频、图生视频、Omni 视频生成还是动作控制创建,均通过同一个接口查询。

查询任务#

GET https://platform.shuyanai.com/kling/tasks
当前接口仅支持查询非实时/异步任务。

请求头#

参数类型必填默认值说明
Content-Typestring是application/json数据交换格式
Authorizationstring是鉴权信息,参考接口鉴权

查询参数#

参数类型必填说明
task_idsstring可选需要查询的系统任务 ID(创建任务响应中的 data.id)
- 支持批量查询,多个 ID 用 , 分隔
- task_ids 与 external_task_ids 至少且只能选择一种,不可同时使用
external_task_idsstring可选需要查询的自定义任务 ID(创建任务时 options.external_task_id 传入的值)
- 支持批量查询,多个 ID 用 , 分隔
- task_ids 与 external_task_ids 至少且只能选择一种,不可同时使用

请求示例#

# 单任务查询
curl --request GET \
  --url 'https://platform.shuyanai.com/kling/tasks?task_ids={task_id}' \
  --header 'Authorization: Bearer <token>'

# 批量查询(逗号分隔)
curl --request GET \
  --url 'https://platform.shuyanai.com/kling/tasks?task_ids={id1},{id2},{id3}' \
  --header 'Authorization: Bearer <token>'

# 按自定义任务 ID 查询
curl --request GET \
  --url 'https://platform.shuyanai.com/kling/tasks?external_task_ids={your_external_task_id}' \
  --header 'Authorization: Bearer <token>'

响应示例#

{
  "code": 0, // 错误码;具体定义见错误码
  "message": "string", // 错误信息
  "request_id": "string", // 请求ID,系统生成,用于跟踪请求、排查问题
  "data": [
    {
      "id": "string", // 被查询的任务ID
      "status": "string", // 任务状态,枚举值:submitted(已提交)、processing(处理中)、succeeded(成功)、failed(失败)
      "message": "string", // 任务状态信息,当任务失败时展示失败原因(如触发平台的内容风控等)
      "create_time": 1781080778802, // 任务创建时间,Unix时间戳、单位ms
      "update_time": 1781080794151, // 任务更新时间,Unix时间戳、单位ms
      "external_id": "string", // 该任务的自定义任务ID(如有)
      "outputs": [
        {
          "type": "video", // 生成结果类型,视频生成任务为 video
          "id": "string", // 视频ID,由系统生成
          "url": "string", // 生成结果的URL,防盗链格式(请注意,为保障信息安全,生成的视频会在30天后被清理,请及时转存)
          "watermark_url": "string", // 含水印视频下载URL,防盗链格式
          "duration": "string" // 生成的视频的时长,单位:秒
        }
      ]
    }
  ]
}

说明#

data 为数组:单任务查询返回一个元素,批量查询按传入 ID 返回多个元素。
任务到达 succeeded 状态且 outputs 非空时,即可通过 outputs[].url 下载生成结果。
生成结果 URL 为防盗链格式,30 天后清理,请及时下载或转存。
建议轮询间隔 5~15 秒;也可在创建任务时配置 options.callback_url,由服务端在任务状态变更时主动通知,减少轮询。
上一页
04-动作控制
下一页
00-概述