AI MediaKit 图像画质评估工具，能够对输入图片进行多维度的主客观质量分析和美学评分，适用于媒体质量监控、低质图筛查、AIGC 内容审核、推荐系统排序及训练数据清洗等多种场景。本篇开发指南将引导您： * 快速体验通过一次 API 调用获取图像的质量分数。 * 理解“标准版”与“专业版”评估模型的差异与适用场景。 * 学习如何解读返回的各项画质与美学分数。 * 掌握如何根据需求指定评估维度，实现更灵活的调用。 ## 快速体验：一键获取图像质量分图像画质评估是一个**同步任务**，您发起的请求会直接在响应中返回评估结果。 ### 准备工作 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。 ### 操作流程您只需调用[提交图像画质评估任务 API](https://docs.volcengine.com/docs/6448/2464626)，即可在 API 的响应体中直接获取评估分数。 #### 步骤 1：提交任务并获取结果可直接复制以下 cURL 命令，提交一个画质评估任务。本示例使用默认的**标准版**模型，评估图片的主观质量（`vqscore`）和噪声（`noise`）两个维度。 ```Bash curl -X POST 'https://mediakit.cn-beijing.volces.com/api/v1/tools-sync/evaluate-image-quality' \ --header 'Content-Type: application/json' \ --header 'Authorization: Bearer {Your_API_Key}' \ --data '{ "image_url": "https://example.com/your_image.jpg", "tool_version": "standard", "standard_evaluate_items": [ "vqscore", "noise" ] }' ```

说明

需替换参数：

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

将 image_url 替换为您真实的图片地址。

#### 步骤 2：查看响应与分数解读由于是同步接口，请求成功后，您会立即收到包含最终分数的响应。`result` 字段即为评估结果。 ```JSON { "success": true, "task_id": "amk-tool-evaluate-image-quality-12345", "request_id": "021778401180935fdbd0ff1ce00652c087a", "result": { "tool_version": "standard", "vqscore": 85.5, "noise": 10.2 } } ``` * `vqscore`: 85.5 分，表示图片主观质量较好。 * `noise`: 10.2 分，表示图片噪声强度较低，画面干净。 ## 进阶使用 ### 标准版和专业版对比图像画质评估提供“标准版”和“专业版”两个版本，您可以通过 `tool_version` 参数进行选择。 |特性 |标准版 (`standard`) |专业版 (`professional`) | |---|---|---| |说明 |提供 15 种基础画质评估维度，支持通过 `standard_evaluate_items` 参数灵活选择部分或全部维度进行评估。 |基于大模型进行评估，直接返回一组固定的综合性评分（如美学、清晰度、噪声等），不支持自定义评估维度。该版本提供更优的综合评估效果，适用于对图像品质要求较高的场景。 | |成本 |1.38 元/千次 |41.4 元/千次 | ### 指定评估维度（仅标准版）当您使用**标准版**时，如果不需要全部 15 个维度的分数，可以通过 `standard_evaluate_items` 参数指定您关心的评估项。这可以减少响应体大小，使结果更聚焦。如果不传此参数，默认会返回 `["vqscore", "noise", "aesthetic", "blur"]` 四个维度的分数。 #### 示例：仅评估对比度和亮度以下请求将只返回 `contrast` 和 `brightness` 两个维度的分数。 ```Bash curl -X POST 'https://mediakit.cn-beijing.volces.com/api/v1/tools-sync/evaluate-image-quality' \ --header 'Content-Type: application/json' \ --header 'Authorization: Bearer {Your_API_Key}' \ --data '{ "image_url": "https://example.com/your_image.jpg", "tool_version": "standard", "standard_evaluate_items": [ "contrast", "brightness" ] }' ``` **响应示例：** ```JSON { "success": true, "result": { "tool_version": "standard", "contrast": 85.2, "brightness": 128.5 }, ... } ``` ## 参考信息 ### 应用场景 * **AI 生成图像质量筛选**：自动过滤低质量 AI 图像、AIGC 生图。例如平台仅允许上传综合评分大于 70 的图像。 * **内容审核**：自动识别模糊、噪声大、有压缩痕迹的图片，避免低质内容上线。例如电商平台上如果用户上传的商品图模糊评分小于 60，则自动打回重传。 * **图像增强工具反馈**：在 Photoshop 插件、在线修图工具等图像增强工具中，如果用户上传的图片模糊评分较低，则建议"去模糊"或"降噪"。 * **AI 模型训练数据清洗**：在训练视觉模型前，自动剔除低质量图像，避免影响模型性能。例如在训练人脸识别模型前，过滤掉模糊评分小于 65 的图像。 * **图库推荐**：自动评估上传图像的质量，决定是否推荐到首页。例如美学评分小于 70 的图片，不会进入"编辑推荐"流。 * **手机相册智能分类**：自动标记“模糊照片”或“噪点多”的照片，建议用户删除或修复。例如 iPhone 相册的“清理建议”功能。 ### 使用限制 |**限制项** |**说明** | |---|---| |**输入图像限制** |* **图像来源**：支持公网 HTTP/HTTPS URL、本地上传 (`mediakit://`)、火山引擎对象存储 (`tos://`) 三种输入协议。关于各协议的具体说明和使用示例，请参阅[多源媒体输入与本地上传](https://docs.volcengine.com/docs/6448/2536893)。

* **文件大小**：单张图片不得超过 10 MB。

* **支持格式**：支持 `png`、`jpeg`、`webp` 和 `heic`。

* **图像输入分辨率**：

* 短边不得超过 4320 px

* 长边不得超过 7680 px | ## 相关 API 文档 * [提交图像画质评估任务 API](https://docs.volcengine.com/docs/6448/2464626)