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

# Kling 概览

> Kling 原生接口、支持型号、通用选项、计费与接入流程。

使用 MixRoute API Key，以 `Authorization: Bearer $MIXROUTE_API_KEY` 认证，请求体为 JSON。模型 ID 位于 URL 中，不在请求体中重复传 `model`；不添加 `/v1`，也不使用 `metadata` 包装。

## 支持模型

| 模型 | 生成端点 | 分辨率 |
| - | - | - |
| [Kling 3.0](/zh-hans/model-api/kuaishou/kling-3.0) | [文生视频](/zh-hans/api-reference/endpoint/kling-text-to-video) / [图生视频](/zh-hans/api-reference/endpoint/kling-image-to-video) / [动作控制](/zh-hans/api-reference/endpoint/kling-motion-control) | 普通生成至 4k；动作控制至 1080p |
| [Kling 3.0 Turbo](/zh-hans/model-api/kuaishou/kling-3.0-turbo) | [文生视频](/zh-hans/api-reference/endpoint/kling-text-to-video) / [图生视频](/zh-hans/api-reference/endpoint/kling-image-to-video) | 720p / 1080p |
| [Kling 3.0 Omni](/zh-hans/model-api/kuaishou/kling-3.0-omni) | [Omni 生成与编辑](/zh-hans/api-reference/endpoint/kling-omni-video) | 720p / 1080p / 4k |
| [Kling O1](/zh-hans/model-api/kuaishou/kling-o1) | [Omni 生成与编辑](/zh-hans/api-reference/endpoint/kling-omni-video) | 720p / 1080p |
| [Kling 2.6](/zh-hans/model-api/kuaishou/kling-2.6) | [文生视频](/zh-hans/api-reference/endpoint/kling-text-to-video) / [图生视频](/zh-hans/api-reference/endpoint/kling-image-to-video) / [动作控制](/zh-hans/api-reference/endpoint/kling-motion-control) | 720p / 1080p |
| [Kling 2.5 Turbo](/zh-hans/model-api/kuaishou/kling-2.5-turbo) | [文生视频](/zh-hans/api-reference/endpoint/kling-text-to-video) / [图生视频](/zh-hans/api-reference/endpoint/kling-image-to-video) | 720p / 1080p |

只使用账户模型列表中可用的完整型号。端点与模型必须匹配：例如 `kling-3.0-omni` 和 `kling-o1` 走 `omni-video`，不能走普通文生/图生端点；动作控制使用 `kling-3.0` 或 `kling-2.6`，不是独立的 motion 型号。

## 调用流程

1. 按所需功能选择生成端点，提交原生请求体。
2. 检查 HTTP 状态和 JSON `code`，`code=0` 表示请求成功。
3. 保存提交响应中的 `data.id`，每次只查询一个网关任务 ID。
4. 任务 `succeeded` 后读取 `data[0].outputs` 中 `type=video` 的 `url`。
5. 读取结果 CDN 时不要携带 MixRoute Key。提交超时不代表没有创建任务，不要自动重复提交。

## 通用选项

| 字段 | 类型 | 必填 | 说明 |
| - | - | - | - |
| `options` | object | 否 | 通用配置对象。 |
| `options.watermark_info.enabled` | boolean | 否 | 默认 false；true 时额外提供带水印的结果。不支持自定义水印。 |
| `options.external_task_id` | string | 否 | 自定义业务标识，须在上游账户内唯一；不替换网关任务 ID，不作为幂等键使用，MixRoute 不支持用它查询。 |
| `options.callback_url` | string | 否 | 任务通知地址，原样透传给上游。回调中的 ID 是上游 ID，不等同于提交返回的网关 data.id；不要根据 ID 前缀判断归属，网关任务以轮询为准。 |

## 默认值与参数层级

网关省略值处理：`settings.resolution` 补 `720p`；除动作控制外，`settings.duration` 补 `5`。文生视频默认画幅为 `16:9`。图生、Omni、动作控制的提示词放在 `contents` 的 `type=prompt` 项中；只有文生视频使用顶层 `prompt`。显式填写影响计费的参数，尤其是 2.6 原生音频所需的 `1080p`。

参数名和枚举值区分大小写。网关不会把超出枚举的值静默改为另一规格；各型号的参数范围仍须满足对应接口限制。Element 和 voice ID 必须可被实际路由的上游账户访问，不能假设个人可灵账户里的资产自动共享。

## 计费

以下为美元/生成秒的基础单价。最终费用以 [模型广场](https://console.mixroute.ai/models) 当前定价、账户分组倍率和控制台账单为准；不包含资源包或账户专属折扣。

| 模型 | 档位 | 720p | 1080p | 4k |
| - | - | - | - | - |
| `kling-3.0` | 静音 | 0.084 | 0.112 | 0.42 |
| `kling-3.0` | 原生音频 | 0.126 | 0.168 | 0.42 |
| `kling-3.0` | 动作控制 | 0.126 | 0.168 | 不支持 |
| `kling-3.0-turbo` | 原生音频 | 0.112 | 0.14 | 不支持 |
| `kling-3.0-omni` | 无视频输入 / 静音 | 0.084 | 0.112 | 0.42 |
| `kling-3.0-omni` | 无视频输入 / 原生音频 | 0.112 | 0.14 | 0.42 |
| `kling-3.0-omni` | 有视频输入 | 0.126 | 0.168 | 0.42 |
| `kling-o1` | 无视频输入 | 0.084 | 0.112 | 不支持 |
| `kling-o1` | 有视频输入 | 0.126 | 0.168 | 不支持 |
| `kling-2.6` | 静音 | 0.042 | 0.07 | 不支持 |
| `kling-2.6` | 原生音频 | 不支持 | 0.14 | 不支持 |
| `kling-2.6` | 原生音频 + 音色 | 不支持 | 0.168 | 不支持 |
| `kling-2.6` | 动作控制 | 0.07 | 0.112 | 不支持 |
| `kling-2.5-turbo` | 静音 | 0.042 | 0.07 | 不支持 |

提交时预扣，完成后按 `outputs[].duration` 的实际生成秒数结算，保留小数秒而非仅按请求的整数时长。动作控制按 15 秒预扣，完成后按实际输出时长多退少补；失败或超时任务退回预扣额度。原生响应中的 `billing` 为可选上游字段，不能当作 MixRoute 最终实扣凭证。`不支持` 不代表免费。

任务状态、失败原因和完整轮询示例见 [查询 Kling 任务](/zh-hans/api-reference/endpoint/kling-tasks)。


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