Kling v3

kling-v3 当前暂未开放调用。本页字段说明仅供接入预览，实际可用状态以模型列表为准。

模型

模型	输入	时长	质量模式	默认值
`kling-v3`	文生视频、首帧/首尾帧图生视频	`3-15` 秒	`std`、`pro`	`5` 秒、`std`、`16:9`、`audio: false`

std 对应 720P，pro 对应 1080P。当前 LoopToken 稳定支持范围不包含 mode: "4k"，也不接受顶层 resolution；请用 mode 选择质量档位。

请求字段

字段	类型	必填	说明
`model`	string	是	固定为 `kling-v3`
`prompt`	string	是	正向提示词；`multi_shot=true` 时可省略
`negative_prompt`	string	否	反向提示词
`mode`	string	否	`std` 或 `pro`；默认 `std`
`duration`	integer	否	`3-15` 秒，必须是数字；默认 `5`
`aspect_ratio`	string	否	`16:9`、`9:16`、`1:1`；默认 `16:9`
`image_urls`	string[]	否	图生视频图片 URL；1 张作为首帧，2 张作为首帧 + 尾帧；最多 2 张，必须公网可访问
`watermark`	boolean	否	是否添加水印
`audio`	boolean	否	是否生成有声视频，默认 `false`
`multi_shot`	boolean	否	是否启用多镜头分镜模式，默认 `false`
`shot_type`	string	否	`customize` 或 `intelligence`；`multi_shot=true` 时必填
`multi_prompt`	object[]	否	自定义分镜数组；`shot_type=customize` 时必填，最多 6 个分镜
`element_list`	object[]	否	主体引用列表，最多 3 个主体
`callback_url`	string	否	任务到达终态后的 HTTPS 回调地址

图生视频

image_urls 的规则：

图片数量	行为
0	文生视频
1	作为首帧图片
2	第 1 张为首帧，第 2 张为尾帧

仅提供尾帧而没有首帧会失败。图生视频时，aspect_ratio 可能被输入图片的实际比例覆盖。

多镜头分镜

开启自定义分镜时：

字段	要求
`multi_shot`	必须为 `true`
`shot_type`	传 `customize`
`multi_prompt`	最少 1 个、最多 6 个分镜
`multi_prompt[].index`	从 1 开始连续递增
`multi_prompt[].prompt`	每个分镜的提示词
`multi_prompt[].duration`	单个分镜时长不小于 1，且所有分镜时长之和等于顶层 `duration`

主体引用使用 element_list，每个主体包含 name、description、element_input_urls；每个主体的 element_input_urls 至少 2 张、最多 4 张。可在 prompt 中用 @name 引用主体。

示例

curl https://api.vibelab.me/v1/videos/generations \
  -H "Authorization: Bearer $LOOPTOKEN_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "kling-v3",
    "prompt": "一只金色的猫咪在阳光下的草地上奔跑，慢动作，电影质感",
    "mode": "std",
    "duration": 5,
    "aspect_ratio": "16:9"
  }'

首尾帧图生视频示例：

{
  "model": "kling-v3",
  "prompt": "流畅的电影级画面过渡",
  "image_urls": [
    "https://example.com/frame-start.jpg",
    "https://example.com/frame-end.jpg"
  ],
  "mode": "std",
  "duration": 5
}

Kling v3

模型

请求字段

图生视频

多镜头分镜

示例

本页内容