跳到内容

Kling 4 ​

更新时间

← 返回 Kling,查看全部版本与扩展能力。

Endpoint: POST https://vod.intl.tencentcloudapi.comAction: CreateAigcVideoTask国际站 API 文档: CreateAigcVideoTask

Kling 4 包含三个版本:4.0(基础旗舰版,文生 / 图生视频)、4.0-Omni(全模态全能版,另支持全能参考生视频)与 4.0-Flash(高频创作版,生成更快、单价更低)。相比 3.0 系列,4.0 / 4.0-Omni 单条视频可原生直出 3~30 秒,支持首尾帧 + 中间帧(多关键帧)、单镜头 / 多镜头生成与音画同出。

上线时间

4.0 与 4.0-Omni 现已可调用,4.0-Omni 的**主体(SubjectInfos)**相关功能已于 2026-10-24 开放。 4.0-Flash 于 2026-11-05 上新。

Flash 不是「更便宜的 4.0」,能力有明确裁剪

4.0-Flash 支持文生视频、图生视频与全能参考生视频,参考素材配额与 4.0 相同(图 10 张、视频 5 段、单任务合计 15 项)。但有两项硬限制:时长上限 20 秒(4.0 为 30 秒)、不支持尾帧与中间帧(图生视频只接受单张首帧)。另外它原生只到 720P,1080P 及以上由超分补齐(4.0 的 1080P 是原生直出)。

把 4.0 的首尾帧 / 中间帧示例直接换上 4.0-Flash 会失败 —— 选型见版本怎么选。

基本信息 ​

项目值
ModelNameKling
ModelVersion4.0(文生、图生)/ 4.0-Omni(全能参考生视频)/ 4.0-Flash(高频创作,文生、图生、全能参考生)
分辨率4.0 / 4.0-Omni:720P / 1080P / 2K(超分)/ 4K(超分)
4.0-Flash:720P / 1080P(超分)/ 2K(超分)/ 4K(超分)——原生只到 720P
比例21:9 / 16:9 / 9:16 / 1:1
时长4.0 / 4.0-Omni:3~30 秒(默认 10 秒)
4.0-Flash:3~20 秒
输出声音支持(音画同出)
价格参考 AIGC 价格指南(客户)

版本怎么选 ​

你的场景选理由
批量试提示词、刷草稿、看构图与节奏对不对4.0-Flash生成最快、单价最低,原生 720P 看镜头语言已经够用
要交付成片,需要原生 1080P 或 HDR4.0Flash 的 1080P 以上是超分出来的,4.0 才是原生直出;HDR 也只有 4.0 有
要精确控制画面落点(尾帧、中间关键帧)4.0Flash 只接受单张首帧
要参考视频 / 参考图 / 主体 / 音色做一致性生成4.0-Omni主体与音色只有 Omni 支持
要参考素材但不需要主体与音色,且能接受原生 720P4.0-Flash参考图 / 参考视频配额与 4.0 相同

常见用法是两段式:先用 4.0-Flash 把同一镜头跑几个变体挑出最好的提示词,再用 4.0 / 4.0-Omni 重跑成片。

版本对比 ​

版本支持能力核心特征最大参考图音频时长
4.0-Omni文生、图生、首尾帧、中间帧、全能参考生(参考视频 / 参考图 / 主体 / 音色)全模态全能版,最多 10 张参考图与 5 段参考视频10 张原声 / 配音 / 音效3~30 秒
4.0文生、图生、首尾帧、中间帧基础旗舰版,画质稳定,日常商用首选10 张支持3~30 秒
4.0-Flash文生、图生(仅首帧)、全能参考生高频创作版,生成更快、单价更低;原生 720P、无尾帧与中间帧10 张支持3~20 秒
3.0-Omni(对照)文生、图生、参考生上一代全能版8 张原声 / 配音 / 音效3~15 秒

与 Kling 3.0 的差异 ​

