# 画质增强（大模型版）

> 大模型驱动的生成式超分增强，最高 2K 输出。兼容火山云 AI MediaKit 官方格式。

画质增强大模型版使用生成式大模型做超分与画质重建，对低清、老旧素材的修复效果更强。仅支持分辨率、码率、帧率三类输出参数（无 `tool_version` / `scene` / `enhance_style` / `bit_depth`，误传会被忽略）。

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

## 请求体

| 字段 | 类型 | 必填 | 说明 |
| --- | --- | --- | --- |
| `video_url` | string | 是 | 源视频公网链接（`http(s)`，最长 1024 字符） |
| `resolution` | string | 是 | 输出分辨率档位：`720p` / `1080p` / `2k`（实际可用档位以账户开通为准） |
| `bitrate_level` | string | 否 | 码率档位：`low` / `medium` / `high`。与 `bitrate` 二选一 |
| `bitrate` | int | 否 | 目标码率（kbps），范围 `[10, 150000]`。与 `bitrate_level` 二选一 |
| `fps` | number | 否 | 目标帧率，范围 `[15, 120]` |

## 示例

<CodeGroup>

```bash cURL
curl -X POST "https://api.looprouter.com/api/aimediakit/api/v1/tools/enhance-video-generative" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $LOOPROUTER_API_KEY" \
  -d '{
    "video_url": "https://example.com/source.mp4",
    "resolution": "2k",
    "bitrate_level": "high",
    "fps": 30
  }'
```

```python Python
import requests

resp = requests.post(
    "https://api.looprouter.com/api/aimediakit/api/v1/tools/enhance-video-generative",
    headers={"Authorization": "Bearer sk-你的APIKey"},
    json={
        "video_url": "https://example.com/source.mp4",
        "resolution": "2k",
    },
)
print(resp.json())  # {"success": true, "task_id": "...", "request_id": "..."}
```

</CodeGroup>

## 响应

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

拿到 `task_id` 后轮询 [任务查询接口](/video-processing/aimediakit/get-task)。大模型版任务成功后的结果包含 `video_url`、`duration`、`resolution`、`fps`（**不含** `tool_version` 字段）。

## 相关页面

<CardGroup cols={2}>
  <Card title="画质增强（标准版 / 专业版）" icon="sparkles" href="/video-processing/aimediakit/enhance-video">
    传统增强管线，最高 8K 输出与高位深支持
  </Card>
  <Card title="任务查询" icon="magnifying-glass" href="/video-processing/aimediakit/get-task">
    轮询任务状态、获取成片链接
  </Card>
</CardGroup>