• 简体中文
  • 可灵模型指南

    可灵统一格式面向 15 个视频模型(kling-*),差异只在各模型的能力与参数取值。全部模型走相同的两个接口——提交任务 → 查询与下载。本页逐个介绍每个模型能做什么、支持哪些参数、怎么调用。

    资产模型与路由按模型系列对应,资产 ID 不互通:

    资产类型kling 系列(kling-* 模型)kling-v 系列(kling-v-* 模型)
    元素kling-elementkling-v-element
    音色kling-voicekling-v-voice

    详见元素与音色。

    TIP

    如果你使用的是 kling-video-* 名称的模型(与可灵官方 API 结构一致的「可灵格式」),请查阅可灵格式文档。两条产品线的模型名与端点互不通用。

    模型清单

    除 kling-2.5-turbo 为单版本外,其余 7 组提供 kling-* 与 kling-v-* 两个版本,成对同能力——同一行左右两个模型的分辨率、时长、audio、特色功能完全一致:

    kling 系列kling-v 系列定位
    kling-2.5-turbo—入门主力:720p / 1080p,5 / 10 秒
    kling-2.6kling-v-2.6支持原生配音(audio = native)
    kling-3.0kling-v-3.0旗舰:4k、3~15 秒、多镜头分镜
    kling-3.0-turbokling-v-3.0-turbov3 快速档:出片更快、价格更低
    kling-3.0-omnikling-v-3.0-omni全能:分镜 + 参考视频 + 4k
    kling-o1kling-v-o1参考视频编辑
    kling-motion-3.0kling-v-motion-3.0动作控制(可引用 1 个元素)
    kling-motion-2.6kling-v-motion-2.6动作控制(不支持元素)

    元素 / 音色的创建与引用见元素与音色。

    能力与参数总览

    各模型支持的档位集合(越界提交返回 400 并提示合法值):

    模型(成对)分辨率时长(秒)audio 合法值界限备注
    kling-2.5-turbo720p / 1080p5 / 10不支持(传非 off 值 → 400)首尾帧任务自动按 1080p 生成
    kling-2.6 / kling-v-2.6720p / 1080p5 / 10off / nativeaudio=native 自动按 1080p 生成
    kling-3.0 / kling-v-3.0720p / 1080p / 4k3 ~ 15off / native / original支持多镜头分镜;kling-v-3.0 传 original 返回 400
    kling-3.0-turbo / kling-v-3.0-turbo720p / 1080p3 ~ 15不支持(传非 off 值 → 400)—
    kling-3.0-omni / kling-v-3.0-omni720p / 1080p / 4k3 ~ 15off / native / original多镜头分镜 + 参考视频
    kling-o1 / kling-v-o1720p / 1080p3 ~ 10(无参考素材仅 5 / 10)off / original参考视频编辑
    kling-motion-3.0 / kling-v-motion-3.0720p / 1080p3 ~ 15off / original素材恰好一图一视频;元素 ≤ 1
    kling-motion-2.6 / kling-v-motion-2.6720p / 1080p3 ~ 15off / original素材恰好一图一视频;不支持元素

    audio 说明:off 静音(缺省,最低价档)/ native 生成配音 / original 保留原声。不传即静音,想要声音必须显式传。

    素材通道(metadata.contents)的适用范围:

    type携带键用途适用范围
    prompttext提示词素材项,可与顶层 prompt 并用全部模型
    first_frameurl首帧图图生 / 全能系
    last_frameurl尾帧图,必须与首帧同时提供;v2.5 / v2.6 系尾帧任务自动按 1080p 生成图生 / 全能系
    refer_imageurl参考图(主体参考)图生 / 全能系
    base_videourl参考视频仅全能系(kling-3.0-omni 系 / kling-o1 系)
    feature_videourl参考视频(特征)仅全能系
    videourl参考视频旧写法,等同 base_video仅全能系
    imageurl形象参考图仅动作控制模型
    elementid(可带 name;动作控制任务另带 element_id)引用已创建的元素普通任务 ≤ 3 个;动作控制仅 kling-motion-3.0 且 ≤ 1
    voiceid引用已创建的音色≤ 2 个;指定音色时 audio 不能为 off

    kling-2.5-turbo

    均衡的入门主力,适合日常文生 / 图生视频。不支持音轨,想要声音请选 kling-2.6 系或 v3 系。

    参数支持值
    resolution(分辨率)720p / 1080p
    duration(时长)5 / 10 秒
    audio(音轨)不支持(传非 off 值返回 400)
    aspect_ratio(画幅)16:9 / 9:16 / 1:1 / 4:3 / 3:4
    特色首尾帧任务自动按 1080p 生成

    图生视频示例(传 image 即图生):

    cURL
    Python
    Node.js
    curl -X POST https://api-model.shuntianchuang.cn/v1/videos \
      -H "Authorization: Bearer sk-你的令牌" \
      -H "Content-Type: application/json" \
      -d '{
        "model": "kling-2.5-turbo",
        "prompt": "镜头缓缓推进,猫转头看向镜头",
        "resolution": "1080p",
        "image": "https://example.com/first-frame.jpg"
      }'

    kling-2.6

    在 v2.5 基础上支持原生配音:metadata.audio 传 native 即生成带声音的视频(自动按 1080p 生成、按 1080p 计费)。也支持元素与音色引用——指定音色的任务同样自动按 1080p 生成。

    参数支持值
    resolution(分辨率)720p / 1080p
    duration(时长)5 / 10 秒
    audio(音轨)off / native
    aspect_ratio(画幅)16:9 / 9:16 / 1:1 / 4:3 / 3:4
    特色原生配音自动 1080p;元素 / 音色引用

    有声图生视频示例:

    cURL
    Python
    Node.js
    curl -X POST https://api-model.shuntianchuang.cn/v1/videos \
      -H "Authorization: Bearer sk-你的令牌" \
      -H "Content-Type: application/json" \
      -d '{
        "model": "kling-2.6",
        "prompt": "镜头缓缓推进,海浪拍打礁石",
        "resolution": "1080p",
        "image": "https://example.com/first-frame.jpg",
        "metadata": { "audio": "native" }
      }'

    kling-3.0

    旗舰画质:最高 4k、3 ~ 15 秒长时长、多镜头分镜,支持 original 保留参考素材原声。

    参数支持值
    resolution(分辨率)720p / 1080p / 4k
    duration(时长)3 ~ 15 秒
    audio(音轨)off / native / original
    aspect_ratio(画幅)16:9 / 9:16 / 1:1 / 4:3 / 3:4
    特色多镜头分镜;元素 / 音色引用

    多镜头分镜示例(customize 按脚本分镜,详见提交任务 · 多镜头分镜):

    cURL
    Python
    Node.js
    curl -X POST https://api-model.shuntianchuang.cn/v1/videos \
      -H "Authorization: Bearer sk-你的令牌" \
      -H "Content-Type: application/json" \
      -d '{
        "model": "kling-3.0",
        "prompt": "一只猫的一天",
        "metadata": {
          "multi_shot": true,
          "shot_type": "customize",
          "multi_prompt": [
            { "index": 1, "prompt": "清晨,猫在窗台伸懒腰", "duration": 3 },
            { "index": 2, "prompt": "午后,猫在草地上追蝴蝶", "duration": 4 }
          ]
        }
      }'

    kling-3.0-turbo

    v3 的快速档:同样支持 3 ~ 15 秒长时长,出片更快、价格更低。不支持音轨。

    参数支持值
    resolution(分辨率)720p / 1080p
    duration(时长)3 ~ 15 秒
    audio(音轨)不支持(传非 off 值返回 400)
    aspect_ratio(画幅)16:9 / 9:16 / 1:1 / 4:3 / 3:4
    特色长时长快速出片

    文生视频示例(缺省 720p / 5 秒 / 静音):

    cURL
    Python
    Node.js
    curl -X POST https://api-model.shuntianchuang.cn/v1/videos \
      -H "Authorization: Bearer sk-你的令牌" \
      -H "Content-Type: application/json" \
      -d '{
        "model": "kling-3.0-turbo",
        "prompt": "城市夜景延时摄影,车流光轨",
        "duration": 5
      }'

    kling-3.0-omni

    全能型:多镜头分镜、参考视频输入、4k、original 保留原声全部支持。

    参数支持值
    resolution(分辨率)720p / 1080p / 4k
    duration(时长)3 ~ 15 秒
    audio(音轨)off / native / original
    aspect_ratio(画幅)16:9 / 9:16 / 1:1 / 4:3 / 3:4
    特色分镜;参考视频(base_video 等);元素 / 音色引用

    参考视频示例(base_video 传源视频):

    cURL
    Python
    Node.js
    curl -X POST https://api-model.shuntianchuang.cn/v1/videos \
      -H "Authorization: Bearer sk-你的令牌" \
      -H "Content-Type: application/json" \
      -d '{
        "model": "kling-3.0-omni",
        "prompt": "把视频画面转换成赛博朋克风格,保持人物动作不变",
        "metadata": {
          "contents": [
            { "type": "base_video", "url": "https://example.com/source.mp4" }
          ]
        }
      }'

    kling-o1

    参考视频编辑:上传一段视频,按要求改写画面。无参考素材时只能 5 / 10 秒。

    参数支持值
    resolution(分辨率)720p / 1080p
    duration(时长)3 ~ 10 秒(无参考素材仅 5 / 10 秒)
    audio(音轨)off / original
    aspect_ratio(画幅)16:9 / 9:16 / 1:1 / 4:3 / 3:4
    特色参考视频编辑

    参考视频编辑示例:

    cURL
    Python
    Node.js
    curl -X POST https://api-model.shuntianchuang.cn/v1/videos \
      -H "Authorization: Bearer sk-你的令牌" \
      -H "Content-Type: application/json" \
      -d '{
        "model": "kling-o1",
        "prompt": "去掉背景里的路人,整体调成暖色调",
        "metadata": {
          "contents": [
            { "type": "base_video", "url": "https://example.com/source.mp4" }
          ]
        }
      }'

    kling-motion-3.0

    动作控制:一张形象图 + 一段动作参考视频,让图中人物按视频里的人物动作动起来。素材必须恰好一图一视频,动作视频须包含清晰的人物动作(人物过小、缺少上半身会被拒绝,任务失败并回显原因)。成片时长跟随动作视频,请求 duration 不生效。可引用 1 个元素。

    参数支持值
    resolution(分辨率)720p / 1080p
    duration(时长)3 ~ 15 秒(成片实际跟随动作视频)
    audio(音轨)off / original(original = 保留动作视频原声)
    aspect_ratio(画幅)16:9 / 9:16 / 1:1 / 4:3 / 3:4
    特色动作控制;character_orientation 必填;元素 ≤ 1

    动作控制示例:

    cURL
    Python
    Node.js
    curl -X POST https://api-model.shuntianchuang.cn/v1/videos \
      -H "Authorization: Bearer sk-你的令牌" \
      -H "Content-Type: application/json" \
      -d '{
        "model": "kling-motion-3.0",
        "metadata": {
          "character_orientation": "video",
          "audio": "original",
          "contents": [
            { "type": "image", "url": "https://example.com/character.webp" },
            { "type": "video", "url": "https://example.com/dance.mp4" },
            { "type": "prompt", "text": "跟随视频中的舞蹈动作" }
          ]
        }
      }'

    kling-motion-2.6

    动作控制的上一代:能力与 kling-motion-3.0 一致(恰好一图一视频、成片时长跟随动作视频),但不支持元素引用。

    参数支持值
    resolution(分辨率)720p / 1080p
    duration(时长)3 ~ 15 秒(成片实际跟随动作视频)
    audio(音轨)off / original(original = 保留动作视频原声)
    aspect_ratio(画幅)16:9 / 9:16 / 1:1 / 4:3 / 3:4
    特色动作控制;character_orientation 必填;不支持元素

    调用方式与 kling-motion-3.0 相同,把 model 换成 kling-motion-2.6 即可,示例见提交任务 · 动作控制。

    下一步