Kling AI 视频生成 API

概览

重大变更（2025-12-19）：新增 text-to-video 类型支持（多模型支持）；新增 sound 参数（仅 V2.6，开启音频生成）；新增 aspect_ratio 参数（仅 V2.6，支持 16:9、9:16、1:1）；新增 kling-v2-6 模型版本。
重大变更（2025-12-10）：mode → quality_mode；image → image_urls（数组，仅 1 张）；新增必填字段 type。
提交：POST https://api.wizzx.ai/api/v1/task/submit/kling-ai；轮询：POST https://api.wizzx.ai/api/v1/task/status。
必填：prompt、type（text-to-video 或 image-to-video）、quality_mode（std/pro）、duration（5/10 秒）。
条件必填：image_urls（仅 image-to-video 时需要提供 1 张图片）。
可选：模型版本、sound（仅 V2.6）、aspect_ratio（仅 V2.6）、负向提示词、cfg 自由度（仅 V1.x）、尾帧、静态/动态笔刷、镜头控制、回调、外部任务 ID。
互斥（仅 image-to-video）：image_tail、dynamic_masks/static_mask、camera_control 三组选其一。

认证

Header：Authorization: Bearer <your_api_key>
网关会校验并注入用户身份，无需额外参数。

提交任务

接口：POST /api/v1/task/submit/kling-ai，Content-Type: application/json

必填参数

参数	类型	说明
`prompt`	string	正向提示词（≤2500 字符）
`type`	string	生成类型：`text-to-video` 或 `image-to-video`
`quality_mode`	string	质量模式：`std`（标准）或 `pro`（专业）
`duration`	int	视频时长：`5` 或 `10` 秒

条件必填参数

参数	类型	说明
`image_urls`	[]string	参考图片 URL 数组，`image-to-video` 时必须 1 张

可选参数

参数	类型	默认值	说明
`model_name`	string	kling-v1	模型版本（详见下方）
`aspect_ratio`	string	16:9	画面纵横比（仅 V2.6）：`16:9`、`9:16`、`1:1`
`sound`	string	off	是否生成声音（仅 V2.6）：`on`、`off`
`image_tail`	string	-	尾帧控制图像 URL（仅 image-to-video），与 dynamic_masks/static_mask 或 camera_control 互斥
`negative_prompt`	string	-	负向提示词（≤2500 字符）
`cfg_scale`	float	0.5	自由度 [0, 1]（仅 V1.x 模型），值越大越贴合提示词
`static_mask`	string	-	静态笔刷区域 URL（仅 image-to-video）
`dynamic_masks`	array	-	动态笔刷列表（仅 image-to-video，最多 6 组）
`camera_control`	object	-	镜头运动控制
`callback_url`	string	-	回调通知地址
`external_task_id`	string	-	自定义任务 ID

资源要求：jpg/jpeg/png，≤10MB，宽高 ≥300px，宽高比 1:2.5 ~ 2.5:1。仅 image-to-video 时，image_tail、dynamic_masks/static_mask、camera_control 三组能力互斥。

模型版本与功能支持

模型	text-to-video	image-to-video	sound	aspect_ratio	说明
`kling-v1`	✅	✅	❌	❌	基础版本
`kling-v1-5`	❌	✅	❌	❌	迭代版本（仅图生视频）
`kling-v1-6`	✅	✅	❌	❌	迭代版本
`kling-v2-1`	❌	✅	❌	❌	高质量版本（仅图生视频）
`kling-v2-1-master`	✅	✅	❌	❌	高质量版本
`kling-v2-5-turbo`	✅	✅	❌	❌	快速版本
`kling-v2-6`	✅	✅	✅	✅	最新版本，支持 sound 和 aspect_ratio

请求示例（基础文生视频 - V1）

curl -X POST https://api.wizzx.ai/api/v1/task/submit/kling-ai \
  -H "Authorization: Bearer <api_key>" \
  -H "Content-Type: application/json" \
  -d '{
    "prompt": "一只猫在弹钢琴",
    "type": "text-to-video",
    "quality_mode": "std",
    "duration": 5
  }'

请求示例（V2.6 文生视频 + 声音）

curl -X POST https://api.wizzx.ai/api/v1/task/submit/kling-ai \
  -H "Authorization: Bearer <api_key>" \
  -H "Content-Type: application/json" \
  -d '{
    "prompt": "一只猫在弹钢琴，背景音乐悠扬",
    "type": "text-to-video",
    "model_name": "kling-v2-6",
    "quality_mode": "std",
    "duration": 5,
    "aspect_ratio": "16:9",
    "sound": "on"
  }'

