Kling 3.0 — 动作控制


Model ID	`kuaishou/kling-v3-motion-control`
Family	`kling-v3-novita`
Task	`motion-control`
Modality	Video
Upstream	Kuaishou Kling 3.0 (Pro motion control)

character_orientation 为必填项，并决定输出时长。

image — 无论 duration 为何，输出固定为 5 秒。
video — 输出与参考视频的长度一致 （3–30 秒）。VibeToken playground 会探测参考片段并预填 duration；直接调用 API 的用户应发送与其想要计费时长相匹配的 duration。

计费按输出时长线性计算，费率为 **

0.160/s** （VibeToken）/

0.168/s（刊例价）。

Endpoint

POST https://vibetoken.cn/v1/videos/generations

异步 — 返回 {id, status: "pending"}；轮询 GET /v1/videos/generations/{id}，直到状态为 success 或 failed。

Parameters

"image" | "video"

默认值:"\"image\""

必填

驱动模式选择。

image：5 秒固定时长输出。
video：输出时长跟随参考视频（3–30 秒）。

string[]

必填

恰好一个主体图像 URL（HTTPS，PNG / JPEG）—— 即要制作动画的角色。

string[]

必填

恰好一个提供动作的参考视频 URL（HTTPS，MP4）。

string

可选的文本提示词，用于引导生成。最多 2500 个字符。

integer

默认值:"5"

生成片段的长度（秒）。取值范围 [3, 30]。在 image 模式下此项被忽略（输出固定为 5 秒）。在 video 模式下，该值应与参考视频的长度一致 —— 用于计费。

boolean

默认值:"true"

是否在输出中保留参考视频的音轨。

string

引导模型避开的内容。最多 2500 个字符。

Example

curl https://vibetoken.cn/v1/videos/generations \
  -H "Authorization: Bearer $VIBETOKEN_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "kuaishou/kling-v3-motion-control",
    "character_orientation": "video",
    "image_urls": ["https://example.com/character.jpg"],
    "video_urls": ["https://example.com/motion-ref.mp4"],
    "duration": 8,
    "keep_original_sound": true
  }'

{ "id": "kling_mc_001…", "status": "pending", "model": "kuaishou/kling-v3-motion-control" }

轮询直到进入终态：

curl https://vibetoken.cn/v1/videos/generations/kling_mc_001… \
  -H "Authorization: Bearer $VIBETOKEN_API_KEY"

{
  "id": "kling_mc_001…",
  "status": "success",
  "data": [{ "url": "https://…mp4" }]
}

快速开始

API 参考

Kling 3.0 — 动作控制

Endpoint

Parameters

Example

Reference

​Endpoint

​Parameters

​Example

​Reference

Endpoint

Parameters

Example

Reference