可灵 Kling 视频 API 规范

kling-3.0-turbo 按分辨率计费（720P / 1080P / 2K / 4K）的调用方式，以及时长、比例、参考图片与视频、首尾帧和音频规则。

本页是快手可灵视频模型 kling-3.0-turbo 的调用规范。它与其他视频模型共用 POST /v1/videos 创建、GET /v1/videos/{id} 轮询的流程；鉴权、素材上传、轮询状态、结果下载和错误处理见视频 API 完整调用规范，本页只列出可灵特有的字段和规则。

更新于 2026-10-10。可灵模型只支持轮询：提交时不要设置 callback_url，否则请求会被拒绝。

模型一览

模型	可选分辨率	时长	比例	图 / 视频 / 音频上限
`kling-3.0-turbo`	`720p`（默认）、`1080p`、`2k`、`4k`	4–15 秒，默认 5 秒	`16:9` `9:16` `1:1`，默认 `16:9`	30（含首尾帧）/ 10 / 0

用 resolution 选择输出档位并按该档位计费，大小写均可（4k 与 4K 等价）；不传时使用最低档 720p。填写不支持的档位会返回 400，不会自动降档。

通用规则

时长：duration（或字符串形式的 seconds）填整数秒，4–15 秒，不传时为 5 秒。
比例：ratio（或 aspect_ratio）可选 16:9、9:16、1:1。
提示词：prompt 必填，最长 2000 个字符。
生成音频：支持 generate_audio（布尔值）。
参考音频：不支持，提交参考音频会返回 400。
可选字段：negative_prompt（负面提示词）、seed（整数）。

参考图片与视频

参考图片放顶层 images，参考视频放 metadata.referenceVideos。图片最多 30 张（首尾帧也计入），视频最多 10 段。

{
  "model": "kling-3.0-turbo",
  "resolution": "1080p",
  "prompt": "保持参考图中产品的外观，参考视频的镜头节奏，展示产品在桌面上缓慢旋转",
  "duration": 10,
  "ratio": "16:9",
  "generate_audio": true,
  "images": [
    "https://cdn.example.com/product-front.jpg",
    "https://cdn.example.com/product-side.jpg"
  ],
  "metadata": {
    "referenceVideos": ["https://cdn.example.com/motion-reference.mp4"]
  }
}

首尾帧

首帧和尾帧放在 metadata.firstFrame 与 metadata.lastFrame。lastFrame 必须与 firstFrame 同时提供。可灵允许首尾帧与参考图片一起提交，合计不超过 30 张。

{
  "model": "kling-3.0-turbo",
  "resolution": "4k",
  "prompt": "镜头从清晨的海岸平滑推进到傍晚的同一海湾",
  "duration": 5,
  "ratio": "16:9",
  "metadata": {
    "firstFrame": "https://cdn.example.com/start.jpg",
    "lastFrame": "https://cdn.example.com/end.jpg"
  }
}

文件上传

也可以用 multipart/form-data 直接上传 1 个本地图片文件，字段名为 input_reference；此时不能再同时提交 images 或 image。参考视频不能以文件形式提交，请先按本地素材上传取得 URL。

旧模型名

此前带档位后缀的模型名 kling-3.0-turbo-720p、kling-3.0-turbo-1080p、kling-3.0-turbo-2k、kling-3.0-turbo-4k 已于 2026-10-10 下架，使用这些名称提交会返回错误。请改用 kling-3.0-turbo，并用 resolution 选择档位。