项目Kling 4.0Kling 3.0
定位30 秒原生直出,大幅度动态,全能参考,精准叙事音画同步,主体一致性增强,支持多镜头叙事
时长3~30 秒3~15 秒
动态范围SDR、10-bit HDRSDR
画幅比例21:9 / 16:9 / 1:1 / 9:1616:9 / 1:1 / 9:16
多关键帧(中间帧)支持不支持(3.0 / 3.0-turbo / 3.0-Omni 都不支持)

Flash 与 4.0 的差异 ​

项目4.0-Flash4.0
定位高频创作:生成更快、单价更低成片交付:画质与控制力优先
时长3~20 秒3~30 秒
分辨率原生 720P;1080P / 2K / 4K 由超分补齐720P / 1080P 原生直出;2K / 4K 超分
动态范围8-bit SDRSDR、10-bit HDR
图生视频仅单张首帧首尾帧 + 中间帧(多关键帧)
全能参考支持(图 10 张、视频 5 段、合计 15 项)支持

能力与限制 ​

模式能力4.04.0-Omni4.0-Flash限制说明
文生视频单镜头 / 多镜头、音画同出✅✅✅—
图生视频首帧✅✅✅—
图生视频尾帧(首尾帧)✅✅❌Flash 只接受单张首帧
图生视频多关键帧(中间帧)✅✅❌Flash 不支持中间帧
图生视频音色参考❌✅❌要用音色须走 4.0-Omni 全能参考
全能参考视频参考—✅✅最多 5 个视频,素材总时长不超过 30 秒
全能参考图片参考—✅✅最多 10 张
全能参考主体管理—✅—主体最多 7 个,其中来自参考视频的最多 3 个
全能参考音色参考—✅—可给主体绑定音色,也可直接用已创建的音色
全能参考组合参考总数———图片、视频、主体、音色合计不超过 15 个
输出1080P 原生直出✅✅❌Flash 原生只到 720P(8-bit SDR),1080P 及以上走超分

Flash 的参考配额取自可灵官方 API 更新记录(2026-11-04);官方《Kling 4.0 用户指南》1.3 节只列出「文生 / 图生 / 全能参考 + 3~20 秒 + 720P + 8-bit SDR」六项,未单独声明配额。以实际联调为准。

请求参数 ​

参数必填类型说明
SubAppId必填IntegerVOD 应用 ID
ModelName必填String固定值 Kling
ModelVersion必填String4.0 / 4.0-Omni / 4.0-Flash
Prompt必填String生成提示词。引用素材用 @image_N / @video_N / @element_N / @voice_N
FileInfos.N可选Array参考帧、参考图、参考视频等资源文件,字段见下表
SubjectInfos.N可选Array主体输入(仅 4.0-Omni)。Id 必填(固定主体 ID),Name 可选
OutputConfig可选Object分辨率、比例、时长、声音、存储方式等输出配置。4.0-Flash 的 Duration 不超过 20;Resolution 可传 720P / 1080P / 2K / 4K,但只有 720P 是原生
ExtInfo可选String扩展参数(JSON 字符串,需转义),如音色列表 voice_list(仅 4.0-Omni)

FileInfos 字段 ​

字段取值说明
CategoryImage / Video文件分类,需配合 Usage 使用
UsageFirstFrame首帧
UsageLastFrame首尾帧生视频的尾帧(4.0-Flash 不支持)
UsageReference参考帧 / 参考素材
ReferenceType(Category=Image)middle_image中间帧图素材,Usage 须为 Reference(4.0-Flash 不支持)
ReferenceType(Category=Image)refer_image元素参考图素材,Usage 须为 Reference
ReferenceType(Category=Video)feature / feature_video特征参考视频
ReferenceType(Category=Video)base / base_video待编辑视频

中间帧图素材的标识是 middle_image(不是 middle_frame),需配合 Usage: Reference 一起传,写法见下方示例。

请求示例 ​

文生视频(4.0) ​

json
{
  "SubAppId": 123456789,
  "ModelName": "Kling",
  "ModelVersion": "4.0",
  "Prompt": "generate a car",
  "OutputConfig": {
    "Resolution": "1080P",
    "Duration": 10,
    "AspectRatio": "16:9",
    "StorageMode": "Temporary"
  }
}

