AI MediaKit 的画质增强（极速版）工具，集成了轻量级超分与智能画质增强能力。它采用速度优先的算法策略，在保证画质有效提升的同时，提供更快的处理速度，尤其适用于直播、短视频处理等对时延敏感的业务场景。

本篇开发指南将引导您：

快速体验将一段低清晰度视频提升至 720p。

理解并使用画质增强（极速版）工具的核心参数。

效果预览

通过画质增强（极速版），您可以显著改善视频的清晰度和观感。

输入视频（480p）	增强后视频（720p）
Replay Play 00:00 / 00:05 Live 00:00 Fullscreen Cssfullscreen 1x 2x 1.5x 1x 0.75x 0.5x Click and hold to drag	Replay Play 00:00 / 00:00 Live 00:00 Fullscreen Cssfullscreen 1x 2x 1.5x 1x 0.75x 0.5x Click and hold to drag

快速体验：将低清视频提升至 720p

本节演示如何将一段低分辨率视频，通过画质增强（极速版）工具快速提升至 720p 高清画质。

准备工作

获取访问凭证：在开始之前，访问 AI MediaKit 控制台 API Key 管理页面，创建并获取 MediaKit API Key（用于媒体处理功能鉴权）。

准备视频文件：准备一个待增强的视频文件，并将其上传至公网可访问的服务器或视频点播服务中，以获取可供 API 调用的 URL。若您尚未生成视频，请参考火山方舟视频生成文档完成视频生成并获取视频地址。

操作流程

画质增强是一个异步任务：

成功调用 POST /api/v1/tools/enhance-video-fast 后，API 将返回一个任务 ID。

您可以轮询 GET /api/v1/tasks/{task_id} ，直到任务状态status 变为 completed；或者使用事件回调自动接收任务状态变化。

任务完成后，您可解析 result 字段，在 video_url 字段处获取最终生成的视频文件下载地址。

第 1 步：提交任务

您需要调用提交画质增强（极速版）任务 API 提交任务。可直接复制以下 cURL 命令提交。

请求成功后，您会收到如下包含 task_id 的响应，请保存此 ID 用于后续查询。

第 2 步：获取结果

画质增强需要一定的处理时间。您需要轮询查询任务信息 API ，直到任务状态 status 变为 completed。

当任务成功完成后，您将收到如下响应。result 字段是一个 JSON 对象，您可以直接从其下的 video_url 字段获取增强后视频的下载地址（默认输出为 MP4 格式，有效期为 24 小时）。

进阶使用

配置输出分辨率

AI MediaKit 提供两种方式定义输出分辨率，两者互斥，不可同时配置。

方式	参数	说明
指定分辨率规格	resolution	适用于标准分发场景（如 720p、1080p、4k，最高支持 4k）。系统会自动将视频对齐到该预设规格。
短边像素限制	resolution_limit	适用于对产物尺寸有精确要求的工程场景。系统将锁定视频的短边像素值为设定值（取值范围 [128, 2160]），并在保持原视频宽高比的前提下，等比缩放至该限制值。示例：若原视频为 640x480 (4:3)，设置 resolution_limit 为 720，则输出视频的短边将提升至 720，宽度等比缩放至 960。

示例：将视频超分到 1080p

配置输出码率

输出码率决定了视频的视觉质量与最终文件体积。AI MediaKit 提供两种控制方式，二者同时指定时仅 bitrate 生效。

方式	参数	说明
码率档位	bitrate_level	按档位控制输出视频的目标平均码率，可选 low（低码率）、medium（中码率，推荐）、high（高码率），默认 medium。实际码率会结合目标分辨率与帧率自动换算，各档位对应的具体目标码率请参见码率参考表。
精确码率	bitrate	直接指定目标平均码率，单位 kbps，取值范围 [10, 150000]。适用于对码率有精确要求的工程场景。不填时按 bitrate_level 结合分辨率与帧率自动换算。

示例：精确指定输出码率为 8000 kbps

配置输出帧率

通过 fps 参数可以调整视频的目标帧率（单位 fps），取值范围为 [15, 120]。若不指定，将尽量保持与原片一致。为保证画面流畅自然，建议设置的目标帧率不要超过原视频帧率的 4 倍。

示例：将视频帧率统一为 30fps

参考信息

费用说明

画质增强（极速版）工具采用“按量计费”模式，基于输出文件时长，并结合任务的输出分辨率和输出帧率的计费换算系数进行计算。关于详细的计费规则、换算系数和计费示例，请参阅画质增强（按输出时长计费）。

任务耗时预估

任务处理时长与视频的原始时长相关。您可根据 RTF (Real-Time Factor) 系数预估任务耗时，即处理耗时与原片时长的比值。画质增强（极速版）工具的平均 RTF 约为 3。例如，一个 1 分钟的视频，处理耗时约 3 分钟。

使用限制

限制项

说明

输入视频限制

视频来源：支持公网 HTTP/HTTPS URL、本地上传 (mediakit://)、来源于火山引擎视频点播 (vod://) 和火山引擎对象存储 (tos://) 四种输入协议。关于各协议的具体说明和使用示例，请参阅多源媒体输入与本地上传。

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

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

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

短边范围：[360,1440]

长边范围：[360,2560]