跳到内容

图片无损压缩 ​

更新时间

对图片重新编码,在画质肉眼无损的前提下大幅降低文件体积。核心只需设置 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 重新编码:

json
{
  "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,保持原图分辨率,仅重新编码:

json
{
  "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 轮询任务状态。

请求:

json
{ "TaskId": "260000****-WorkflowTask-*************" }

响应 — 成功 ​

json
{
  "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.541.0776.3%左右对比
图片 B(550×3072)16.473.5978.2%左右对比

「体积减少」= 1 − 压缩后体积 ÷ 原图体积。百分比沿用原始测试数据;用表中保留两位的 MB 值复算,图片 A 为 76.4%,差异来自体积取整。压缩效果与图片内容强相关,上表为参考值,实际以你自己的素材实测为准。

相关文档 ​

文档说明
API ReferenceMPS 鉴权、TC3 签名与请求执行的通用规范
SDK Reference用官方 SDK 调用 MPS 关键接口的完整流程

基于 VitePress 构建 · 部署于腾讯云 EdgeOne Pages