图生视频:首帧 + 中间帧 + 尾帧(4.0) ​

json
{
  "SubAppId": 123456789,
  "ModelName": "Kling",
  "ModelVersion": "4.0",
  "FileInfos": [
    {
      "Type": "Url",
      "Category": "Image",
      "Url": "https://<cdn>/a.png",
      "Usage": "FirstFrame"
    },
    {
      "Type": "Url",
      "Category": "Image",
      "Url": "https://<cdn>/c.png",
      "ReferenceType": "middle_image",
      "Usage": "Reference"
    },
    {
      "Type": "Url",
      "Category": "Image",
      "Url": "https://<cdn>/b.png",
      "Usage": "LastFrame"
    }
  ],
  "Prompt": "generate a car"
}

全能参考:参考图 + 特征参考视频(4.0-Omni) ​

json
{
  "SubAppId": 123456789,
  "ModelName": "Kling",
  "ModelVersion": "4.0-Omni",
  "FileInfos": [
    {
      "Type": "Url",
      "Category": "Image",
      "Url": "https://<cdn>/a.jpeg",
      "ReferenceType": "refer_image",
      "Usage": "Reference"
    },
    {
      "Type": "Url",
      "Category": "Video",
      "Url": "https://<cdn>/a.mp4",
      "ReferenceType": "feature_video",
      "Usage": "Reference"
    }
  ],
  "Prompt": "参考 @image_1 的服饰,吸收 @video_1 的运动节奏,写实。"
}

视频编辑 + 主体(4.0-Omni) ​

主体功能需 10 月 24 日后才能使用。

json
{
  "SubAppId": 123456789,
  "ModelName": "Kling",
  "ModelVersion": "4.0-Omni",
  "FileInfos": [
    {
      "Type": "Url",
      "Category": "Video",
      "Url": "https://<cdn>/a.mp4",
      "ReferenceType": "base_video",
      "Usage": "Reference"
    }
  ],
  "SubjectInfos": [
    {
      "Id": "324698887867107"
    }
  ],
  "Prompt": "在 @video_1 上继续往后演,@element_1 走进画面"
}

音色引入(4.0-Omni) ​

在 ExtInfo 中通过 voice_list 指定音色,提示词中以 @voice_N 引用。

json
{
  "SubAppId": 123456789,
  "ModelName": "Kling",
  "ModelVersion": "4.0-Omni",
  "FileInfos": [
    {
      "Type": "Url",
      "Category": "Image",
      "Url": "https://<cdn>/a.png",
      "ReferenceType": "refer_image",
      "Usage": "Reference"
    }
  ],
  "Prompt": "生成一个人使用音色 @voice_1 说你好",
  "ExtInfo": "{\"AdditionalParameters\":\"{\\\"voice_list\\\": [{\\\"voice_id\\\": 942193199232594917}]}\"}"
}

voice_id 需先创建:参见 VOD 创建自定义音色(CreateAigcCustomVoice)。

文生视频(4.0-Flash) ​

Duration 不超过 20。Resolution 可传 1080P 及以上,但 Flash 原生只到 720P,更高分辨率由超分补齐 —— 对画质敏感的成片建议用 4.0。

json
{
  "SubAppId": 123456789,
  "ModelName": "Kling",
  "ModelVersion": "4.0-Flash",
  "Prompt": "generate a car",
  "OutputConfig": {
    "Resolution": "720P",
    "Duration": 10,
    "AspectRatio": "16:9",
    "StorageMode": "Temporary"
  }
}

图生视频:单张首帧(4.0-Flash) ​

Flash 只接受单张首帧。不要再传 Usage: LastFrame 或 ReferenceType: middle_image —— 那是 4.0 / 4.0-Omni 才有的能力。

json
{
  "SubAppId": 123456789,
  "ModelName": "Kling",
  "ModelVersion": "4.0-Flash",
  "FileInfos": [
    {
      "Type": "Url",
      "Category": "Image",
      "Url": "https://<cdn>/first.png",
      "Usage": "FirstFrame"
    }
  ],
  "Prompt": "the car drives away slowly, cinematic",
  "OutputConfig": {
    "Resolution": "720P",
    "Duration": 10,
    "StorageMode": "Temporary"
  }
}

