AI MediaKit 的画质增强（极速版）工具，集成了轻量级超分与智能画质增强能力。它采用速度优先的算法策略，在保证画质有效提升的同时，提供更快的处理速度，尤其适用于直播、短视频处理等对时延敏感的业务场景。本篇开发指南将引导您： * 快速体验将一段低清晰度视频提升至 720p。 * 理解并使用画质增强（极速版）工具的核心参数。 ## 效果预览通过画质增强（极速版），您可以显著改善视频的清晰度和观感。 |输入视频（480p） |增强后视频（720p） | |---|---| |

| ## 快速体验：将低清视频提升至 720p 本节演示如何将一段低分辨率视频，通过画质增强（极速版）工具快速提升至 720p 高清画质。 ### 准备工作 1. **获取访问凭证**：在开始之前，访问 AI MediaKit 控制台 [API Key 管理页面](https://console.volcengine.com/imp/ai-mediakit/settings)，创建并获取 **MediaKit API Key**（用于媒体处理功能鉴权）。 2. **准备视频文件**：准备一个待增强的视频文件，并将其上传至公网可访问的服务器或[视频点播服务](https://www.volcengine.com/docs/4/2834?lang=zh)中，以获取可供 API 调用的 URL。若您尚未生成视频，请参考[火山方舟视频生成文档](https://www.volcengine.com/docs/82379/1366799?lang=zh)完成视频生成并获取视频地址。 ### 操作流程画质增强是一个异步任务： * 成功调用 `POST /api/v1/tools/enhance-video-fast` 后，API 将返回一个任务 ID。 * 您可以轮询 `GET /api/v1/tasks/{task_id}` ，直到任务状态`status` 变为 `completed`；或者使用[事件回调](https://docs.volcengine.com/docs/6448/2288701)自动接收任务状态变化。 * 任务完成后，您可解析 `result` 字段，在 `video_url` 字段处获取最终生成的视频文件下载地址。 #### 第 1 步：提交任务您需要调用[提交画质增强（极速版）任务 API](https://docs.volcengine.com/docs/6448/2487478) 提交任务。可直接复制以下 cURL 命令提交。 ```Bash curl -X POST 'https://mediakit.cn-beijing.volces.com/api/v1/tools/enhance-video-fast' \ --header 'Content-Type: application/json' \ --header 'Authorization: Bearer {Your_API_Key}' \ --data '{ "video_url": "https://example.com/source_video.mp4", "resolution": "720p" }' ```

说明

需替换参数：

将 {Your_API_Key} 替换为您的有效 API Key。

将 video_url 替换为您真实的视频文件地址。

