> ## 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 — 4K 文生视频

> 使用快手 Kling 3.0 从文本提示词生成 4K 视频。可选合成音频。

|           |                            |
| --------- | -------------------------- |
| **模型 ID** | `kuaishou/kling-v3-4k-t2v` |
| **系列**    | `kling-v3-novita`          |
| **任务**    | `text-to-video`            |
| **模态**    | 视频                         |
| **上游**    | Kuaishou Kling 3.0 (4K)    |

<Note>
  `sound: true` 会将按秒计费费率从 **$0.399/s**
      （无音频）切换为 **$0.599/s**（含音频）。默认值为 `false`。
</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="prompt" type="string" required>
  描述目标视频的文本提示词。最多 2500 个字符。
</ParamField>

<ParamField body="duration" type="integer" default="5">
  生成片段的时长（秒）。取值范围 `[3, 15]`。用于计费：`duration × rate`。
</ParamField>

<ParamField body="aspect_ratio" type="&#x22;16:9&#x22; | &#x22;9:16&#x22; | &#x22;1:1&#x22;" default="&#x22;16:9&#x22;">
  生成视频的宽高比。
</ParamField>

<ParamField body="sound" type="boolean" default="false">
  是否合成音轨。会将按秒费率从
  $0.399/s 切换为 $0.599/s。
</ParamField>

<ParamField body="cfg_scale" type="number" default="0.5">
  无分类器引导强度。取值范围 `[0, 1]`。值越高越严格地遵循提示词。
</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-4k-t2v",
    "prompt": "a calm beach at sunrise, gentle waves",
    "duration": 5,
    "aspect_ratio": "16:9",
    "sound": false
  }'
```

```json theme={null}
{ "id": "kling_001…", "status": "pending", "model": "kuaishou/kling-v3-4k-t2v" }
```

轮询直到进入终态：

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

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

## Reference