跳转到主要内容
POST
/
v1
/
tasks
Kling 系列
curl --request POST \
  --url https://www.qingbo.dev/v1/tasks \
  --header 'Content-Type: application/json' \
  --data '
{
  "model": "<string>",
  "prompt": "<string>",
  "resolution": "<string>",
  "duration": 123,
  "aspect_ratio": "<string>",
  "image_urls": [
    "<string>"
  ],
  "video_urls": [
    "<string>"
  ],
  "seed": 123,
  "callback_url": "<string>",
  "callback_events": [
    "<string>"
  ]
}
'
import requests

url = "https://www.qingbo.dev/v1/tasks"

payload = {
"model": "<string>",
"prompt": "<string>",
"resolution": "<string>",
"duration": 123,
"aspect_ratio": "<string>",
"image_urls": ["<string>"],
"video_urls": ["<string>"],
"seed": 123,
"callback_url": "<string>",
"callback_events": ["<string>"]
}
headers = {"Content-Type": "application/json"}

response = requests.post(url, json=payload, headers=headers)

print(response.text)
const options = {
method: 'POST',
headers: {'Content-Type': 'application/json'},
body: JSON.stringify({
model: '<string>',
prompt: '<string>',
resolution: '<string>',
duration: 123,
aspect_ratio: '<string>',
image_urls: ['<string>'],
video_urls: ['<string>'],
seed: 123,
callback_url: '<string>',
callback_events: ['<string>']
})
};

fetch('https://www.qingbo.dev/v1/tasks', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));
package main

import (
"fmt"
"strings"
"net/http"
"io"
)

func main() {

url := "https://www.qingbo.dev/v1/tasks"

payload := strings.NewReader("{\n \"model\": \"<string>\",\n \"prompt\": \"<string>\",\n \"resolution\": \"<string>\",\n \"duration\": 123,\n \"aspect_ratio\": \"<string>\",\n \"image_urls\": [\n \"<string>\"\n ],\n \"video_urls\": [\n \"<string>\"\n ],\n \"seed\": 123,\n \"callback_url\": \"<string>\",\n \"callback_events\": [\n \"<string>\"\n ]\n}")

req, _ := http.NewRequest("POST", url, payload)

req.Header.Add("Content-Type", "application/json")

res, _ := http.DefaultClient.Do(req)

defer res.Body.Close()
body, _ := io.ReadAll(res.Body)

fmt.Println(string(body))

}
HttpResponse<String> response = Unirest.post("https://www.qingbo.dev/v1/tasks")
.header("Content-Type", "application/json")
.body("{\n \"model\": \"<string>\",\n \"prompt\": \"<string>\",\n \"resolution\": \"<string>\",\n \"duration\": 123,\n \"aspect_ratio\": \"<string>\",\n \"image_urls\": [\n \"<string>\"\n ],\n \"video_urls\": [\n \"<string>\"\n ],\n \"seed\": 123,\n \"callback_url\": \"<string>\",\n \"callback_events\": [\n \"<string>\"\n ]\n}")
.asString();
{
  "task_id": "task-wave1775285160b950328499",
  "model": "kling-v3",
  "action": "generate",
  "status": "queued",
  "created_at": 1775285160040,
  "progress": 0
}
快手可灵 Kling 视频生成系列,7 个模型分四类:
  • kling-v3 — 新一代基础模型,质量档 720P / 1080P / 4K,原生支持有声视频(generate_audio)
  • kling-v3-omni — v3 系列统一多模态接口,文生 / 图生 / 视频参考全走同一 endpoint,prompt 支持 <<<image_N>>> 引用语法,支持有声与视频参考
  • kling-v2-6 — 经典稳定版,720P / 1080P,1080P 可有声,语义与动态稳定性打磨
  • kling-video-o1 — 推理增强视频模型,生成前对提示词与参考素材深度规划,物理一致性、复杂运动表现最优,支持视频参考
  • kling-3.0-turbo — 极速档,普通分辨率 720P / 1080P,生成最快、单价最低,适合预览 / 批量
  • kling-v3-motion-control / kling-v2-6-motion-control运动控制:用一张参考图(角色)+ 一段参考视频(运动),让参考角色复刻参考视频的动作

质量档用 resolution 表达

kling v3 家族(v3 / v3-omni / video-o1)的价格按质量模式分档,我们对外统一用 resolution 字段表达档位,网关内部映射到 kling 的 mode 参数:
resolution 取值质量模式网关内部 mode
720P标准模式std
1080P专业模式pro
4K4K 模式(仅 v3 / omni)4k
kling-3.0-turbo 与两个 *-motion-control普通分辨率含义(720P / 1080P),不涉及质量档映射。 质量档 × 时长 计费,单位 $/秒:实际计费 = 该档每秒单价 × duration