请求成功后，您会收到如下包含 `task_id` 的响应，请保存此 ID 用于后续查询。 ```JSON { "success": true, "task_id": "amk-tool-enhance-video-fast-987654", "request_id": "20240523110000ABCDEFG67890" } ``` #### 第 2 步：获取结果画质增强需要一定的处理时间。您需要轮询[查询任务信息 API](https://docs.volcengine.com/docs/6448/2278532) ，直到任务状态 `status` 变为 `completed`。 ```Bash curl -X GET 'https://mediakit.cn-beijing.volces.com/api/v1/tasks/{task_id}' \ --header 'Authorization: Bearer {Your_API_Key}' ``` 当任务成功完成后，您将收到如下响应。`result` 字段是一个 JSON 对象，您可以直接从其下的 `video_url` 字段获取增强后视频的下载地址（默认输出为 **MP4** 格式，有效期为 **24** 小时）。 ```JSON { "success": true, "task_id": "amk-tool-enhance-video-fast-987654", "request_id": "20240523110000ABCDEFG67890", "status": "completed", "result": { "video_url": "https://example.volcvideo.com/fast_enhanced_output.mp4?auth_key=...", "duration": 65.5, "resolution": "720p", "fps": 30 }, "expires_at": 1777531298, "created_at": 1777358413, "finished_at": 1777359999 } ``` ## 进阶使用 ### 配置输出分辨率 AI MediaKit 提供两种方式定义输出分辨率，两者互斥，不可同时配置。 |方式 |参数 |说明 | |---|---|---| |指定分辨率规格 |`resolution` |适用于标准分发场景（如 `720p`、`1080p`、`4k`，最高支持 `4k`）。系统会自动将视频对齐到该预设规格。 | |短边像素限制 |`resolution_limit` |适用于对产物尺寸有精确要求的工程场景。系统将锁定视频的**短边像素值**为设定值（取值范围 `[128, 2160]`），并在保持原视频宽高比的前提下，等比缩放至该限制值。示例：若原视频为 640x480 (4:3)，设置 `resolution_limit` 为 720，则输出视频的短边将提升至 720，宽度等比缩放至 960。 | #### 示例：将视频超分到 1080p ```Bash curl -X POST 'https://mediakit.cn-beijing.volces.com/api/v1/tools/enhance-video-fast' \ --header 'Content-Type: application/json' \ --header 'Authorization: Bearer {Your_API_Key}' \ --data '{ "video_url": "https://example.com/source_video.mp4", "resolution": "1080p" }' ``` ### 配置输出码率输出码率决定了视频的视觉质量与最终文件体积。AI MediaKit 提供两种控制方式，二者同时指定时**仅 ** **`bitrate`** ** 生效**。 |方式 |参数 |说明 | |---|---|---| |码率档位 |`bitrate_level` |按档位控制输出视频的目标平均码率，可选 `low`（低码率）、`medium`（中码率，推荐）、`high`（高码率），默认 `medium`。实际码率会结合目标分辨率与帧率自动换算，各档位对应的具体目标码率请参见[码率参考表](https://docs.volcengine.com/docs/6448/2487478#00e249e4)。 | |精确码率 |`bitrate` |直接指定目标平均码率，单位 kbps，取值范围 `[10, 150000]`。适用于对码率有精确要求的工程场景。不填时按 `bitrate_level` 结合分辨率与帧率自动换算。 | #### 示例：精确指定输出码率为 8000 kbps ```Bash curl -X POST 'https://mediakit.cn-beijing.volces.com/api/v1/tools/enhance-video-fast' \ --header 'Content-Type: application/json' \ --header 'Authorization: Bearer {Your_API_Key}' \ --data '{ "video_url": "https://example.volcengine.com/source.mp4", "resolution": "1080p", "bitrate": 8000 }' ``` ### 配置输出帧率通过 `fps` 参数可以调整视频的目标帧率（单位 fps），取值范围为 `[15, 120]`。若不指定，将尽量保持与原片一致。为保证画面流畅自然，建议设置的目标帧率不要超过原视频帧率的 4 倍。 #### 示例：将视频帧率统一为 30fps ```Bash curl -X POST 'https://mediakit.cn-beijing.volces.com/api/v1/tools/enhance-video-fast' \ --header 'Content-Type: application/json' \ --header 'Authorization: Bearer {Your_API_Key}' \ --data '{ "video_url": "https://example.com/source_video.mp4", "resolution": "720p", "fps": 30 }' ``` ## 参考信息 ### 费用说明画质增强（极速版）工具采用“按量计费”模式，基于**输出文件时长**，并结合任务的输出分辨率和输出帧率的**计费换算系数**进行计算。关于详细的计费规则、换算系数和计费示例，请参阅[画质增强（按输出时长计费）](https://docs.volcengine.com/docs/6448/2486473#760d5411)。 ### **任务耗时预估** 任务处理时长与视频的原始时长相关。您可根据 RTF (Real\-Time Factor) 系数预估任务耗时，即处理耗时与原片时长的比值。画质增强（极速版）工具的平均 RTF 约为 **3**。例如，一个 1 分钟的视频，处理耗时约 3 分钟。 ### 使用限制 |限制项 |说明 | |---|---| |输入视频限制 |* **视频来源**：支持公网 HTTP/HTTPS URL、本地上传 (`mediakit://`)、来源于火山引擎视频点播 (`vod://`) 和火山引擎对象存储 (`tos://`) 四种输入协议。关于各协议的具体说明和使用示例，请参阅[多源媒体输入与本地上传](https://docs.volcengine.com/docs/6448/2536893)。

* **支持格式**：`mp4`, `flv`, `ts`, `avi`, `mov`, `wmv`, `mkv` 等主流视频格式。

* **文件大小**：建议单个输入文件大小不超过 10 GB。

* **输入视频分辨率**：最高支持 2K。具体规格要求：

* 短边范围：[360,1440]

* 长边范围：[360,2560] | ## 相关 API 文档 * [提交画质增强（极速版）任务 API](https://docs.volcengine.com/docs/6448/2487478) * [查询任务信息 API](https://docs.volcengine.com/docs/6448/2278532) * [事件回调](https://docs.volcengine.com/docs/6448/2288701)