> ## 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 4.0 — 图生视频

> 使用快手 Kling 4.0 多关键帧图生视频，将首帧、最多 8 张中间帧与尾帧生成 3–30 秒、720p 或 1080p 视频。

| | |
| - | - |
| **模型 ID** | `kuaishou/kling-v4-i2v` |
| **系列** | `kling-v4` |
| **任务** | `image-to-video` |
| **模态** | 视频 |
| **上游** | Kuaishou Kling 4.0 |

> [!NOTE]
>
> Kling 4.0 图生视频接收**关键帧**：一张首帧、最多 8 张中间帧以及可选的尾帧，合计
> **最多 10 张图片**。视频会按顺序依次经过这些关键帧。
>
> 按实际生成的视频秒数计费，每秒费率由分辨率决定。提交时会按该请求可能产生的最高费用
> 从余额中预扣；最终按实际时长结算，且不会超过预扣金额。生成失败不收费。
> 当前每秒费率请见[定价页](https://vibetoken.cn/pricing)。

## Endpoint

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

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

## 参数

**image\_urls** `string[]` *required*

单元素数组，内含首帧图片 URL（公网 HTTPS）。在提示词中记为 `@first`。

**middle\_image\_urls** `string[]`

最多 8 张中间关键帧的 URL，按视频依次到达的顺序排列。在提示词中按数组顺序记为
`@middle1`、`@middle2`……

**end\_image** `string`

尾帧的公网 HTTPS URL。在提示词中记为 `@last`。

**prompt** `string`

可选的文本提示词，描述关键帧之间的运动。最多 26000 个字符。可用 id 引用各帧
（`@first`、`@middle1` … `@middleN`、`@last`）。

**resolution** `"720p" | "1080p"` (default: "1080p")

输出分辨率。每档各有独立的每秒费率。

**duration** `integer`

片段时长（秒），取值范围 `[3, 30]`。省略时由 Kling 决定时长：此时预扣按最长片段
（30 秒）计算，实际扣费按生成的时长结算。

此任务没有 `aspect_ratio` 参数。该模型不支持的选项不会转发给它。

## 示例

```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-v4-i2v",
    "prompt": "从 @first 开始，镜头平滑掠过 @middle1 和 @middle2，最终停在 @last",
    "image_urls": ["https://example.com/frame-first.png"],
    "middle_image_urls": [
      "https://example.com/frame-middle-1.png",
      "https://example.com/frame-middle-2.png"
    ],
    "end_image": "https://example.com/frame-last.png",
    "resolution": "720p",
    "duration": 8
  }'
```

```json theme={null}
{ "id": "task_abc123…", "status": "pending", "model": "kuaishou/kling-v4-i2v" }
```

轮询直到进入终态：

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

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


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.