• 简体中文
  • 旧版使用指南(v2.5-turbo)

    本页面向 2026-09 前接入、只使用 kling-video-v2.5-turbo 的存量用户,仅保留该模型实际用到的字段。新项目或需要其他可灵模型的用户请移步新版提交任务。

    端点

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

    请求体

    字段类型必填说明
    modelstring是固定 kling-video-v2.5-turbo(model_name 同样有效)
    promptstring是视频描述
    imagestring否图生视频首帧图片(URL 或 Base64);带此字段按图生视频处理。支持 jpg / jpeg / png,≤ 50MB,宽高均 ≥ 300px
    modestring否分辨率档位:std(720p)/ pro(1080p),不传默认 std
    durationstring否时长(秒):"5" / "10",不传默认 "5"
    sizestring否画幅,仅文生视频有效:1920x1080 / 1280x720 → 16:9,720x1280 / 1080x1920 → 9:16,其余 → 1:1。图生视频画幅跟随图片
    metadataobject否附加参数对象:metadata.image_tail(尾帧图,须伴随 image,自动强制 1080p)与 metadata.negative_prompt(反向提示词)放这里
    NOTE

    v2.5-turbo 不支持音频(audio)、4k 分辨率(ultra)、元素 / 音色引用(el- / vo-)与多镜头,这些旧字段会被忽略;需要时请改用新版字段并搭配对应模型。

    请求示例

    cURL
    Python
    Node.js
    # 文生视频
    curl -X POST https://api-model.shuntianchuang.cn/kling/v1/videos/text2video \
      -H "Authorization: Bearer sk-你的令牌" \
      -H "Content-Type: application/json" \
      -d '{
        "model": "kling-video-v2.5-turbo",
        "prompt": "一只橘猫在草地上追蝴蝶,电影感镜头,缓慢推近",
        "duration": "5",
        "size": "1280x720",
        "mode": "std"
      }'
    # 图生视频 + 尾帧
    curl -X POST https://api-model.shuntianchuang.cn/kling/v1/videos/image2video \
      -H "Authorization: Bearer sk-你的令牌" \
      -H "Content-Type: application/json" \
      -d '{
        "model": "kling-video-v2.5-turbo",
        "image": "https://example.com/first-frame.jpg",
        "prompt": "让画面中的猫跑起来,镜头缓慢推近",
        "metadata": {"image_tail": "https://example.com/last-frame.jpg"}
      }'

    查询与下载

    用提交返回的任务 ID 轮询(图生视频把路径换成 image2video):

    curl https://api-model.shuntianchuang.cn/kling/v1/videos/text2video/task_xxxxxxxx \
      -H "Authorization: Bearer sk-你的令牌"
    data 字段说明
    task_id任务 ID;提交响应顶层同样返回一份 task_id
    task_status状态流转:submitted(已提交)→ processing(生成中)→ succeed(成功)或 failed(失败)
    task_status_msg失败原因,仅失败时非空
    task_result.videos[]成功后的视频列表,每项含 id、url(下载直链,链接有时效,请及时下载转存)、duration(秒)
    final_unit_deduction成功时的实际消耗(字符串,单位 TokenHub token),仅成功时返回
    created_at / updated_at任务创建 / 最后更新时间戳(毫秒),仅成功时返回
    {
      "code": 0,
      "message": "SUCCEED",
      "data": {
        "task_id": "task_9AUeg9lOftqbEG1kgmcYngreXu0aJe20",
        "task_status": "succeed",
        "task_status_msg": "",
        "task_result": {
          "videos": [
            { "id": "937575610917490712", "url": "https://xxxx/video.mp4", "duration": "5.083" }
          ]
        },
        "create_time": 1791563923000,
        "update_time": 1791564087821,
        "created_at": 1791563923000,
        "updated_at": 1791564087821,
        "final_unit_deduction": "250000"
      }
    }
    NOTE

    code 为整数 0 表示受理 / 查询成功(message 为 "SUCCEED"),业务状态以 data.task_status 为准。

    NOTE

    模型名与价格以模型广场显示为准;计费按任务完成时的实际用量结算(失败自动退还)。接入新模型或新写法请见新版提交任务。