图片无损压缩
对图片重新编码,在画质肉眼无损的前提下大幅降低文件体积。核心只需设置 ImageTask.EncodeConfig.ImageEncodeConfig:
- 输出格式
Format(如AVIF) - 相对质量
Quality(以原图质量为基准,1–100)
可选再叠加 TransformConfig.ImageResize,一次请求同时完成缩放与压缩。实测两张大图压缩后体积减少 76%~78%(见「参考效果」)。
「无损」的含义
这里的「无损」指视觉无损:重新编码后肉眼看不出画质差异,而不是逐像素一致的数学无损。压缩幅度由 Format 与 Quality 共同决定,上线前建议用自己的素材按「参考效果」的方式左右对比确认。
本文的示例口径
全文示例使用 COS 输入 + COS 输出。换成 URL / AWS-S3 / VOD 等其他输入输出形式时,只需替换 InputInfo 与 OutputStorage,ImageTask 部分不变。
接口文档
| 用途 | 接口 | 官方文档 | API Explorer |
|---|---|---|---|
| 发起图片处理 | ProcessImage | 发起图片处理 | 在线调试 |
| 查询任务状态 | DescribeImageTaskDetail | 查询图片处理任务详情 | 在线调试 |
编码参数的完整结构定义见官方数据结构文档 ImageEncodeConfig。
请求结构
COS 输入 + COS 输出,缩放到 1280×720 并以 AVIF、质量 50 重新编码:
{
"InputInfo": {
"Type": "COS",
"CosInputInfo": {
"Bucket": "your-bucket-1250000000",
"Region": "ap-shanghai",
"Object": "image/lenna.png"
}
},
"OutputStorage": {
"Type": "COS",
"CosOutputStorage": {
"Bucket": "your-bucket-1250000000",
"Region": "ap-shanghai"
}
},
"OutputDir": "/share/output/",
"ImageTask": {
"TransformConfig": {
"ImageResize": {
"Width": 1280,
"Height": 720
}
},
"EncodeConfig": {
"ImageEncodeConfig": {
"Format": "AVIF",
"Quality": 50
}
}
}
}ImageEncodeConfig(编码压缩,核心)
路径:ImageTask.EncodeConfig.ImageEncodeConfig
| 参数 | 参数说明 | 取值说明 |
|---|---|---|
Format | 输出图片格式 | 缺省为原图格式;不支持动画。本文示例使用 AVIF。官方结构文档列出的取值为 JPEG / PNG / BMP / WebP |
Quality | 图片的相对质量 | 取值 1–100,以原图质量为基准;缺省为原图质量。数值越小体积越小 |
先从示例值起步
Format=AVIF + Quality=50 是本文实测效果所用的参数,可作为起点。对画质更敏感的场景(如商品细节图)可适当调高 Quality,再对比体积与观感取舍。
ImageResize(缩放,可选)
路径:ImageTask.TransformConfig.ImageResize。只想压缩、不改尺寸时整段省略 TransformConfig 即可。
| 参数 | 参数说明 | 取值说明 |
|---|---|---|
Switch | 能力配置开关 | ON:开启(默认值);OFF:关闭 |
Mode | 缩放模式 | percent(默认):按倍率缩放;mfit:缩放至指定宽高的较大矩形;lfit:缩放至指定宽高的较小矩形;fill:缩放至较大矩形后居中裁剪到指定宽高;pad:缩放至较小矩形后填充到指定宽高;fixed:强制缩放到固定宽高 |
Percent | 缩放倍率 | Mode=percent 时使用,可为小数,取值 [0.1, 10.0],默认 1.0 |
Width / Height | 目标宽 / 高 | 取值 [1, 16384];Mode 非 percent 时优先使用 |
LongSide / ShortSide | 目标长边 / 短边 | 取值 [1, 16384];Mode 非 percent 且未配置 Width、Height 时使用 |
输入与输出位置
| 参数 | 说明 |
|---|---|
InputInfo | 待压缩的图片。示例为 COS(Bucket / Region / Object) |
OutputStorage | 输出文件的目标存储,与 ImageTask 同级。不填则继承 InputInfo 中的存储位置 |
OutputDir | 输出目录,如 /share/output/,表示继承原文件名输出到该目录。不填则与输入文件所在目录一致 |
业务示例
只压缩、不改尺寸
省略 TransformConfig,保持原图分辨率,仅重新编码:
{
"InputInfo": {
"Type": "COS",
"CosInputInfo": {
"Bucket": "your-bucket-1250000000",
"Region": "ap-shanghai",
"Object": "image/lenna.png"
}
},
"OutputDir": "/share/output/",
"ImageTask": {
"EncodeConfig": {
"ImageEncodeConfig": { "Format": "AVIF", "Quality": 50 }
}
}
}此例未传 OutputStorage,输出继承输入所在的 COS 桶与地域。
缩放 + 压缩
即上文「请求结构」中的完整示例:先把图片缩放到 1280×720,再以 AVIF、质量 50 编码输出。
查询结果(DescribeImageTaskDetail)
ProcessImage 返回 TaskId 后,用 DescribeImageTaskDetail 轮询任务状态。
请求:
{ "TaskId": "260000****-WorkflowTask-*************" }响应 — 成功
{
"Response": {
"CreateTime": "2025-05-21T01:02:51Z",
"FinishTime": "2025-05-21T01:02:52Z",
"ImageProcessTaskResultSet": [
{
"Output": {
"OutputStorage": {
"CosOutputStorage": {
"Bucket": "your-bucket-1250000000",
"Region": "ap-shanghai"
},
"Type": "COS"
},
"Path": "/share/output/test_2.jpeg"
}
}
],
"RequestId": "bf13665d-843a-45f2-a297-97e9ef26966a",
"Status": "FINISH",
"TaskType": "WorkflowTask"
}
}| 字段 | 说明 |
|---|---|
Status | 任务状态,FINISH 表示已到终态 |
ImageProcessTaskResultSet[].Output.Path | 压缩后图片在输出存储中的路径 |
ImageProcessTaskResultSet[].Output.OutputStorage | 输出所在的存储(类型 / 桶 / 地域) |
CreateTime / FinishTime | 任务创建与完成时间(UTC) |
示例响应只示意结构
上面的响应来自一次真实任务,输出文件名 test_2.jpeg 与本文请求示例并非同一次调用。实际输出文件名继承输入文件名,扩展名跟随 Format。
参考效果
下表为两张大图的实测压缩结果。点击「对比链接」可在线拖动查看,左 / 右分别为原图 / 压缩后。
| 图片 | 原图体积(MB) | 压缩后体积(MB) | 体积减少 | 对比链接 |
|---|---|---|---|---|
| 图片 A(2752×1536) | 4.54 | 1.07 | 76.3% | 左右对比 |
| 图片 B(550×3072) | 16.47 | 3.59 | 78.2% | 左右对比 |
「体积减少」= 1 − 压缩后体积 ÷ 原图体积。百分比沿用原始测试数据;用表中保留两位的 MB 值复算,图片 A 为 76.4%,差异来自体积取整。压缩效果与图片内容强相关,上表为参考值,实际以你自己的素材实测为准。
相关文档
| 文档 | 说明 |
|---|---|
| API Reference | MPS 鉴权、TC3 签名与请求执行的通用规范 |
| SDK Reference | 用官方 SDK 调用 MPS 关键接口的完整流程 |