Docs/Kling (可灵) 视频生成 API

Kling (可灵) 视频生成 API

AI 视频生成，支持文生视频、图生视频、音频生成和音色定制。

快速开始

从控制台获取 API 密钥

选择 Kling 视频模型 (kling-v2-6 或 kling-v3)

发送 POST 请求创建任务

轮询 GET 请求获取视频结果

认证方式

在所有请求中添加 Bearer Token 认证头：

Authorization: Bearer YOUR_API_KEY

可用模型

模型	API 名称	特性	价格 (8.5折)
Kling V2.6	`kling-v2-6`	5s/10s, 文生/图生视频, 音频+音色	$0.0159起
Kling V3	`kling-v3`	3-15s, 文生/图生视频, 音频, 按秒计费	$0.0064/秒起
Kling Motion Control	`kling-motion-control`	动作控制, 720p/1080p, 最长30秒	$0.0309起

详细定价 (8.5折)

Kling V2.6

模式	时长	音频	音色	$
std	5s	-	-	$0.0159
std	10s	-	-	$0.0320
pro	5s	-	-	$0.0267
pro	10s	-	-	$0.0531
pro	5s	on	-	$0.0531
pro	10s	on	-	$0.1064
pro	5s	on	on	$0.0639
pro	10s	on	on	$0.1275

Kling V3

模式	时长	音频	$/秒
std	3-15s	-	$0.0633
std	3-15s	on	$0.0956
pro	3-15s	-	$0.0853
pro	3-15s	on	$0.1280

Kling Motion Control (7折)

分辨率	时长	$
720p	Up to 30s	$0.0309
1080p	Up to 30s	$0.0309

接口端点

POST/api/v1/video/generations

创建可灵视频生成任务。根据是否提供 image 参数自动选择文生视频或图生视频。

GET/api/v1/video/generations?task_id=xxx

查询任务状态并获取视频链接

请求参数

基本参数

model必填string

"kling-v2-6"、"kling-v3" 或 "kling-motion-control"

promptstring

正向文本提示词（不超过2500字符）。文生视频时必填。

imagestring

参考图像（base64 或 URL）。提供此参数则使用图生视频模式。

modestring

"std"（标准）或 "pro"（高品质）。默认："std"

durationstring

V2.6："5" 或 "10"。V3："3" 到 "15"。默认："5"

soundstring

"on" 或 "off"。是否生成音频。默认："off"

negative_promptstring

负向文本提示词（不超过2500字符）

aspect_ratiostring

视频画面纵横比（宽:高）

cfg_scalenumber

自由度。值越大与提示词相关性越强。

callback_urlstring

完成后的回调 URL

高级参数

image_tailstring

尾帧参考图像（仅图生视频）

voice_listarray

音色 ID 列表（仅 V2.6+，最多2个）

camera_controlobject

摄像机运动控制（type + config）

multi_shotboolean

是否生成多镜头视频

watermark_infoobject

{ enabled: true/false } - 是否生成含水印版本

motion_videostring

动作参考视频 URL（仅 kling-motion-control）。提供动作源视频以驱动角色动画。

Kling Motion Control 说明

使用 "kling-motion-control" 模型时，需提供 image（角色参考图）和 motion_video（动作源视频），生成角色执行指定动作的视频。支持最长 30 秒，720p/1080p 分辨率。

代码示例

curl -X POST https://apimodels.app/api/v1/video/generations \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "kling-v2-6",
    "prompt": "A girl dancing on the beach at sunset, cinematic lighting",
    "mode": "std",
    "duration": "5",
    "aspect_ratio": "16:9"
  }'

响应格式

创建任务响应

{
  "code": 200,
  "msg": "success",
  "data": {
    "taskId": "clxxx...",
    "state": "pending",
    "model": "kling-video/kling-v2-6"
  }
}

成功响应

{
  "code": 200,
  "msg": "success",
  "data": {
    "taskId": "clxxx...",
    "state": "completed",
    "model": "kling-video/kling-v2-6",
    "resultUrls": ["https://...video.mp4"],
    "createTime": 1705123450000,
    "completeTime": 1705123500000
  }
}

失败响应

{
  "code": 200,
  "msg": "success",
  "data": {
    "taskId": "clxxx...",
    "state": "failed",
    "model": "kling-video/kling-v2-6",
    "failMsg": "Content policy violation"
  }
}

任务状态

pending任务已排队，等待处理

processing视频生成中

completed视频生成成功

failed视频生成失败

错误码

400请求错误 - 参数缺失或无效

401未授权 - API 密钥无效

402余额不足 - 积分不够

404未找到 - 任务 ID 不存在

500服务器内部错误

注意事项

*视频文件保存 7 天，请及时下载
*提供 image 参数时自动使用图生视频模式
*V3 支持 3-15 秒灵活时长，按秒计费
*V2.6 和 V3 均支持音频生成（设置 sound: "on"）
*音色定制需要 V2.6+ 并设置 sound: "on" 和 voice_list
*建议每 5-10 秒轮询一次状态
*Kling Motion Control 需同时提供 image（角色参考图）和 motion_video（动作源视频）参数

在 Playground 中试用获取 API 密钥