定价

各档为每秒单价(USD 售价)。开启有声(generate_audio:true)或挂视频参考(video_urls)会切换到对应高档单价。

kling-v3 / kling-v3-omni / kling-video-o1

模型720P1080P4K
kling-v3$0.0756 / 秒$0.1008 / 秒$0.48213 / 秒
kling-v3-omni$0.0756 / 秒$0.1008 / 秒$0.48213 / 秒
kling-video-o1$0.0756 / 秒$0.1008 / 秒
有声加价(generate_audio:true,仅 v3 / omni):
模型720P 有声1080P 有声4K 有声
kling-v3$0.1134 / 秒$0.1512 / 秒$0.48213 / 秒(同基价)
kling-v3-omni$0.1008 / 秒$0.126 / 秒$0.48213 / 秒(同基价)
视频参考加价(挂 video_urls,仅 omni / o1):
模型720P 视频参考1080P 视频参考
kling-v3-omni$0.1134 / 秒$0.1512 / 秒
kling-video-o1$0.1134 / 秒$0.1512 / 秒

kling-v2-6 / kling-3.0-turbo

模型720P1080P备注
kling-v2-6$0.0414 / 秒$0.070313 / 秒1080P 有声(generate_audio:true)$0.140625 / 秒;720P 不支持有声
kling-3.0-turbo$0.1287 / 秒$0.1611 / 秒极速档,无有声 / 视频参考

运动控制(kling-v3-motion-control / kling-v2-6-motion-control)

模型720P1080P
kling-v3-motion-control$0.11574 / 秒$0.15426 / 秒
kling-v2-6-motion-control$0.06426 / 秒$0.10287 / 秒
单价为每秒;实际计费 = 该档每秒单价 × duration。开启 generate_audio 或挂 video_urls 视频参考会切换到对应高档单价;4K 有声与 4K 基价同价。

调用示例

curl -X POST https://www.qingbo.dev/v1/tasks \
  -H "Authorization: Bearer $WAVE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "kling-v3",
    "prompt": "一只柴犬穿宇航服在月球上行走,电影感光影",
    "duration": 5,
    "resolution": "1080P",
    "aspect_ratio": "16:9",
    "generate_audio": true
  }'
curl -X POST https://www.qingbo.dev/v1/tasks \
  -H "Authorization: Bearer $WAVE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "kling-v2-6",
    "prompt": "人物缓缓走向镜头,微风吹动头发",
    "image_urls": ["https://cdn.example.com/portrait.jpg"],
    "duration": 5,
    "resolution": "1080P"
  }'
curl -X POST https://www.qingbo.dev/v1/tasks \
  -H "Authorization: Bearer $WAVE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "kling-v3",
    "prompt": "航拍雪山日出,云海翻涌,壮阔史诗感",
    "duration": 5,
    "resolution": "4K",
    "aspect_ratio": "16:9"
  }'
curl -X POST https://www.qingbo.dev/v1/tasks \
  -H "Authorization: Bearer $WAVE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "kling-v3-omni",
    "prompt": "把 <<<image_1>>> 中的角色放到 <<<image_2>>> 的森林场景里奔跑",
    "image_urls": [
      "https://cdn.example.com/char.jpg",
      "https://cdn.example.com/forest.jpg"
    ],
    "duration": 5,
    "resolution": "1080P",
    "aspect_ratio": "16:9"
  }'
curl -X POST https://www.qingbo.dev/v1/tasks \
  -H "Authorization: Bearer $WAVE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "kling-video-o1",
    "prompt": "保持 <<<image_1>>> 角色形象,沿用参考视频的镜头运动",
    "image_urls": ["https://cdn.example.com/char.jpg"],
    "video_urls": ["https://cdn.example.com/ref.mp4"],
    "duration": 10,
    "resolution": "1080P"
  }'
curl -X POST https://www.qingbo.dev/v1/tasks \
  -H "Authorization: Bearer $WAVE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "kling-v3-motion-control",
    "prompt": "保持角色一致,跟随参考视频做转身挥手动作,电影感光影",
    "image_urls": ["https://cdn.example.com/character.jpg"],
    "video_urls": ["https://cdn.example.com/ref-motion.mp4"],
    "duration": 5,
    "resolution": "1080P"
  }'
{
  "task_id": "task-wave1775285160b950328499",
  "model": "kling-v3",
  "action": "generate",
  "status": "queued",
  "created_at": 1775285160040,
  "progress": 0
}
提交后用 GET /v1/tasks/{task_id} 轮询状态,详见 任务系统

