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 会失败 —— 选型见版本怎么选。
基本信息
| 项目 | 值 |
|---|---|
| ModelName | Kling |
| ModelVersion | 4.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 或 HDR | 4.0 | Flash 的 1080P 以上是超分出来的,4.0 才是原生直出;HDR 也只有 4.0 有 |
| 要精确控制画面落点(尾帧、中间关键帧) | 4.0 | Flash 只接受单张首帧 |
| 要参考视频 / 参考图 / 主体 / 音色做一致性生成 | 4.0-Omni | 主体与音色只有 Omni 支持 |
要参考素材但不需要主体与音色,且能接受原生 720P | 4.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.0 | Kling 3.0 |
|---|---|---|
| 定位 | 30 秒原生直出,大幅度动态,全能参考,精准叙事 | 音画同步,主体一致性增强,支持多镜头叙事 |
| 时长 | 3~30 秒 | 3~15 秒 |
| 动态范围 | SDR、10-bit HDR | SDR |
| 画幅比例 | 21:9 / 16:9 / 1:1 / 9:16 | 16:9 / 1:1 / 9:16 |
| 多关键帧(中间帧) | 支持 | 不支持(3.0 / 3.0-turbo / 3.0-Omni 都不支持) |
Flash 与 4.0 的差异
| 项目 | 4.0-Flash | 4.0 |
|---|---|---|
| 定位 | 高频创作:生成更快、单价更低 | 成片交付:画质与控制力优先 |
| 时长 | 3~20 秒 | 3~30 秒 |
| 分辨率 | 原生 720P;1080P / 2K / 4K 由超分补齐 | 720P / 1080P 原生直出;2K / 4K 超分 |
| 动态范围 | 8-bit SDR | SDR、10-bit HDR |
| 图生视频 | 仅单张首帧 | 首尾帧 + 中间帧(多关键帧) |
| 全能参考 | 支持(图 10 张、视频 5 段、合计 15 项) | 支持 |
能力与限制
| 模式 | 能力 | 4.0 | 4.0-Omni | 4.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 | 必填 | Integer | VOD 应用 ID |
ModelName | 必填 | String | 固定值 Kling |
ModelVersion | 必填 | String | 4.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 字段
| 字段 | 取值 | 说明 |
|---|---|---|
Category | Image / Video | 文件分类,需配合 Usage 使用 |
Usage | FirstFrame | 首帧 |
Usage | LastFrame | 首尾帧生视频的尾帧(4.0-Flash 不支持) |
Usage | Reference | 参考帧 / 参考素材 |
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)
{
"SubAppId": 123456789,
"ModelName": "Kling",
"ModelVersion": "4.0",
"Prompt": "generate a car",
"OutputConfig": {
"Resolution": "1080P",
"Duration": 10,
"AspectRatio": "16:9",
"StorageMode": "Temporary"
}
}图生视频:首帧 + 中间帧 + 尾帧(4.0)
{
"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)
{
"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 日后才能使用。
{
"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 引用。
{
"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。
{
"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 才有的能力。
{
"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 支持。
{
"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 读取,避免硬编码。
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:
{
"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 价格指南(客户)为准。