跳转到主要内容
POST
/
v1
/
tasks
Kling 系列
curl --request POST \
  --url https://www.qingbo.dev/v1/tasks \
  --header 'Content-Type: application/json' \
  --data '
{
  "model": "<string>",
  "action": "<string>",
  "prompt": "<string>",
  "aspect_ratio": "<string>",
  "resolution": "<string>",
  "duration": 123,
  "image_urls": [
    "<string>"
  ],
  "first_frame_image": "<string>",
  "last_frame_image": "<string>",
  "video_urls": [
    "<string>"
  ],
  "callback_url": "<string>",
  "callback_events": [
    "<string>"
  ]
}
'
{
  "task_id": "task-wave1775285160b950328499",
  "model": "kling-v3",
  "action": "generate",
  "status": "queued",
  "created_at": 1775285160040,
  "progress": 0
}

Documentation Index

Fetch the complete documentation index at: https://docs.qingbo.dev/llms.txt

Use this file to discover all available pages before exploring further.

快手可灵 Kling 视频生成系列。 四代模型分工:
  • kling-v2.6 — 经典稳定版,720P 无声 / 1080P 可有声,语义和动态稳定性进一步打磨
  • kling-v3 — 新一代基础模型,新增 4K 分辨率,文生时长可拓展到 15 秒,原生支持有声视频
  • kling-v3-omni — v3 系列统一多模态接口,文生 / 图生 / 视频参考全走同一 endpoint,prompt 支持 <<<image_N>>> 引用语法
  • kling-video-o1 — 首款推理增强视频模型,生成前对提示词与参考素材深度规划,物理一致性、复杂运动、长动作语义跟随上表现最优
按 分辨率 计费,单位 $/秒,通过 resolution 选择 720p / 1080p / 4K。

​
定价

模型720P1080P4K备注
kling-v2.6$0.0391$0.06641—1080P 有声叠加至 $0.159375
kling-v3$0.0714$0.0952$0.455345有声:720P $0.1071 / 1080P $0.1428 / 4K 同价
kling-v3-omni$0.0714$0.0952$0.455345有声:720P $0.0952 / 1080P $0.119;视频参考:720P $0.1071 / 1080P $0.1428
kling-video-o1$0.0714$0.0952—视频参考:720P $0.1071 / 1080P $0.1428
单价为每秒;实际计费 = 单价 × duration。开启 audio 或挂 video_list 视频参考会切换到对应高档单价。

​
调用示例

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",
    "audio": true
  }'

{
  "task_id": "task-wave1775285160b950328499",
  "model": "kling-v3",
  "action": "generate",
  "status": "queued",
  "created_at": 1775285160040,
  "progress": 0
}
提交后用 GET /v1/tasks/{task_id} 轮询状态,详见 任务系统。

​
可用模型

模型 ID分辨率时长支持 action特色
kling-video-o1720P / 1080P5 / 10 秒generate · image2video · first_last_frame · reference · reference_video推理增强,物理一致性最优
kling-v3-omni720P / 1080P / 4K3-15 秒generate · image2video · reference · reference_video统一多模态 endpoint
kling-v3720P / 1080P / 4K3-15 秒generate · image2video · first_last_frame4K + 原生有声
kling-v2.6720P / 1080P5 / 10 秒generate · image2video · first_last_frame1080P 可有声,稳定性优

​
通用参数

​
model
string
必填
模型 ID,见 可用模型 表
​
action
string
默认值:"generate"
操作类型,可选值:
  • generate — 文生视频(T2V)
  • image2video — 图生视频,需配合 first_frame_image 或 image_urls
  • first_last_frame — 首尾帧补全,需 first_frame_image + last_frame_image(v2.6 / v3 / o1)
  • reference — 多模态参考生视频,需配合 image_urls(omni / o1)
  • reference_video — 视频参考生视频,需配合 video_list(omni / o1)
​
prompt
string
必填
视频描述文本。Omni / O1 中可用 <<<image_N>>> 语法引用 image_urls 第 N 张图(N 从 1 开始)
​
aspect_ratio
string
默认值:"16:9"
画面宽高比,仅 T2V 生效;图 / 视频参考模式跟随源素材比例。可选值:
  • 16:9 — 横版宽屏
  • 9:16 — 竖版长屏
  • 1:1 — 正方形
​
resolution
string
默认值:"720p"
输出分辨率。各模型支持范围见 可用模型:
  • 720p
  • 1080p
  • 4K(仅 v3 / omni)
​
duration
integer
默认值:"5"
视频时长(秒)。v2.6 / o1 仅 5 或 10;v3 / omni 支持 3-15 任意整数
​
image_urls
string[]
参考图片 URL 数组。单元素数组触发 I2V;多张用于 Omni / O1 的多模态参考(可被 <<<image_N>>> 引用)
​
first_frame_image
string
视频首帧图 URL。配合 image2video 或 first_last_frame action 使用(v2.6 / v3 / o1)
​
last_frame_image
string
视频尾帧图 URL,配合 first_last_frame action 使用
​
video_urls
string[]
参考视频 URL 数组(单元素)。Omni / O1 简化形态,等价于挂一段 refer_type=feature 的 video_list
​
callback_url
string
Webhook 回调地址,任务终态时调用。详见 回调机制
​
callback_events
string[]
需要推送的事件类型,默认终态全推

​
模型特定参数

​
video_list
object[]
参考视频列表,最多 1 段。结构与 Omni 相同:
  • video_url — 视频 URL
  • refer_type — base / feature
  • keep_original_sound — yes / no
O1 不支持 audio 字段;有声需求请用 v3 / omni。

​
特殊语法说明

<<<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 的 v2.6 / v3 不解析 <<<image_N>>> 占位符,会作为字面文本送入模型。

​
资源限制

项目限制
参考图片(单张)≤ 30MB,JPG / PNG / WEBP
参考图片(数量)I2V:1 张;Omni / O1 多模态:建议 ≤ 4 张
参考视频(video_list)MP4 / MOV,≤ 100MB,2-30 秒,最多 1 段
提示词≤ 2500 字符
输出MP4,链接 24 小时有效

​
相关文档