AI MediaKit 图像画质增强工具基于深度学习与图像内容理解技术，能智能决策并调用合适的算法，一键式提升图片的分辨率、清晰度与色彩表现，适用于 AIGC 图像后处理、老照片修复、OCR 识别预处理、商品图优化等多种场景。

本篇开发指南将引导您：

效果预览

快速体验：一键提升图片清晰度

图像画质增强是一个同步任务，您发起的请求会直接在响应中返回处理结果。

准备工作

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

操作流程

您只需调用提交图像画质增强任务 API，即可在 API 的响应体中直接获取增强后的图片地址。

步骤 1：提交任务并获取结果

可直接复制以下 cURL 命令，替换其中的参数后执行。

步骤 2：查看响应

由于是同步接口，请求成功后，您会在几秒内收到包含最终结果的响应。您可以直接从 result.image_url 字段获取增强后图片的下载地址（有效期为 24 小时）。

进阶使用

模型版本说明

图像画质增强工具支持标准版、专业版和大模型增强版三个版本，在效果、适用场景和成本上均有不同。您可以通过 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 倍

示例 2：将图片宽度调整为 1920px，高度等比缩放

选择生成式增强策略：保真度优先 vs 生成度优先

当您使用专业版 (professional) 或大模型增强版 (max) 时，可以通过设置 generative_enhance_mode 参数，来指导模型在“忠于原图”和“创造性修复”之间进行权衡。

模式	fidelity_first（保真度优先）	generative_first（生成度优先）
效果说明	此模式更侧重于保留和增强图像的既有细节（如人物特征、原始纹理），尽可能减少对原始内容的改动。	此模式会在保留原图结构的基础上智能生成更丰富、更自然的纹理细节，以达到最佳的主观视觉效果。
适用场景	需要高度还原细节的场景，如人像写真、产品图、文字截图、证件照等。	修复严重压缩或模糊的低质量图像（如老照片），或希望获得最大程度清晰度和细节感的场景。