AI MediaKit 图像画质增强工具基于深度学习与图像内容理解技术，能智能决策并调用合适的算法，一键式提升图片的分辨率、清晰度与色彩表现，适用于 AIGC 图像后处理、老照片修复、OCR 识别预处理、商品图优化等多种场景。本篇开发指南将引导您： * 快速体验通过一次 API 调用将模糊图片变得清晰。 * 理解标准版、专业版、大模型增强版画质增强的效果差异与适用场景。 ## 效果预览 |

处理前

处理后

||| |---|---|---|---| ||

标准版

专业版

大模型增强版

| |

* 清晰度：49.61

* 美学观感：49.68 |

* 清晰度：51.70（+2）

* 美学观感：72.84（+23） |

* 清晰度：70.02（+20）

* 美学观感：78.27（+28） |

* 清晰度：76.71（+26）

* 美学观感：77.28（+28） | |

* 清晰度：47.29

* 美学观感：51.73 |

* 清晰度：49.52（+2.23）

* 美学观感：67.15（+15.42） |

* 清晰度：72.33（+25.04）

* 美学观感：77.20（+25.47） |

* 清晰度：74.99（+27.70）

* 美学观感：83.36（+31.63） | |

* 清晰度：48.43

* 美学观感：63.81 |

* 清晰度：58.26（+9.83）

* 美学观感：74.38（+10.57） |

* 清晰度：72.11（+23.68）

* 美学观感：79.80（+15.99） |

* 清晰度：75.22（+26.79）

* 美学观感：79.54（+15.73） | ## 快速体验：一键提升图片清晰度图像画质增强是一个**同步任务**，您发起的请求会直接在响应中返回处理结果。 ### 准备工作 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/2464630)，即可在 API 的响应体中直接获取增强后的图片地址。 #### 步骤 1：提交任务并获取结果可直接复制以下 cURL 命令，替换其中的参数后执行。 ```Bash curl -X POST 'https://mediakit.cn-beijing.volces.com/api/v1/tools-sync/enhance-image' \ --header 'Content-Type: application/json' \ --header 'Authorization: Bearer {Your_API_Key}' \ --data '{ "image_url": "https://vod-ai-test.tos-cn-beijing.volces.com/demo/blurry_image.jpg", "multiple": 2 }' ```

说明

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

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

示例中的 "multiple": 2 表示将图片分辨率放大 2 倍。

#### 步骤 2：查看响应由于是同步接口，请求成功后，您会在几秒内收到包含最终结果的响应。您可以直接从 `result.image_url` 字段获取增强后图片的下载地址（有效期为 24 小时）。 ```JSON { "success": true, "task_id": "amk-tool-enhance-image-1234567", "task_type": "enhance-image", "request_id": "20260415160000F6DE4C24A6A0D94B7FF2", "result": { "image_url": "https://example.volcvideo.com/enhanced_output.jpg?auth_key=1775271661-...", "image_size": 875321, "image_format": "jpeg", "image_width": 2048, "image_height": 1536 }, "expires_at": 1778573984 } ``` ## 进阶使用 ### 模型版本说明图像画质增强工具支持标准版、专业版和大模型增强版三个版本，在效果、适用场景和成本上均有不同。您可以通过 `tool_version` 参数进行选择。 |特性 |标准版 (`standard`) |专业版 (`professional`) |大模型增强版 (`max`) | |---|---|---|---| |说明 |平衡处理速度、码率增长与画质效果，结合对画质问题的分析，智能决策使用的画质增强算子（超分、去伪影、去噪、去模糊、锐化、人像增强、文字增强、色彩增强等），自适应提升图像清晰度和画面质感。 |发丝级画质增强，在平衡保真度的前提下适当补充自然纹理细节，显著提升低质图像的画面清晰度与色彩表现。 |基于生成式大模型，在尝试保证全局结构和语义一致性的前提下，修复图像画质、生成自然纹理细节，针对低质图像可显著提升图像细节丰富度和清晰度。 | |适用场景 |适用于 OCR/大模型参考图预处理、UGC 插图/视频封面等图像分发场景的画质提升。 |适用于 AIGC 生图瑕疵修复、老照片修复、商品图、人像写真、印刷海报等高清大图制作场景画质提升。 |适用于 AIGC 生图瑕疵修复、较低质量图像修复（例如老照片、低分辨率图像等）等场景画质提升。 | |输入分辨率范围 |* 16 px ⩽ 短边 ≤ 1440 px

* 16 px ⩽ 长边 ≤ 2160 px |* 短边 ⩾ 256 px

* 长边 ⩽ 2048 px |* 短边 ⩾ 64 px

* 长边 ⩽ 6240 px | |输出分辨率范围 |* 短边 ⩽ 6144 px

