> ## 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 Omni — 参考生视频

> 使用快手 Kling 4.0 Omni，以最多 10 张参考图片和 5 段参考视频为引导，生成或编辑 3–30 秒视频。

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

> [!NOTE]
>
> Kling 4.0 Omni 依据你的提示词，以**参考图片**和**参考视频**为引导生成片段，或对一段
> **基础视频**进行编辑。提示词按 id 引用每路输入：参考图片为 `@image1`、`@image2`……，
> 参考视频为 `@video1`、`@video2`……（均按数组顺序编号），被编辑的视频为 `@base`。

## 计费

按视频秒数计费，每秒费率由分辨率决定。

* **无视频输入**：按生成的秒数、以标准费率计费。
* **含视频输入**（`video_urls` 或 `base_video_url`）：以单独的视频输入费率，按输入与输出
  秒数计费。输入视频不长于输出时，计费秒数为输出秒数的两倍；否则为输入秒数加输出秒数。

提交时会测量输入视频的时长，并按该请求可能产生的最高费用从余额中预扣；最终按实际时长
结算，且不会超过预扣金额。生成失败不收费。当前每秒费率请见[定价页](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`。

## 参数

**prompt** `string` *required*

描述目标片段或所需编辑的文本提示词。最多 26000 个字符。用 `@image1` …、`@video1` …
和 `@base` 引用各路输入。

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

最多 10 张参考图片 URL（公网 HTTPS）。在提示词中按数组顺序记为 `@image1`、`@image2`……

**video\_urls** `string[]`

最多 5 段参考视频 URL（公网 HTTPS）。在提示词中按数组顺序记为 `@video1`、`@video2`……
按视频输入费率计费。

**base\_video\_url** `string`

待编辑视频的公网 HTTPS URL。在提示词中记为 `@base`。按视频输入费率计费。

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

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

**aspect\_ratio** `"adaptive" | "16:9" | "9:16" | "1:1" | "21:9"` (default: "adaptive")

生成视频的宽高比。`adaptive` 让模型按输入自动匹配。

**duration** `integer`

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

该模型不支持的选项不会转发给它。

## 示例

参照一张参考图片，为基础视频更换风格：

```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-omni",
    "prompt": "把 @base 改成 @image1 的水彩风格，保留原有的镜头运动",
    "image_urls": ["https://example.com/style-reference.png"],
    "base_video_url": "https://example.com/base-clip.mp4",
    "resolution": "1080p"
  }'
```

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

轮询直到进入终态：

```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.