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

# Kling AI · 概览

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

核心说明

* **接口兼容性**：`/kling` 前缀下的请求体、返回体与错误码与可灵官网 API 保持一致。
* **字段与示例**：详细字段、取值范围、约束条件以[官方文档](https://klingai.kuaishou.com/docs)为准。
* **任务 ID 契约**：创建响应中 `task_id` 为上游原始任务 ID，`platform_id` 为 One-Hub 平台统一追踪 ID（`video_<ULID>` 或 `image_<ULID>`）。查询接口同时接受上游 `task_id`、平台 `platform_id` 和 `external_task_id`。
* **主要能力**：
  * 文生视频（text2video）
  * 图生视频（image2video）
  * Omni 视频（omni-video）
  * 动作控制（motion-control）
  * 多图参考生视频（multi-image2video）
  * 图像生成（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 开放平台](https://klingai.kuaishou.com/docs)
* [可灵 AI官网](https://klingai.kuaishou.com/)

路由与认证

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

支持的模型

视频模型

| 模型名称                | 适用场景                  |
| ------------------- | --------------------- |
| `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`        | 新一代视频生成               |
| `kling-v2-5-turbo`  | 新一代视频生成（Turbo）        |
| `kling-v2-6`        | 新一代视频生成（支持声音/动作控制）    |

图像模型

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

> 说明：`kling-v1` / `kling-v1-5` / `kling-v2-1` 可在视频与图像接口中复用，实际计费以任务类型为准。

快速上手

```bash theme={null}
# 文生视频（详细参数见官网）
curl -X POST "https://models.hingnet.com.cn/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://models.hingnet.com.cn/kling/v1/videos/text2video/$TASK_ID" \
  -H "Authorization: Bearer $TOKEN"
```

页面导航

<CardGroup cols={2}>
  <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/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>