全能参考:参考图 + 特征参考视频(4.0-Flash) ​

参考素材配额与 4.0 相同(图 10 张、视频 5 段、单任务合计 15 项),但主体(SubjectInfos)与音色(voice_list)仍只有 4.0-Omni 支持。

json
{
  "SubAppId": 123456789,
  "ModelName": "Kling",
  "ModelVersion": "4.0-Flash",
  "FileInfos": [
    {
      "Type": "Url",
      "Category": "Image",
      "Url": "https://<cdn>/a.jpeg",
      "ReferenceType": "refer_image",
      "Usage": "Reference"
    },
    {
      "Type": "Url",
      "Category": "Video",
      "Url": "https://<cdn>/a.mp4",
      "ReferenceType": "feature_video",
      "Usage": "Reference"
    }
  ],
  "Prompt": "参考 @image_1 的服饰,吸收 @video_1 的运动节奏,写实。",
  "OutputConfig": {
    "Resolution": "720P",
    "Duration": 10,
    "StorageMode": "Temporary"
  }
}

代码参考(Python) ​

按需替换模型版本和参数。密钥从环境变量 TENCENTCLOUD_SECRET_ID / TENCENTCLOUD_SECRET_KEY 读取,避免硬编码。

python
import os
import json
from tencentcloud.common import credential
from tencentcloud.common.profile.client_profile import ClientProfile
from tencentcloud.common.profile.http_profile import HttpProfile
from tencentcloud.common.exception.tencent_cloud_sdk_exception import TencentCloudSDKException
from tencentcloud.vod.v20180717 import vod_client, models

try:
    cred = credential.Credential(os.getenv("TENCENTCLOUD_SECRET_ID"), os.getenv("TENCENTCLOUD_SECRET_KEY"))
    http_profile = HttpProfile()
    http_profile.endpoint = "vod.intl.tencentcloudapi.com"
    client_profile = ClientProfile()
    client_profile.httpProfile = http_profile
    client = vod_client.VodClient(cred, "", client_profile)

    req = models.CreateAigcVideoTaskRequest()
    params = {
        "SubAppId": 123456789,
        "ModelName": "Kling",
        "ModelVersion": "4.0",
        "FileInfos": [
            {
                "Type": "Url",
                "Category": "Image",
                "Url": "https://<cdn>/first.png",
                "Usage": "FirstFrame"
            }
        ],
        "Prompt": "generate a car",
        "OutputConfig": {
            "StorageMode": "Permanent",
            "MediaName": "kling-4-video"
        }
    }
    req.from_json_string(json.dumps(params))
    resp = client.CreateAigcVideoTask(req)
    print(resp.to_json_string())
except TencentCloudSDKException as err:
    print(err)

响应与结果查询 ​

生成请求返回 TaskId:

json
{
  "Response": {
    "RequestId": "<request-id>",
    "TaskId": "<task-id>"
  }
}

用 DescribeTaskDetail 轮询任务;AigcVideoTask.Status=FINISH 且 ErrCode=0 表示生成成功,视频地址位于 AigcVideoTask.Output.FileInfos.FileUrl。

提示词引用写法

Kling 4 的接入示例用 @image_1 / @video_1 / @element_1 / @voice_1 引用素材;Kling 3.0 系列页面中的示例使用 <<<image_1>>> 写法。

带输入视频时的计费口径

Kling 4 系列按总时长计费,输入视频(参考视频、待编辑视频、视频主体)也计入时长:

  • 输入视频比输出长:按「输入秒数 + 输出秒数」计费。
  • 输入视频与输出等长或更短:按「输出秒数 × 2」计费。

所以用参考视频时,实际费用不等于输出时长 × 单价。具体单价以 AIGC 价格指南(客户)为准。

基于 VitePress 构建 · 部署于腾讯云 EdgeOne Pages