可灵 (Kling) — 原生格式

POST/kling/v1/videos/text2video

调用可灵原生 API 提交文生视频任务。

Bearer Token

POST/kling/v1/videos/image2video

调用可灵原生 API 提交图生视频任务。

Bearer Token

模型介绍

可灵是快手推出的视频生成模型，擅长写实质感、电影运镜、人物动作等场景，是国内视频生成能力第一梯队的产品。

支持模型

模型	时长	分辨率	帧率	说明
`kling-3.0`	5s / 10s	720p / 1080p	24 fps	官方视频模型 ID（推荐）

模型名与官方 ID（重要）

快手可灵官方对同一代产品在两个模态上使用了只差一个字母的两套标识 ——

带 v 的是【图片】，带【点号】的是【视频】。

官方产品	API 标识	类型	官方接口
Kling Image 3.0	`kling-v3`	图片	`POST /v1/images/generations`（`model_name` 默认值）
Kling Image 3.0 Omni	`kling-v3-omni`	图片	`POST /v1/images/omni-image`（`model_name` 枚举）
视频 3.0	`kling-3.0`	视频	`POST /text-to-video/kling-3.0`（模型写在路径里）
视频 3.0 Omni	`kling-3.0-omni`	视频	`POST /omni-video/kling-3.0-omni`（模型写在路径里）

官方视频接口没有 model_name 字段：模型版本由 URL 路径表达（如 /text-to-video/kling-3.0）。只有图片接口（/v1/images/generations、/v1/images/omni-image）才用 model_name 传模型。
✅ kling-v3 是官方图片模型 ID，本平台已接入官方图片生成端点 POST /v1/images/generations （见图像生成）。它不在视频面：把 kling-v3 发到本页的视频端点会得到 400 与一条指路提示（请改用 /v1/images/generations）。出视频请统一使用官方视频 ID kling-3.0。
⚠️ kling-v3-omni（图片）与 kling-3.0-omni（视频）不可互换：前者走 /v1/images/omni-image 按张计费，后者是视频全能模型、按秒计费。

端点概览

端点	方法	说明
`/kling/v1/videos/text2video`	POST	文生视频
`/kling/v1/videos/image2video`	POST	图生视频
`/kling/v1/videos/text2video/{task_id}`	GET	查询文生视频任务
`/kling/v1/videos/image2video/{task_id}`	GET	查询图生视频任务

请求参数

text2video

text2video 请求参数

参数	类型	必填	默认值	描述
model	string	是	-	模型名称：官方视频 ID `kling-3.0`（`kling-v3` 已不在视频面，见「模型名与官方 ID」）
prompt	string	是	-	视频描述
duration	string	否	5	时长：`5` / `10`（秒）
aspect_ratio	string	否	16:9	宽高比：`16:9` / `9:16` / `1:1`
cfg_scale	number	否	0.5	提示词相关性，越大越遵循，越小越发散
callback_url	string	否	-	任务回调地址

image2video

image2video 请求参数

参数	类型	必填	默认值	描述
model	string	是	-	模型名称：官方视频 ID `kling-3.0`（`kling-v3` 已不在视频面，见「模型名与官方 ID」）
image	string	是	-	参考图，支持公网 URL 与 Base64
prompt	string	否	-	视频描述
duration	string	否	5	时长：`5` / `10`（秒）
cfg_scale	number	否	0.5	提示词相关性
callback_url	string	否	-	任务回调地址

请求示例

文生视频

bash

curl -X POST /kling/v1/videos/text2video \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "kling-3.0",
    "prompt": "猫咪在草地上奔跑，阳光明媚",
    "duration": "5",
    "aspect_ratio": "16:9"
  }'

图生视频

python

r = requests.post("/kling/v1/videos/image2video", headers=HEADERS, json={
    "model": "kling-3.0",
    "image": "https://example.com/portrait.png",
    "prompt": "人物微微转头，微笑",
    "duration": "5",
})

查询任务

python

r = requests.get(f"/kling/v1/videos/text2video/{task_id}", headers=HEADERS).json()
if r["data"]["task_status"] == "succeed":
    print(r["data"]["task_result"]["videos"][0]["url"])

响应示例

提交响应

json

{
  "code": 0,
  "message": "success",
  "data": {
    "task_id": "kl-abc123",
    "task_status": "submit"
  }
}

查询响应（succeed）

查询响应

json

{
  "code": 0,
  "message": "success",
  "data": {
    "task_id": "kl-abc123",
    "task_status": "succeed",
    "task_result": {
      "videos": [
        {
          "id": "v-1",
          "url": "https://cdn.example.com/kling/abc.mp4",
          "duration": "5"
        }
      ]
    }
  }
}

注意事项

生成耗时通常 1~5 分钟，10s 视频耗时更长。
视频 URL 为对象存储签名链接，有效期 24 小时（X-Tos-Expires=86400），每次查询重新签名，请及时下载。
图生视频时，image 支持公网 URL 与 Base64 两种形式。
cfg_scale 越大越遵循 prompt，越小越发散；默认 0.5 为推荐值。
kling-3.0 支持 4K 输出；生成耗时通常长于经济档模型（kling-2.5-turbo）。
计费按所选模型的秒档单价 × 实际秒数（不做秒数取整）；视频类模型分别按次/按秒档/按 token 计费，以定价总表为准。

可灵 (Kling) — 原生格式 ​

模型介绍 ​

支持模型 ​

模型名与官方 ID（重要） ​

端点概览 ​

请求参数 ​

text2video ​

image2video ​

请求示例 ​

文生视频 ​

图生视频 ​

查询任务 ​

响应示例 ​

提交响应 ​

查询响应（succeed） ​

注意事项 ​