请求示例（V2.6 图生视频）

curl -X POST https://api.wizzx.ai/api/v1/task/submit/kling-ai \
  -H "Authorization: Bearer <api_key>" \
  -H "Content-Type: application/json" \
  -d '{
    "prompt": "宇航员站起身走了",
    "type": "image-to-video",
    "image_urls": ["https://example.com/astronaut.jpg"],
    "model_name": "kling-v2-6",
    "quality_mode": "pro",
    "duration": 10,
    "aspect_ratio": "9:16",
    "sound": "off"
  }'

请求示例（基础图生视频 - V1.x）

curl -X POST https://api.wizzx.ai/api/v1/task/submit/kling-ai \
  -H "Authorization: Bearer <api_key>" \
  -H "Content-Type: application/json" \
  -d '{
    "prompt": "宇航员站起身走了",
    "type": "image-to-video",
    "image_urls": ["https://example.com/astronaut.jpg"],
    "quality_mode": "std",
    "duration": 5,
    "cfg_scale": 0.5
  }'

请求示例（高品质模式 + 镜头控制）

curl -X POST https://api.wizzx.ai/api/v1/task/submit/kling-ai \
  -H "Authorization: Bearer <api_key>" \
  -H "Content-Type: application/json" \
  -d '{
    "prompt": "主角在森林中漫步",
    "type": "image-to-video",
    "image_urls": ["https://example.com/forest.jpg"],
    "quality_mode": "pro",
    "duration": 10,
    "model_name": "kling-v2-1-master",
    "camera_control": {
      "type": "forward_up"
    }
  }'

请求示例（动态笔刷轨迹）

curl -X POST https://api.wizzx.ai/api/v1/task/submit/kling-ai \
  -H "Authorization: Bearer <api_key>" \
  -H "Content-Type: application/json" \
  -d '{
    "prompt": "宇航员站起身走了",
    "type": "image-to-video",
    "image_urls": ["https://example.com/astronaut.jpg"],
    "quality_mode": "std",
    "duration": 5,
    "dynamic_masks": [
      {
        "mask": "https://example.com/mask1.png",
        "trajectories": [
          {"x": 279, "y": 219},
          {"x": 417, "y": 65}
        ]
      }
    ]
  }'

成功响应

{
  "code": 0,
  "message": "success",
  "data": {
    "task_id": "4bbbc9e0-8de8-4f35-a31e-8596c1a6d18a",
    "model_key": "kling-ai",
    "credits_deducted": 230
  },
  "request_id": "d54c66a8-0f0f-439c-bd3a-36f3fd275881"
}

任务查询

接口：POST /api/v1/task/status
Body：

{
  "task_id": "4bbbc9e0-8de8-4f35-a31e-8596c1a6d18a"
}

查询响应示例

{
  "code": 0,
  "message": "success",
  "data": {
    "task_id": "4bbbc9e0-8de8-4f35-a31e-8596c1a6d18a",
    "status": "SUCCEEDED",
    "result_urls": [
      "https://cdn.example.com/video.mp4"
    ],
    "error": "",
    "credits_deducted": 230
  },
  "request_id": "499347b1-ff99-4ba2-a977-ad655431919d"
}

客户端可见状态：PENDING、QUEUED、PROCESSING、REVIEW_REQUIRED、SUCCEEDED、FAILED。

镜头控制

运镜类型

type	说明
`simple`	简单运镜，需配合 `config` 参数
`down_back`	镜头下压并后退
`forward_up`	镜头前进并上仰
`right_turn_forward`	右旋后前进
`left_turn_forward`	左旋后前进

config 参数（仅 simple 类型）

参数	范围	说明
`horizontal`	[-10, 10]	水平运镜
`vertical`	[-10, 10]	垂直运镜
`pan`	[-10, 10]	水平摇镜
`tilt`	[-10, 10]	垂直摇镜
`roll`	[-10, 10]	旋转运镜
`zoom`	[-10, 10]	变焦

simple 模式下，以上 6 个参数只能有一个非零。

积分与定价

按秒计费：

Kling V2.6（按 sound 计费）

模式	积分/秒	美元/秒	对比官方
sound=off	65	$0.065	节省 7%
sound=on	130	$0.13	节省 7%

官方：

0.07/秒（无音频），

0.14/秒（有音频）。

Kling V1.x / V2.x（按 quality_mode 计费）

Kling 1.6 / 2.1

