#可灵模型指南
可灵统一格式面向 15 个视频模型(kling-*),差异只在各模型的能力与参数取值。全部模型走相同的两个接口——提交任务 → 查询与下载。本页逐个介绍每个模型能做什么、支持哪些参数、怎么调用。
资产模型与路由按模型系列对应,资产 ID 不互通:
| 资产类型 | kling 系列(kling-* 模型) | kling-v 系列(kling-v-* 模型) |
|---|---|---|
| 元素 | kling-element | kling-v-element |
| 音色 | kling-voice | kling-v-voice |
详见元素与音色。
如果你使用的是 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.6 | kling-v-2.6 | 支持原生配音(audio = native) |
kling-3.0 | kling-v-3.0 | 旗舰:4k、3~15 秒、多镜头分镜 |
kling-3.0-turbo | kling-v-3.0-turbo | v3 快速档:出片更快、价格更低 |
kling-3.0-omni | kling-v-3.0-omni | 全能:分镜 + 参考视频 + 4k |
kling-o1 | kling-v-o1 | 参考视频编辑 |
kling-motion-3.0 | kling-v-motion-3.0 | 动作控制(可引用 1 个元素) |
kling-motion-2.6 | kling-v-motion-2.6 | 动作控制(不支持元素) |
元素 / 音色的创建与引用见元素与音色。
#能力与参数总览
各模型支持的档位集合(越界提交返回 400 并提示合法值):
| 模型(成对) | 分辨率 | 时长(秒) | audio 合法值 | 界限备注 |
|---|---|---|---|---|
kling-2.5-turbo | 720p / 1080p | 5 / 10 | 不支持(传非 off 值 → 400) | 首尾帧任务自动按 1080p 生成 |
kling-2.6 / kling-v-2.6 | 720p / 1080p | 5 / 10 | off / native | audio=native 自动按 1080p 生成 |
kling-3.0 / kling-v-3.0 | 720p / 1080p / 4k | 3 ~ 15 | off / native / original | 支持多镜头分镜;kling-v-3.0 传 original 返回 400 |
kling-3.0-turbo / kling-v-3.0-turbo | 720p / 1080p | 3 ~ 15 | 不支持(传非 off 值 → 400) | — |
kling-3.0-omni / kling-v-3.0-omni | 720p / 1080p / 4k | 3 ~ 15 | off / native / original | 多镜头分镜 + 参考视频 |
kling-o1 / kling-v-o1 | 720p / 1080p | 3 ~ 10(无参考素材仅 5 / 10) | off / original | 参考视频编辑 |
kling-motion-3.0 / kling-v-motion-3.0 | 720p / 1080p | 3 ~ 15 | off / original | 素材恰好一图一视频;元素 ≤ 1 |
kling-motion-2.6 / kling-v-motion-2.6 | 720p / 1080p | 3 ~ 15 | off / original | 素材恰好一图一视频;不支持元素 |
audio 说明:off 静音(缺省,最低价档)/ native 生成配音 / original 保留原声。不传即静音,想要声音必须显式传。
素材通道(metadata.contents)的适用范围:
| type | 携带键 | 用途 | 适用范围 |
|---|---|---|---|
prompt | text | 提示词素材项,可与顶层 prompt 并用 | 全部模型 |
first_frame | url | 首帧图 | 图生 / 全能系 |
last_frame | url | 尾帧图,必须与首帧同时提供;v2.5 / v2.6 系尾帧任务自动按 1080p 生成 | 图生 / 全能系 |
refer_image | url | 参考图(主体参考) | 图生 / 全能系 |
base_video | url | 参考视频 | 仅全能系(kling-3.0-omni 系 / kling-o1 系) |
feature_video | url | 参考视频(特征) | 仅全能系 |
video | url | 参考视频旧写法,等同 base_video | 仅全能系 |
image | url | 形象参考图 | 仅动作控制模型 |
element | id(可带 name;动作控制任务另带 element_id) | 引用已创建的元素 | 普通任务 ≤ 3 个;动作控制仅 kling-motion-3.0 且 ≤ 1 |
voice | id | 引用已创建的音色 | ≤ 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 -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"
}'import requests
resp = requests.post(
"https://api-model.shuntianchuang.cn/v1/videos",
headers={
"Authorization": "Bearer sk-你的令牌",
"Content-Type": "application/json",
},
json={
"model": "kling-2.5-turbo",
"prompt": "镜头缓缓推进,猫转头看向镜头",
"resolution": "1080p",
"image": "https://example.com/first-frame.jpg",
},
)
task = resp.json()
print(task["id"]) # 用它去查询接口轮询取片const resp = await fetch('https://api-model.shuntianchuang.cn/v1/videos', {
method: 'POST',
headers: {
Authorization: 'Bearer sk-你的令牌',
'Content-Type': 'application/json',
},
body: JSON.stringify({
model: 'kling-2.5-turbo',
prompt: '镜头缓缓推进,猫转头看向镜头',
resolution: '1080p',
image: 'https://example.com/first-frame.jpg',
}),
});
const task = await resp.json();
console.log(task.id); // 用它去查询接口轮询取片#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 -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" }
}'import requests
resp = requests.post(
"https://api-model.shuntianchuang.cn/v1/videos",
headers={
"Authorization": "Bearer sk-你的令牌",
"Content-Type": "application/json",
},
json={
"model": "kling-2.6",
"prompt": "镜头缓缓推进,海浪拍打礁石",
"resolution": "1080p",
"image": "https://example.com/first-frame.jpg",
"metadata": {"audio": "native"},
},
)
task = resp.json()
print(task["id"])const resp = await fetch('https://api-model.shuntianchuang.cn/v1/videos', {
method: 'POST',
headers: {
Authorization: 'Bearer sk-你的令牌',
'Content-Type': 'application/json',
},
body: JSON.stringify({
model: 'kling-2.6',
prompt: '镜头缓缓推进,海浪拍打礁石',
resolution: '1080p',
image: 'https://example.com/first-frame.jpg',
metadata: { audio: 'native' },
}),
});
const task = await resp.json();
console.log(task.id);#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 -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 }
]
}
}'import requests
resp = requests.post(
"https://api-model.shuntianchuang.cn/v1/videos",
headers={
"Authorization": "Bearer sk-你的令牌",
"Content-Type": "application/json",
},
json={
"model": "kling-3.0",
"prompt": "一只猫的一天",
"metadata": {
"multi_shot": True,
"shot_type": "customize",
"multi_prompt": [
{"index": 1, "prompt": "清晨,猫在窗台伸懒腰", "duration": 3},
{"index": 2, "prompt": "午后,猫在草地上追蝴蝶", "duration": 4},
],
},
},
)
task = resp.json()
print(task["id"])const resp = await fetch('https://api-model.shuntianchuang.cn/v1/videos', {
method: 'POST',
headers: {
Authorization: 'Bearer sk-你的令牌',
'Content-Type': 'application/json',
},
body: JSON.stringify({
model: 'kling-3.0',
prompt: '一只猫的一天',
metadata: {
multi_shot: true,
shot_type: 'customize',
multi_prompt: [
{ index: 1, prompt: '清晨,猫在窗台伸懒腰', duration: 3 },
{ index: 2, prompt: '午后,猫在草地上追蝴蝶', duration: 4 },
],
},
}),
});
const task = await resp.json();
console.log(task.id);#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 -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
}'import requests
resp = requests.post(
"https://api-model.shuntianchuang.cn/v1/videos",
headers={
"Authorization": "Bearer sk-你的令牌",
"Content-Type": "application/json",
},
json={
"model": "kling-3.0-turbo",
"prompt": "城市夜景延时摄影,车流光轨",
"duration": 5,
},
)
task = resp.json()
print(task["id"])const resp = await fetch('https://api-model.shuntianchuang.cn/v1/videos', {
method: 'POST',
headers: {
Authorization: 'Bearer sk-你的令牌',
'Content-Type': 'application/json',
},
body: JSON.stringify({
model: 'kling-3.0-turbo',
prompt: '城市夜景延时摄影,车流光轨',
duration: 5,
}),
});
const task = await resp.json();
console.log(task.id);#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 -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" }
]
}
}'import requests
resp = requests.post(
"https://api-model.shuntianchuang.cn/v1/videos",
headers={
"Authorization": "Bearer sk-你的令牌",
"Content-Type": "application/json",
},
json={
"model": "kling-3.0-omni",
"prompt": "把视频画面转换成赛博朋克风格,保持人物动作不变",
"metadata": {
"contents": [
{"type": "base_video", "url": "https://example.com/source.mp4"}
]
},
},
)
task = resp.json()
print(task["id"])const resp = await fetch('https://api-model.shuntianchuang.cn/v1/videos', {
method: 'POST',
headers: {
Authorization: 'Bearer sk-你的令牌',
'Content-Type': 'application/json',
},
body: JSON.stringify({
model: 'kling-3.0-omni',
prompt: '把视频画面转换成赛博朋克风格,保持人物动作不变',
metadata: {
contents: [{ type: 'base_video', url: 'https://example.com/source.mp4' }],
},
}),
});
const task = await resp.json();
console.log(task.id);#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 -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" }
]
}
}'import requests
resp = requests.post(
"https://api-model.shuntianchuang.cn/v1/videos",
headers={
"Authorization": "Bearer sk-你的令牌",
"Content-Type": "application/json",
},
json={
"model": "kling-o1",
"prompt": "去掉背景里的路人,整体调成暖色调",
"metadata": {
"contents": [
{"type": "base_video", "url": "https://example.com/source.mp4"}
]
},
},
)
task = resp.json()
print(task["id"])const resp = await fetch('https://api-model.shuntianchuang.cn/v1/videos', {
method: 'POST',
headers: {
Authorization: 'Bearer sk-你的令牌',
'Content-Type': 'application/json',
},
body: JSON.stringify({
model: 'kling-o1',
prompt: '去掉背景里的路人,整体调成暖色调',
metadata: {
contents: [{ type: 'base_video', url: 'https://example.com/source.mp4' }],
},
}),
});
const task = await resp.json();
console.log(task.id);#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 -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": "跟随视频中的舞蹈动作" }
]
}
}'import requests
resp = requests.post(
"https://api-model.shuntianchuang.cn/v1/videos",
headers={
"Authorization": "Bearer sk-你的令牌",
"Content-Type": "application/json",
},
json={
"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": "跟随视频中的舞蹈动作"},
],
},
},
)
task = resp.json()
print(task["id"])const resp = await fetch('https://api-model.shuntianchuang.cn/v1/videos', {
method: 'POST',
headers: {
Authorization: 'Bearer sk-你的令牌',
'Content-Type': 'application/json',
},
body: JSON.stringify({
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: '跟随视频中的舞蹈动作' },
],
},
}),
});
const task = await resp.json();
console.log(task.id);#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 即可,示例见提交任务 · 动作控制。
