AI MediaKit 视频画质检测工具集成了火山引擎自研的 VQScore（Video Quality Score）无参考视频质量评价算法，无需原始参考视频，能够直接对视频的视觉质量进行客观打分，模拟人眼主观感受，输出贴近真实观感的质量分数。您可以利用此工具在视频生产、分发、消费等环节对画质进行量化评估与监控。本篇开发指南将引导您： * 快速体验检测一段视频的 VQScore 画质分数。 * 通过轮询或事件回调两种方式获取处理结果。 * 理解 VQScore 分数的含义及其应用场景。 ## 快速体验：获取一段视频的画质分数本节演示如何为一个指定的视频 URL 快速获取其 VQScore 画质分数。 ### 准备工作 1. **获取访问凭证**：在开始之前，访问 AI MediaKit 控制台 [API Key 管理页面](https://console.volcengine.com/imp/ai-mediakit/settings)，创建并获取 **AI MediaKit API Key**（用于媒体处理功能鉴权）。 2. **准备视频文件**：准备一个待检测的视频文件，并将其上传至公网可访问的服务器或[视频点播服务](https://www.volcengine.com/docs/4/2834?lang=zh)中，以获取可供 API 调用的 URL。 ### 操作流程视频画质检测是一个异步任务： * 成功调用 `POST /api/v1/tools/assess-video-quality` 后，API 将返回一个任务 ID 。 * 您可以轮询 `GET /api/v1/tasks/{task_id}` ，直到任务状态`status` 变为 `completed`；或者使用[事件回调](https://www.volcengine.com/docs/6448/2288701)接收任务状态变化。 * 任务完成后，您可解析 `result` 字段，在 `vq_score` 字段处获取最终的画质分数。 #### 第 1 步：提交任务您需要调用[提交视频画质检测 VQScore 任务 API](https://www.volcengine.com/docs/6448/2515374)。可直接复制以下 cURL 命令提交。 ```Bash curl -X POST 'https://mediakit.cn-beijing.volces.com/api/v1/tools/assess-video-quality' \ --header 'Content-Type: application/json' \ --header 'Authorization: Bearer {Your_MediaKit_API_Key}' \ --data '{ "video_url": "https://example.com/your_video.mp4" }' ``` 请求成功后，您会收到如下包含 `task_id` 的响应，请保存此 ID 用于后续查询。 ```JSON { "success": true, "task_id": "amk-tool-assess-video-quality-12345", "request_id": "20240523110000ABCDEFG98765" } ``` #### 第 2 步：获取结果画质检测任务需要一定时间。您需要轮询[查询任务信息 API](https://www.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_MediaKit_API_Key}' ``` 当任务成功完成后，您将收到如下响应。`result` 字段是一个 JSON 对象，您可以直接从其下的 `vq_score` 字段获取画质分数。 ```JSON { "success": true, "task_id": "amk-tool-assess-video-quality-12345", "request_id": "20240523110000ABCDEFG98765", "status": "completed", "result": { "vq_score": 88.5, "duration": 91.2 }, "expires_at": 1777534898, "created_at": 1777362013, "finished_at": 1777362599 } ``` VQScore 的评分范围为 `[0, 100]`，分数越高代表画质越好。您可以参考下表来理解不同分数区间的画质水平： |分数区间 |主观感受 |建议操作 | |---|---|---| |`[0, 60)` |较差 |画质损伤严重，可能包含明显噪点、模糊、压缩失真等。建议使用[画质增强（标准版和专业版）](https://www.volcengine.com/docs/6448/2279961)工具进行修复。 | |`[60, 70)` |良好 |可被多数用户接受，但可能存在轻微瑕疵。适用于对画质要求不高的场景。 | |`[70, 100]` |清晰 |主观感受清晰，细节保留较好。适用于高清分发场景。 | ## 参考信息 ### 使用限制 |限制项 |说明 | |---|---| |输入视频限制 |* 视频来源：支持公网 HTTP/HTTPS URL、本地上传 (`mediakit://`)、来源于火山引擎视频点播 (`vod://`) 和火山引擎对象存储 (`tos://`) 四种输入协议。关于各协议的具体说明和使用示例，请参阅[多源媒体输入与本地上传](https://www.volcengine.com/docs/6448/2536893)。

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

* 分辨率限制：输入视频最高支持 4K (3840×2160) 分辨率。 | ## 相关 API 文档 * [提交视频画质检测 VQScore 任务 API](https://www.volcengine.com/docs/6448/2515374) * [查询任务信息 API](https://www.volcengine.com/docs/6448/2278532) * [事件回调](https://www.volcengine.com/docs/6448/2288701)