> ## Documentation Index
> Fetch the complete documentation index at: https://docs.vibetoken.cn/llms.txt
> Use this file to discover all available pages before exploring further.

# Kling 3.0 — 动作控制

> 使用快手 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) |

<Note>
  **`character_orientation` 为必填项，并决定输出时长。**

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

  计费按输出时长线性计算，费率为 \*\*$0.160/s**
      （VibeToken）/ $0.168/s（刊例价）。
</Note>

## Endpoint

```http theme={null}
POST https://vibetoken.cn/v1/videos/generations
```

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

## Parameters

<ParamField body="character_orientation" type="&#x22;image&#x22; | &#x22;video&#x22;" required default="&#x22;image&#x22;">
  驱动模式选择。

  * `image`：5 秒固定时长输出。
  * `video`：输出时长跟随参考视频（3–30 秒）。
</ParamField>

<ParamField body="image_urls" type="string[]" required>
  恰好一个主体图像 URL（HTTPS，PNG / JPEG）—— 即要制作动画的角色。
</ParamField>

<ParamField body="video_urls" type="string[]" required>
  恰好一个提供动作的参考视频 URL（HTTPS，MP4）。
</ParamField>

<ParamField body="prompt" type="string">
  可选的文本提示词，用于引导生成。最多 2500 个字符。
</ParamField>

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

<ParamField body="keep_original_sound" type="boolean" default="true">
  是否在输出中保留参考视频的音轨。
</ParamField>

<ParamField body="negative_prompt" type="string">
  引导模型避开的内容。最多 2500 个字符。
</ParamField>

## Example

```bash theme={null}
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
  }'
```

```json theme={null}
{ "id": "kling_mc_001…", "status": "pending", "model": "kuaishou/kling-v3-motion-control" }
```

轮询直到进入终态：

```bash theme={null}
curl https://vibetoken.cn/v1/videos/generations/kling_mc_001… \
  -H "Authorization: Bearer $VIBETOKEN_API_KEY"
```

```json theme={null}
{
  "id": "kling_mc_001…",
  "status": "success",
  "data": [{ "url": "https://…mp4" }]
}
```

## Reference