# 画质增强（标准版 / 专业版）

> 提升视频清晰度、色彩与码率表现，最高 8K 输出，专业版支持 10/12/16 位深。兼容火山云 AI MediaKit 官方格式。

画质增强对原片做整体画质提升——优化清晰度、细节与色彩表现，并可指定输出分辨率、码率、帧率。标准版与专业版**共用同一接口**，由 `tool_version` 区分（缺省即标准版）；专业版额外支持高位深输出。

```
POST /api/aimediakit/api/v1/tools/enhance-video
```

## 请求体

| 字段 | 类型 | 必填 | 默认 | 适用版本 | 说明 |
| --- | --- | --- | --- | --- | --- |
| `video_url` | string | 是 | — | 全部 | 源视频公网链接（`http(s)`，最长 1024 字符） |
| `tool_version` | string | 否 | `standard` | — | `standard`(标准版) / `professional`(专业版) |
| `scene` | string | 否 | — | **仅标准版** | 增强场景 |
| `enhance_style` | string | 否 | — | 标准版 + 专业版 | 增强风格 |
| `resolution` | string | 是 | — | 全部 | 输出分辨率档位：`720p` / `1080p` / `2k` / `4k` / `8k`（实际可用档位以账户开通为准） |
| `bitrate_level` | string | 否 | — | 全部 | 码率档位：`low` / `medium` / `high`。与 `bitrate` 二选一 |
| `bitrate` | int | 否 | — | 全部 | 目标码率（kbps），范围 `[10, 150000]`。与 `bitrate_level` 二选一 |
| `fps` | number | 否 | — | 全部 | 目标帧率，范围 `[15, 120]` |
| `bit_depth` | int | 否 | — | **仅专业版** | 输出位深：`8` / `10` / `12` / `16` |

<Warning>
- `bitrate` 与 `bitrate_level` **至多提供其一**，同时提供会返回参数错误。
- `scene` 仅标准版接受；`bit_depth` 仅专业版接受——版本不匹配会返回参数错误。
</Warning>

## 示例

### 专业版

```bash cURL
curl -X POST "https://api.looprouter.com/api/aimediakit/api/v1/tools/enhance-video" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $LOOPROUTER_API_KEY" \
  -d '{
    "video_url": "https://example.com/source.mp4",
    "tool_version": "professional",
    "enhance_style": "sharp",
    "resolution": "1080p",
    "bitrate": 8000,
    "fps": 30,
    "bit_depth": 10
  }'
```

### 标准版

```bash cURL
curl -X POST "https://api.looprouter.com/api/aimediakit/api/v1/tools/enhance-video" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $LOOPROUTER_API_KEY" \
  -d '{
    "video_url": "https://example.com/source.mp4",
    "tool_version": "standard",
    "scene": "film",
    "enhance_style": "natural",
    "resolution": "720p",
    "bitrate_level": "high",
    "fps": 25
  }'
```

## 响应

```json
{
  "success": true,
  "task_id": "vg_9f8c1e2b7a6d4f30",
  "request_id": "b1e6c2f0-3a4d-4e5f-8a90-1234567890ab"
}
```

拿到 `task_id` 后轮询 [任务查询接口](/video-processing/aimediakit/get-task)。任务成功后，结果中的 `tool_version` 会回填 `standard` / `professional`，`resolution`、`fps` 回填实际输出规格。

## 相关页面

<CardGroup cols={2}>
  <Card title="画质增强（大模型版）" icon="microchip-ai" href="/video-processing/aimediakit/enhance-video-generative">
    大模型驱动的生成式超分增强
  </Card>
  <Card title="任务查询" icon="magnifying-glass" href="/video-processing/aimediakit/get-task">
    轮询任务状态、获取成片链接
  </Card>
</CardGroup>