• 简体中文
  • 查询状态与下载视频(可灵格式)

    端点

    • 文生视频:GET /kling/v1/videos/text2video/{task_id}
    • 图生视频:GET /kling/v1/videos/image2video/{task_id}

    请求示例

    查询状态与获取视频(文生视频用 text2video 路径,图生视频把路径换成 image2video):

    cURL
    Python
    Node.js
    # 查询状态:图生视频把 text2video 换成 image2video
    curl https://api-model.shuntianchuang.cn/kling/v1/videos/text2video/task_xxxxxxxx \
      -H "Authorization: Bearer sk-你的令牌"
    
    # 任务 succeed 后,从 data.task_result.videos[0].url 取视频直链下载
    curl -o kling.mp4 "data.task_result.videos[0] 中返回的视频URL"

    响应体

    查询响应为可灵格式信封,业务数据在 data 内,关键字段如下:

    data 字段说明
    task_id任务 ID
    task_status状态流转:submitted(已提交)→ processing(生成中)→ succeed(成功)或 failed(失败)
    task_status_msg失败原因(成功时为空)
    task_result.videos[]成功后的视频列表,url 为下载直链、duration 为成片秒数
    create_time / update_time任务创建 / 更新时间(毫秒时间戳);旧版兼容镜像 created_at / updated_at 同值
    final_unit_deduction本次任务的上游实际用量(字符串),可用于对账

    响应示例

    {
      "code": 0,
      "message": "SUCCEED",
      "data": {
        "task_id": "task_xxxxxxxx",
        "task_status": "succeed",
        "task_status_msg": "",
        "create_time": 1790573568000,
        "update_time": 1790573782998,
        "created_at": 1790573568000,
        "updated_at": 1790573782998,
        "final_unit_deduction": "250000",
        "task_result": {
          "videos": [
            {
              "id": "933421703588872232",
              "url": "https://aigc-output-video-xxxx.cos.ap-guangzhou.myqcloud.com/xxxx.mp4?q-sign-algorithm=sha1&...",
              "duration": "5.083"
            }
          ]
        }
      }
    }
    WARNING

    成片 url 为上游签名直链,约 45 分钟后失效,拿到后请立即下载转存,勿当作长期存储链接分发。

    NOTE

    可灵格式的参数由网关映射后转发上游(字段映射与例外见提交任务),可用性、计费与响应字段以本站实际响应为准,模型名与价格以模型广场显示为准。计费按任务完成时的实际用量结算(失败自动退还)。