00-概述
可灵 AI 视频生成（新版接口）· 概述
文档版本：v1.0.0 | 最后更新：2026-09-02 本平台已完整适配可灵 AI 官方新版视频生成 API（New-Style API），请求与响应均为透传，参数语义与官方一致。
新版接口与经典接口（/kling/v1/videos/*）并行提 供、互不影响，已接入经典接口的用户无需迁移。
能力简介
| 能力 | 接口路径 | 支持模型 | 说明 |
|---|---|---|---|
| 文生视频 | POST /kling/text-to-video/{model} | kling-3.0、kling-3.0-turbo、kling-2.6、kling-2.5-turbo | 根据文本提示词生成视频 |
| 图生视频 | POST /kling/image-to-video/{model} | kling-3.0、kling-3.0-turbo、kling-2.6、kling-2.5-turbo | 以图片驱动生成视频 |
| Omni 视频生成 | POST /kling/omni-video/{model} | kling-3.0-omni、kling-o1 | 多模态全能视频生成，支持图片、视频、主体、音色等输入 |
| 动作控制 | POST /kling/motion-control/{model} | kling-3.0、kling-2.6 | 参考视频驱动人物动作生成 |
| 查询任务 | GET /kling/tasks | — | 统一任务查询，支持批量与自定义任务 ID |
id，需通过查询任务接口轮询任务状态；任务成功后响应中包含视频下载地址，请及时下载或转存。标准调用流程
创建任务 (POST /kling/{capability}/{model})
│ 返回 data.id + status: "submitted"
▼
查询状态 (GET /kling/tasks?task_ids={id}) ← 轮询直至 succeeded 或 failed
│ 返回 outputs[].url
▼
下载视频文件接口地址
路径规则：在平台域名后追加渠道前缀 /kling，再拼接可灵官方新版路径即可（新版路径无/v1前缀）。
例如官方https://api-beijing.klingai.com/text-to-video/kling-3.0→ 平台https://platform.shuyanai.com/kling/text-to-video/kling-3.0。
鉴权
Authorization 头携带 Bearer Token 进行鉴权：Authorization: Bearer {API_KEY}{API_KEY} 为您在平台控制台创建的接口密钥。请求头
| 头部 | 必填 | 说明 |
|---|---|---|
Authorization | 是 | Bearer {API_KEY} |
Content-Type | 是 | 固定为 application/json |
模型概览
| 模型（URL 段名） | 说明 |
|---|---|
kling-3.0 | 旗舰模型，支持多镜头、原生音频、最高 4K 清晰度 |
kling-3.0-turbo | 3.0 加速版，更快出片 |
kling-3.0-omni | 3.0 全能版，多模态输入（图片/视频/主体/音色） |
kling-o1 | 多模态视频模型，支持参考视频输入 |
kling-2.6 | 高性价比模型，支持原生音频与指定音色 |
kling-2.5-turbo | 快速生成，性价比高 |
不同能力支持的模型与参数范围有差异，请以各接口文档中的说明为准。
通用默认值
settings 时，服务端按以下默认值处理：| 参数 | 默认值 |
|---|---|
settings.resolution | 720p |
settings.duration | 5（秒） |
settings.audio | off |
settings.aspect_ratio | 16:9 |
任务状态值
| 状态 | 含义 |
|---|---|
submitted | 已提交 |
processing | 处理中 |
succeeded | 生成成功 |
failed | 生成失败 |
响应格式
{
"code": 0,
"message": "string",
"request_id": "string",
"data": { ... }
}| 字段 | 类型 | 说明 |
|---|---|---|
code | Int | 错误码，0 表示成功 |
message | String | 错误信息 |
request_id | String | 请求 ID，用于跟踪、排查问题 |
data | Object | 业务数据 |
回调通知
options.callback_url 参数。设置后，当任务状态变化时，系统将以 POST 方式向该地址发送回调请求。相关文档