* 长边 ⩽ 6144 px |长边 ⩽ 10240 px |长边 ⩽ 10240 px | |放大倍率 |1 \- 8 倍 |1 \- 30 倍 |1 \- 30 倍 | |成本 |6 元/千次 |36 元/千次 |240 元/千次 | ### 配置输出分辨率您可以通过 `multiple`、`target_width`、`target_height` 三个参数来控制输出图像的分辨率。如果同时设置，API 将按照 `multiple` \> (`target_width`, `target_height`) 的优先级进行处理。如果都不设置，则默认倍率为 2。 |方式 |参数 |说明 | |---|---|---| |倍率放大 |`multiple` |指定输出图像相对于原图的放大倍数。例如，2.0 表示长宽均放大 2 倍。

* 标准版 (standard)：取值范围为 [1, 8]。

* 专业版 (professional) / 大模型增强版 (max)：取值范围为 [1, 30]。 | |指定输出尺寸 |* `target_width`

* `target_height` |指定输出图像的目标宽度或高度，单位为像素。

* 标准版 (standard)：取值范围为 [原图宽度或高度, 6144]，且最终放大倍数不能超过 8 倍。

* 专业版 (professional) / 大模型增强版 (max)：取值范围为 [64, 10240]。

当您使用 `target_width` 或 `target_height` 指定输出尺寸时，最终的输出结果会同时考虑您设置的目标尺寸和原图的宽高比，遵循以下原则：

* 只指定一边（宽或高）：系统会在保持原图宽高比的前提下，将指定的一边缩放至目标值，另一边等比缩放。

* 同时指定宽和高：如果目标宽高比与原图不一致，系统会以能完整容纳于目标尺寸框内的最大尺寸为准进行缩放，并保持原图的宽高比。例如，一张 100x100（1:1）的图片，如果目标尺寸设置为 400x300（4:3），系统为了保持原图的 1:1 比例，最终会输出 300x300 的图片。

说明

对于大模型增强版 (max)，建议将输出分辨率的目标尺寸控制在 8000x8000 以内，以避免处理超大分辨率图像时因耗时过长而发生超时。

| #### 示例 1：将图片放大 2.5 倍 ```JSON { "image_url": "https://example.com/source.jpg", "multiple": 2.5 } ``` #### 示例 2：将图片宽度调整为 1920px，高度等比缩放 ```JSON { "image_url": "https://example.com/source.jpg", "target_width": 1920 } ``` ### 选择生成式增强策略：保真度优先 vs 生成度优先当您使用专业版 (`professional`) 或大模型增强版 (`max`) 时，可以通过设置 `generative_enhance_mode` 参数，来指导模型在“忠于原图”和“创造性修复”之间进行权衡。 |模式 |`fidelity_first`（保真度优先） |`generative_first`（生成度优先） | |---|---|---| |**效果说明** |此模式更侧重于保留和增强图像的既有细节（如人物特征、原始纹理），尽可能减少对原始内容的改动。 |此模式会在保留原图结构的基础上智能生成更丰富、更自然的纹理细节，以达到最佳的主观视觉效果。 | |**适用场景** |需要高度还原细节的场景，如人像写真、产品图、文字截图、证件照等。 |修复严重压缩或模糊的低质量图像（如老照片），或希望获得最大程度清晰度和细节感的场景。 | #### 效果预览 |原图 |fidelity_first 效果 |generative_first 效果 | |---|---|---| |![图片](https://p9-arcosite.byteimg.com/obj/tos-cn-i-goo7wpa0wc/e400198b193f41feb786a079e427eaf8) |![图片](https://p9-arcosite.byteimg.com/obj/tos-cn-i-goo7wpa0wc/1a2d92f6a37d40e2ab1fcc8f27a3ee0f) |![图片](https://p9-arcosite.byteimg.com/obj/tos-cn-i-goo7wpa0wc/b18e91e6bd76455b974490b5815217c9) | #### 示例：使用“保真度优先”模式以下示例演示了如何使用“保真度优先”模式来处理一张人像图片。 ```JSON { "image_url": "https://example.com/portrait.jpg", "tool_version": "professional", "generative_enhance_mode": "fidelity_first", "multiple": 2 } ``` ## 参考信息 ### 使用限制 |限制项 |说明 | |---|---| |输入图像限制 |* **图像来源**：支持公网 HTTP/HTTPS URL、本地上传 (`mediakit://`)、火山引擎对象存储 (`tos://`) 三种输入协议。关于各协议的具体说明和使用示例，请参阅[多源媒体输入与本地上传](https://docs.volcengine.com/docs/6448/2536893)。

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

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

* **输入分辨率限制**：不同 `tool_version` 支持的输入和输出尺寸范围有所不同。

* `standard`：16 px ⩽ 短边 ≤ 1440 px；16 px ⩽ 长边 ≤ 2160 px

* `professional`：短边 ⩾ 256 px；长边 ⩽ 2048 px

* `max`：短边 ⩾ 64 px；长边 ⩽ 6240 px

* **宽高比限制**：对于 `max` 版本，图像的“长边/短边”之比不得超过 32。若超过此比例，任务将报错。 | ## 相关 API 文档 * [提交图像画质增强任务 API](https://docs.volcengine.com/docs/6448/2464630)