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

# Kling 4.0

> Kling 4.0 视频生成，支持 3-30 秒输出、多关键帧和 Omni 参考。

Kling 4.0 支持文生视频、关键帧图生视频及 Omni 参考生成／编辑。API 当前提供 720p、1080p，不提供 4k。Kling 4.0 Flash 是另一项产品能力，不能由这个模型 ID 推断支持。

使用 MixRoute Bearer Key 认证。kling-4.0 放在接口路径中，不放在请求体 model 字段；保留原生 prompt/contents、settings、options 结构，不包裹 metadata。这些接口不代表 Kling 4.0 已支持 motion-control。

## 模型规格

| 字段 | 说明 |
| - | - |
| `ID` | kling-4.0 |
| `POST` | [文生视频](https://mixroute.ai/docs/zh-Hans/api-reference/endpoint/kling-text-to-video.md) / [图生视频](https://mixroute.ai/docs/zh-Hans/api-reference/endpoint/kling-image-to-video.md) / [Omni 参考与编辑](https://mixroute.ai/docs/zh-Hans/api-reference/endpoint/kling-omni-video.md) |

## 通用设置与选项

| 字段 | 说明 |
| - | - |
| `settings.resolution` | 720p 或 1080p。厂商默认 1080p；在 MixRoute 请求中应显式指定，不沿用旧网关默认值。 |
| `settings.duration` | 3-30 的整数秒。厂商优先采用显式设置，其次为提示词中指定的时长，否则 10 秒。Omni 编辑在回退到 10 秒前，会采用四舍五入后的 base\_video 时长。显式指定可避免歧义。 |
| `options` | 通用选项仍为 options.callback\_url、options.external\_task\_id、options.watermark\_info.enabled。自定义任务 ID 不是 MixRoute 轮询 ID，也不代表请求具备幂等性。 |

纯英文最多 26,000 字符，纯非英文最多 11,000 字符；混合输入须满足 `E / 26000 + N / 11000 <= 1`。在提示词中描述动作顺序和镜头变化，不要照搬旧版 multi\_shot 开关。 E 为英文字符数，N 为非英文字符数。

> [!NOTE]
>
> 4.0 文生／图生接口没有 audio、multi\_shot 开关。省略 settings.audio 和 settings.multi\_shot，不要传旧版 audio=off 配置。

## 文生视频

| 字段 | 说明 |
| - | - |
| `prompt` | 必填的顶层 prompt。文生视频接口不接收媒体输入。 |
| `settings.aspect_ratio` | 21:9、16:9、9:16、1:1，厂商默认 16:9；文生视频接口不要传 adaptive。 |

设置 MIXROUTE\_API\_KEY，并将 example.com 图片地址替换为可访问的素材。仅提交一次；超时不代表任务未创建。

```bash theme={null}
curl --request POST "https://api.mixroute.ai/kling/text-to-video/kling-4.0" \
  --header "Authorization: Bearer $MIXROUTE_API_KEY" \
  --header "Content-Type: application/json" \
  --data '{
  "prompt": "A red ceramic mug slowly rotates on a white tabletop. Static camera, soft studio lighting.",
  "settings": {
    "resolution": "720p",
    "duration": 3,
    "aspect_ratio": "16:9"
  }
}'
```

## 图生视频

使用 prompt 项和 first\_frame、middle\_frame、last\_frame 图片项。图片用 url；可选的唯一 id 可在提示词中以 @id 引用。图片和提示词引用按时间顺序排列；本协议不要求额外 timestamp 字段。

最多 10 张图片；JPG/JPEG/PNG，每张不超过 30 MB，宽高均至少 300 px，宽高比 2:5 至 5:2。使用公开 URL 或 Base64。图生接口没有 settings.aspect\_ratio；视频、Element 和音色参考使用 Omni。

```bash theme={null}
curl --request POST "https://api.mixroute.ai/kling/image-to-video/kling-4.0" \
  --header "Authorization: Bearer $MIXROUTE_API_KEY" \
  --header "Content-Type: application/json" \
  --data '{
  "contents": [
    {
      "type": "prompt",
      "text": "The scene moves smoothly from @start through @middle to @end."
    },
    {
      "type": "first_frame",
      "id": "start",
      "url": "https://example.com/first-frame.png"
    },
    {
      "type": "middle_frame",
      "id": "middle",
      "url": "https://example.com/middle-frame.png"
    },
    {
      "type": "last_frame",
      "id": "end",
      "url": "https://example.com/last-frame.png"
    }
  ],
  "settings": {
    "resolution": "720p",
    "duration": 5
  }
}'
```

## Omni 参考与编辑

必须包含 prompt 项。支持 first\_frame、middle\_frame、last\_frame、refer\_image、feature\_video、base\_video、element、voice。图片／视频使用 url，Element 使用 element\_id，音色使用 voice\_id。设置唯一 id 并以 @id 引用；素材 ID 须对所路由的上游账户可访问。

element 和 voice 项除了 element\_id 或 voice\_id，还必须填写 id。

Omni 中有多个 middle\_frame 或 refer\_image 时，图片 id 必填。first\_frame、last\_frame、refer\_image 混用时，首帧应是第一张图片，尾帧是最后一张。

| 字段 | 说明 |
| - | - |
| `settings.aspect_ratio` | 21:9、16:9、9:16、1:1 或 adaptive（厂商默认）。显式画幅优先；adaptive 按提示词、base\_video、关键帧、feature\_video 的顺序取值，多参考视频或无适用来源时回退到 16:9。 |
| `settings.audio` | native（厂商默认）或 original。original 要求 base\_video 或 feature\_video，且不能带 voice 参考；优先保留 base\_video 音频，否则取第一个 feature\_video。off 和 multi\_shot 不是 4.0 参数。 |

### 媒体限制

图片、视频、Element、音色合计最多 15 项。图片最多 10 张；参考视频最多 5 个，视频角色 Element 同时占用这个上限。Element 最多 7 个，其中视频角色最多 3 个；音色最多 3 个；base\_video 最多 1 个。

JPG/JPEG/PNG，每张不超过 30 MB，宽高均至少 300 px，宽高比 2:5 至 5:2。使用公开 URL 或 Base64。

MP4/MOV，每个不超过 300 MB；单个视频和视频总时长均为 3-30 秒，总时长包括视频角色 Element。宽高 700-4553 px，总像素不超过 8,294,400，宽高比 2:5 至 5:2；输入 24-60 fps，输出 24 fps。

```bash theme={null}
curl --request POST "https://api.mixroute.ai/kling/omni-video/kling-4.0" \
  --header "Authorization: Bearer $MIXROUTE_API_KEY" \
  --header "Content-Type: application/json" \
  --data '{
  "contents": [
    {
      "type": "prompt",
      "text": "A slow camera move around the ceramic mug in @mug on a white tabletop."
    },
    {
      "type": "refer_image",
      "id": "mug",
      "url": "https://example.com/mug.png"
    }
  ],
  "settings": {
    "resolution": "720p",
    "duration": 5,
    "aspect_ratio": "adaptive",
    "audio": "native"
  }
}'
```

## 任务结果

检查 HTTP 状态及 code=0，保存提交响应的 data.id，使用这个 MixRoute 任务 ID 单独查询。succeeded 后从 data\[0].outputs 的 type=video 项读取 URL；不要把 API Key 发给结果 CDN。

```bash theme={null}
curl --get "https://api.mixroute.ai/kling/tasks" \
  --header "Authorization: Bearer $MIXROUTE_API_KEY" \
  --data-urlencode "task_ids=$KLING_TASK_ID"
```

[任务结果](https://mixroute.ai/docs/zh-Hans/api-reference/endpoint/kling-tasks.md)

Kling 4.0 上游计费区分 input\_duration 和 output\_duration，输入时长包括参考视频和视频角色 Element。网关 usage 可能缺失或为空，不能只用 outputs\[].duration 推算 MixRoute 最终费用，也不要套用旧型号费率；以模型广场和账单为准。


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