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

# Kling AI · 概览

> 接口与可灵官网 API 兼容；字段说明以官网为准

核心说明

* **接口兼容性**：API 2.0 使用 `/kling/text-to-video/kling-3.0`、`/kling/image-to-video/kling-3.0` 与 `/kling/tasks`；旧 `/kling/v1/**` 接口继续兼容。
* **字段与示例**：详细字段、取值范围、约束条件以[官方文档](https://klingai.com/document-api/quickStart/productIntroduction/overview)为准。
* **任务 ID 契约**：创建响应中 `task_id` 为上游原始任务 ID，`platform_id` 为 Xuwu 平台统一追踪 ID（`video_<ULID>` 或 `image_<ULID>`）。查询接口同时接受上游 `task_id`、平台 `platform_id` 和 `external_task_id`。
* **主要能力**：
  * 文生视频（text2video）
  * 图生视频（image2video）
  * Omni 视频（omni-video）
  * 动作控制（motion-control）
  * 多图参考生视频（multi-image2video）
  * 视频特效（video-effects）
  * 视频延长（video-extend）
  * 对口型（advanced-lip-sync）
  * 图像生成（generations）
  * Omni 图像（omni-image）
  * 多图参考生图（multi-image2image）
  * 多模态视频编辑（multi-elements）

计费说明

* 采用"终态实扣，失败不扣"的异步计费模式；
* 创建任务仅落库，不对用户/Token 实际扣费；
* 当任务进入终态（成功/失败）后，由后台轮询器一次性结算，仅成功任务会扣费；
* 当上游响应包含 `final_unit_deduction` 时：
  * 视频按积分计费：1 积分 = 1 元
  * 图像按积分计费：1 积分 = 0.025 元
* 若响应不含 `final_unit_deduction`，任务不计费并标记为结算失败。
* 仅保留两类积分 SKU：`kling-video-points`（视频）与 `kling-image-points`（图像）。
* API 2.0 的 Kling 3.0 视频成功后按 `duration × 官方 Units/秒` 结算；`billing[]` 仅作为上游消费证据。

官方链接

* [可灵 API 开放平台](https://klingai.com/document-api/quickStart/productIntroduction/overview)
* [API 鉴权](https://klingai.com/document-api/api/get-started/authentication)
* [视频价格](https://klingai.com/document-api/pricing/base/video)
* [图片价格](https://klingai.com/document-api/pricing/base/image)
* [可灵 AI 官网](https://klingai.com/)

路由与认证

* **认证**：`Authorization: Bearer <Token>`
* **路由**：统一使用 `/kling` 前缀

支持的模型

视频模型

| 模型名称                | 适用场景                                                                      |
| ------------------- | ------------------------------------------------------------------------- |
| `kling-3.0`         | API 2.0 路径版本，仅用于 `/text-to-video/kling-3.0` 与 `/image-to-video/kling-3.0` |
| `kling-video-o1`    | Omni 视频生成                                                                 |
| `kling-v1`          | 文生/图生视频                                                                   |
| `kling-v1-5`        | 文生/图生视频                                                                   |
| `kling-v1-6`        | 文生/图生视频、多图参考生视频、多模态编辑                                                     |
| `kling-v2-master`   | 高级视频生成                                                                    |
| `kling-v2-1`        | 新一代视频生成                                                                   |
| `kling-v2-1-master` | 专业级视频生成                                                                   |
| `kling-v2-5-turbo`  | 新一代视频生成（Turbo）                                                            |
| `kling-v2-6`        | 新一代视频生成（支持声音/动作控制）                                                        |
| `kling-v3`          | Kling 3.0 视频生成、动作控制                                                       |
| `kling-v3-omni`     | Kling 3.0 Omni 视频生成，仅用于 `/videos/omni-video`                              |

图像模型

| 模型名称             | 适用场景                                          |
| ---------------- | --------------------------------------------- |
| `kling-image-o1` | Omni 图像生成                                     |
| `kling-v1`       | 文生图/图生图                                       |
| `kling-v1-5`     | 文生图/图生图（支持图片参考）                               |
| `kling-v2`       | 文生图/多图参考生图                                    |
| `kling-v2-new`   | 风格转绘（图生图）                                     |
| `kling-v2-1`     | 文生图/多图参考生图                                    |
| `kling-v3`       | Kling Image 3.0 文生图/图生图                       |
| `kling-v3-omni`  | Kling Image 3.0 Omni，仅用于 `/images/omni-image` |

> 说明：`kling-v1` / `kling-v1-5` / `kling-v2-1` / `kling-v3` 可在视频与图像能力中复用，实际计费以任务类型为准。`kling-v3-omni` 仅通过 Omni 视频 `/videos/omni-video` 与 Omni 图像 `/images/omni-image` 入口展示。历史输入 `kling-v2-5` 会归一为 `kling-v2-5-turbo`，不作为对外 canonical 模型展示。

当前暂不开放

| 能力                      | 当前状态                    | 说明                                                   |
| ----------------------- | ----------------------- | ---------------------------------------------------- |
| 旧接口的 Kling 3.0 Turbo 别名 | `blocked_pending_probe` | API 2.0 已使用独立的 `kling-3.0` 路径版本，不推断旧 `model_name` 别名 |
| 数字人、TTS、文生音效、视频生音效、音色定制 | `blocked_pending_probe` | 本期不开放音频/数字人任务，未绑定计费 SKU                              |
| 人脸识别、`identify-face`    | `blocked_pending_probe` | 涉及敏感能力；对口型前置识别流程本期不开放                                |
| 主体智能补全图、扩图、虚拟试穿、图像识别    | `blocked_pending_probe` | 未完成官方 schema、结果 contract 与真实扣费探针                     |
| 账户资源包/余额查询              | `blocked_pending_probe` | 不作为普通用户任务接口开放                                        |

快速上手

```bash theme={null}
# 文生视频（详细参数见官网）
curl -X POST "https://xuwuai.com/kling/v1/videos/text2video" \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "model_name": "kling-v1",
    "prompt": "夕阳下的海滩，海浪轻轻拍打沙滩",
    "mode": "std",
    "duration": "5",
    "aspect_ratio": "16:9"
  }'

# 查询任务
curl "https://xuwuai.com/kling/v1/videos/text2video/$TASK_ID" \
  -H "Authorization: Bearer $TOKEN"
```

页面导航

<CardGroup cols={2}>
  <Card title="API 2.0 · Kling 3.0" href="/kling/api2-kling3" icon="bolt" />

  <Card title="文生视频" href="/kling/text2video" icon="film" />

  <Card title="图生视频" href="/kling/image2video" icon="image" />

  <Card title="Omni 视频" href="/kling/omni-video" icon="video" />

  <Card title="动作控制" href="/kling/motion-control" icon="person-running" />

  <Card title="多图参考生视频" href="/kling/multi-image2video" icon="images" />

  <Card title="视频特效" href="/kling/video-effects" icon="wand-magic-sparkles" />

  <Card title="视频延长" href="/kling/video-extend" icon="forward" />

  <Card title="对口型" href="/kling/advanced-lip-sync" icon="microphone" />

  <Card title="图像生成" href="/kling/image-generation" icon="paintbrush" />

  <Card title="Omni 图像" href="/kling/omni-image" icon="image" />

  <Card title="多图参考生图" href="/kling/multi-image2image" icon="layer-group" />

  <Card title="多模态视频编辑" href="/kling/multi-elements" icon="wand-magic-sparkles" />

  <Card title="任务查询" href="/kling/task-query" icon="magnifying-glass" />
</CardGroup>