> ## 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](/cn/model-api/kuaishou/kling-3.0)             | [文生视频](/cn/api-reference/endpoint/kling-text-to-video) / [图生视频](/cn/api-reference/endpoint/kling-image-to-video) / [动作控制](/cn/api-reference/endpoint/kling-motion-control) | 普通生成至 4k；动作控制至 1080p |
| [Kling 3.0 Turbo](/cn/model-api/kuaishou/kling-3.0-turbo) | [文生视频](/cn/api-reference/endpoint/kling-text-to-video) / [图生视频](/cn/api-reference/endpoint/kling-image-to-video)                                                           | 720p / 1080p         |
| [Kling 3.0 Omni](/cn/model-api/kuaishou/kling-3.0-omni)   | [Omni 生成与编辑](/cn/api-reference/endpoint/kling-omni-video)                                                                                                                  | 720p / 1080p / 4k    |
| [Kling O1](/cn/model-api/kuaishou/kling-o1)               | [Omni 生成与编辑](/cn/api-reference/endpoint/kling-omni-video)                                                                                                                  | 720p / 1080p         |
| [Kling 2.6](/cn/model-api/kuaishou/kling-2.6)             | [文生视频](/cn/api-reference/endpoint/kling-text-to-video) / [图生视频](/cn/api-reference/endpoint/kling-image-to-video) / [动作控制](/cn/api-reference/endpoint/kling-motion-control) | 720p / 1080p         |
| [Kling 2.5 Turbo](/cn/model-api/kuaishou/kling-2.5-turbo) | [文生视频](/cn/api-reference/endpoint/kling-text-to-video) / [图生视频](/cn/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 任务](/cn/api-reference/endpoint/kling-tasks)。