模式	积分/秒	美元/秒	对比官方
std	46	$0.046	节省 8%
pro	92	$0.092	节省 8%

官方：std

0.05/秒，pro

0.10/秒。

Kling 2.1 Master

模式	积分/秒	美元/秒	对比官方
pro	240	$0.24	节省 10%

官方：$0.28/秒。

Kling 2.5 Turbo

模式	积分/秒	美元/秒	对比官方
std	36	$0.036	节省 10%
pro	65	$0.065	节省 7%

官方：std

0.04/秒，pro

0.07/秒。

费用计算示例

5 秒视频，std 模式（Kling 1.6）：46 积分/秒 x 5 秒 = 230 积分
10 秒视频，pro 模式（Kling 2.1）：92 积分/秒 x 10 秒 = 920 积分
5 秒视频，V2.6 带声音：130 积分/秒 x 5 秒 = 650 积分

常见问题

哪些模型支持文生视频？ 支持 text-to-video 的模型：kling-v1、kling-v1-6、kling-v2-1-master、kling-v2-5-turbo、kling-v2-6。注意 kling-v1-5 和 kling-v2-1 仅支持图生视频。
如何生成带声音的视频？ 使用 kling-v2-6 模型并设置 sound: "on"。注意带声音的积分是不带声音的两倍。
aspect_ratio 参数什么时候可用？ aspect_ratio 仅在 kling-v2-6 模型下可用，其他模型会返回错误。
为什么 mode 改名为 quality_mode？ 为了与新增的 type 区分；type 表示生成类型（text-to-video/image-to-video），quality_mode 表示质量等级（std/pro）。
cfg_scale 参数什么时候可用？ cfg_scale 仅支持 V1.x 模型，V2.x 模型会返回错误。
如何使用镜头控制？ 设置 camera_control，镜头控制同时支持 text-to-video 和 image-to-video；simple 模式的 6 个 config 参数只能有一个非零。
动态笔刷与静态笔刷有什么区别？ 静态笔刷限定固定区域；动态笔刷可添加轨迹控制运动路径。仅 image-to-video 支持。
视频保留多久？ 结果 URL 生命周期取决于存储配置和上游 Provider；需要长期保存的结果请及时归档。

快速开始

智能体集成

视频生成

图像生成

Kling AI 视频生成 API

概览

认证

提交任务

必填参数

条件必填参数

可选参数

模型版本与功能支持

请求示例（基础文生视频 - V1）

请求示例（V2.6 文生视频 + 声音）

请求示例（V2.6 图生视频）

请求示例（基础图生视频 - V1.x）

请求示例（高品质模式 + 镜头控制）

请求示例（动态笔刷轨迹）

成功响应

任务查询

查询响应示例

镜头控制

运镜类型

config 参数（仅 simple 类型）

积分与定价

Kling V2.6（按 sound 计费）

Kling V1.x / V2.x（按 quality_mode 计费）

Kling 1.6 / 2.1

Kling 2.1 Master

Kling 2.5 Turbo

费用计算示例

常见问题

​概览

​认证

​提交任务

​必填参数

​条件必填参数

​可选参数

​模型版本与功能支持

​请求示例（基础文生视频 - V1）

​请求示例（V2.6 文生视频 + 声音）

​请求示例（V2.6 图生视频）

​请求示例（基础图生视频 - V1.x）

​请求示例（高品质模式 + 镜头控制）

​请求示例（动态笔刷轨迹）

​成功响应

​任务查询

​查询响应示例

​镜头控制

​运镜类型

​config 参数（仅 simple 类型）

​积分与定价

​Kling V2.6（按 sound 计费）

​Kling V1.x / V2.x（按 quality_mode 计费）

​Kling 1.6 / 2.1

​Kling 2.1 Master

​Kling 2.5 Turbo

​费用计算示例

​常见问题

概览

认证

提交任务

必填参数

条件必填参数

可选参数

模型版本与功能支持

请求示例（基础文生视频 - V1）

请求示例（V2.6 文生视频 + 声音）

请求示例（V2.6 图生视频）

请求示例（基础图生视频 - V1.x）

请求示例（高品质模式 + 镜头控制）

请求示例（动态笔刷轨迹）

成功响应

任务查询

查询响应示例

镜头控制

运镜类型

config 参数（仅 simple 类型）

积分与定价

Kling V2.6（按 sound 计费）

Kling V1.x / V2.x（按 quality_mode 计费）

Kling 1.6 / 2.1

Kling 2.1 Master

Kling 2.5 Turbo

费用计算示例

常见问题