可用模型

模型 ID分辨率 / 质量档时长有声视频参考特色
kling-v3720P / 1080P / 4K5 / 10 秒generate_audio新一代基础模型,4K + 原生有声
kling-v3-omni720P / 1080P / 4K5 / 10 秒generate_audiovideo_urls统一多模态 endpoint
kling-v2-6720P / 1080P5 / 10 秒✅ 仅 1080P经典稳定版
kling-video-o1720P / 1080P5 / 10 秒video_urls推理增强,物理一致性最优
kling-3.0-turbo720P / 1080P5 / 10 秒极速档,生成最快、单价最低
kling-v3-motion-control720P / 1080P5 / 10 秒必填(运动源)运动控制(v3)
kling-v2-6-motion-control720P / 1080P5 / 10 秒必填(运动源)运动控制(v2.6)
所有模型均支持 generate action;model ID 即上表取值。

通用参数

model
string
必填
模型 ID,见 可用模型
prompt
string
必填
视频描述文本。Omni / O1 中可用 <<<image_N>>> 语法引用 image_urls 第 N 张图(N 从 1 开始);运动控制档建议描述动作 / 镜头 / 风格
resolution
string
默认值:"720P"
输出分辨率 / 质量档。各模型支持范围见 可用模型:
  • 720P — v3 家族映射到标准模式(std)
  • 1080P — v3 家族映射到专业模式(pro)
  • 4K — v3 家族映射到 4K 模式(仅 kling-v3 / kling-v3-omni)
duration
integer
默认值:"5"
视频时长(秒)。取值 510
aspect_ratio
string
默认值:"16:9"
画面宽高比,仅文生(T2V)生效;图 / 视频参考模式跟随源素材比例。可选值:
  • 16:9 — 横版宽屏
  • 9:16 — 竖版长屏
  • 1:1 — 正方形
image_urls
string[]
参考图片 URL 数组:
  • 图生 / 首尾帧(v3 / v2.6 / o1 / 3.0-turbo):传 1 张作首帧;v3 / omni / o1 传 2 张自动作首帧 + 尾帧
  • 多模态参考(omni / o1):多张图,可被 <<<image_N>>> 引用
  • 运动控制(两个 *-motion-control):必填,1 张作角色参考图
video_urls
string[]
参考视频 URL 数组(单元素):
  • 视频参考(omni / o1):一段参考视频,沿用其镜头 / 运动特征
  • 运动控制(两个 *-motion-control):必填,运动来源视频,让参考角色复刻其动作
seed
integer
随机种子,固定可复现结果
callback_url
string
Webhook 回调地址,任务终态时调用。详见 回调机制
callback_events
string[]
需要推送的事件类型,默认终态全推

模型特定参数

generate_audio
boolean
默认值:"false"
是否生成有声视频。各质量档均支持原生有声;开启后切换到对应「有声」单价(见 定价)

特殊语法说明

<<<image_N>>> 提示词图片引用(Omni / O1 适用) prompt 中用 <<<image_N>>> 占位符显式引用 image_urls 数组中的第 N 张图(N 从 1 开始)。模型会把占位符替换为对应图像内容,用于:
  • 角色一致性 — <<<image_1>>> 锁定主体形象
  • 场景拼合 — <<<image_1>>> 中的角色出现在 <<<image_2>>> 的环境
  • 多素材引导 — 任意位置嵌入 N 张参考图
示例
"把 <<<image_1>>> 中穿红衣的女孩,放到 <<<image_2>>> 的雪山场景里,镜头缓慢推进"
对应 image_urls:
"image_urls": [
  "https://cdn.example.com/girl-red.jpg",
  "https://cdn.example.com/snow-mountain.jpg"
]
Omni / O1 提供了图时若 prompt 未含任何 <<<image_N>>>,系统会自动在开头补 <<<image_1>>>。非 Omni / O1 的 v2.6 / v3 / 3.0-turbo 不解析该占位符,会作为字面文本送入模型。

资源限制

项目限制
参考图片(单张)≤ 30MB,JPG / PNG / WEBP
参考图片(数量)图生 / 首尾帧:1-2 张;Omni / O1 多模态:多张;运动控制:1 张
参考视频(video_urls)MP4 / MOV,≥ 3 秒,运动控制 ≤ 100MB;视频参考分辨率 720px-2160px
提示词≤ 2500 字符
输出MP4,链接 24 小时有效

相关文档