> ## 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 API 2.0 · Kling 3.0

> 路径版本接口：文生视频、图生视频与统一任务查询

本页接口对齐 Kling 官方 API 2.0。调用 Xuwu 时仍使用 Xuwu Token；平台选中的 Kling 渠道则使用官网 API Key 调用新加坡上游。

## 路由

| 能力      | 方法与路径                                                     |
| ------- | --------------------------------------------------------- |
| 文生视频    | `POST /kling/text-to-video/kling-3.0`                     |
| 图生视频    | `POST /kling/image-to-video/kling-3.0`                    |
| 按 ID 查询 | `GET /kling/tasks?task_ids=...` 或 `external_task_ids=...` |
| 游标查询    | `POST /kling/tasks`                                       |

API 2.0 的版本写在 URL 中，不传旧接口的 `model_name`。旧 `/kling/v1/**` 路由和 `kling-v3` 模型名继续兼容，两套协议不会互相转换。

## 文生视频

```bash theme={null}
curl -X POST "https://xuwuai.com/kling/text-to-video/kling-3.0" \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "prompt": "A train crossing a snowy valley at sunrise",
    "settings": {
      "resolution": "1080p",
      "aspect_ratio": "16:9",
      "duration": 5,
      "audio": "off",
      "multi_shot": true
    },
    "options": {
      "external_task_id": "order-20260811-001",
      "watermark_info": {"enabled": false}
    }
  }'
```

## 图生视频

```bash theme={null}
curl -X POST "https://xuwuai.com/kling/image-to-video/kling-3.0" \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "contents": [
      {"type": "prompt", "text": "The camera slowly pushes forward"},
      {"type": "first_frame", "url": "https://example.com/frame.png"}
    ],
    "settings": {"resolution": "720p", "duration": 5, "audio": "native"}
  }'
```

请求字段、枚举、输出和 `billing[]` 原样沿用[官方 Kling 3.0 文生视频](https://kling.ai/document-api/api/video/3-0-omni/text-to-video)与[图生视频](https://kling.ai/document-api/api/video/3-0-omni/image-to-video)契约。`options.callback_url` 会透传给 Kling，但仅允许公网 HTTPS 地址。

## 查询任务

```bash theme={null}
curl "https://xuwuai.com/kling/tasks?task_ids=$TASK_ID" \
  -H "Authorization: Bearer $TOKEN"
```

```bash theme={null}
curl -X POST "https://xuwuai.com/kling/tasks" \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"limit":100,"filters":[{"key":"status","values":["succeeded"]}]}'
```

查询只返回当前 Token 所属用户创建的 API 2.0 任务。按 ID 查询会从原任务的 Kling 渠道刷新官方结果；游标列表基于 Xuwu 已保存的任务快照，避免共享上游账号泄露其他租户任务。

## 计费

任务创建时不扣费；成功后按 `duration × 官方 Units/秒` 幂等结算到 `kling-video-points`，失败不扣费。

| 音频       |        720p |       1080p |          4K |
| -------- | ----------: | ----------: | ----------: |
| `off`    | 0.6 Units/秒 | 0.8 Units/秒 | 3.0 Units/秒 |
| `native` | 0.9 Units/秒 | 1.2 Units/秒 | 3.0 Units/秒 |

响应中的 `billing[]` 保留为 Kling 上游实际消费证据，不直接替代 Xuwu 客户价格。价格依据见[官方视频价格](https://kling.ai/document-api/pricing/base/video)。