📖 URL 构造规则：处理参数附加在原图 URL 之后，用
? 分隔；多个操作链式拼接，例如 thumbnail/200x/quality/80/format/webp。
📐缩放6 个示例
按百分比等比缩放
缩放
按原图百分比等比缩放，取值 1-1000。
50p 表示缩为 50% 大小。
https://ci-test.wxmt.tcloudbase.com/doggie.jpg?imageMogr2/thumbnail/!50p
!50p → 50% 等比缩放
指定宽度，等比缩放
缩放
固定宽度，高度按比例自动计算。取值 1-10000。
https://ci-test.wxmt.tcloudbase.com/doggie.jpg?imageMogr2/thumbnail/200x
200x → 宽度 200px
指定高度，等比缩放
缩放
固定高度，宽度按比例自动计算。取值 1-10000。
https://ci-test.wxmt.tcloudbase.com/doggie.jpg?imageMogr2/thumbnail/x200
x200 → 高度 200px
限定宽高最大值（等比）
缩放
长边不超过设定值，等比缩放，常用于缩略图。
https://ci-test.wxmt.tcloudbase.com/doggie.jpg?imageMogr2/thumbnail/300x300
300x300 → 长边 ≤ 300
强制缩放到指定尺寸（可能变形）
缩放
末尾加
! 表示强制缩放，忽略原图比例。
https://ci-test.wxmt.tcloudbase.com/doggie.jpg?imageMogr2/thumbnail/300x300!
300x300! → 强制 300×300
限定总像素数（等比）
缩放
控制输出图总像素数（宽×高），按等比缩放。
40000@ ≈ 200×200。
https://ci-test.wxmt.tcloudbase.com/doggie.jpg?imageMogr2/thumbnail/40000@
40000@ → 像素总量 ≤ 40000
✂️裁剪6 个示例
自定义矩形裁剪
裁剪
按
宽×高×水平偏移×垂直偏移 裁出指定区域，原点为左上角。
https://ci-test.wxmt.tcloudbase.com/doggie.jpg?imageMogr2/cut/300x300x50x50
cut/300x300x50x50
缩放裁剪（中心锚点）
裁剪
先缩放到能覆盖目标尺寸，再按九宫格位置裁剪。
center 为中心。
https://ci-test.wxmt.tcloudbase.com/doggie.jpg?imageMogr2/crop/300x300/gravity/center
crop/300x300 + center
缩放裁剪（右下角）
裁剪
九宫格位置
southeast 表示右下角，其它：north/south/east/west/northeast/northwest/southwest。
https://ci-test.wxmt.tcloudbase.com/doggie.jpg?imageMogr2/crop/300x300/gravity/southeast
crop/300x300 + southeast
内切圆裁剪
裁剪
将图片裁成圆形头像。半径 1 ~ 原图最小边的一半。
https://ci-test.wxmt.tcloudbase.com/doggie.jpg?imageMogr2/iradius/150
iradius/150 → 圆头像
圆角裁剪
裁剪
裁出圆角矩形，圆角半径 1 ~ 原图最小边的一半，背景透明。
https://ci-test.wxmt.tcloudbase.com/doggie.jpg?imageMogr2/rradius/40
rradius/40 → 圆角矩形
人脸智能裁剪
裁剪
基于人脸识别自动裁剪，输出尺寸不可超过原图一半。
https://ci-test.wxmt.tcloudbase.com/doggie.jpg?imageMogr2/scrop/300x300
scrop/300x300 → 人脸居中
🔄旋转4 个示例
顺时针旋转
旋转
按指定角度顺时针旋转，取值 0-360。
https://ci-test.wxmt.tcloudbase.com/doggie.jpg?imageMogr2/rotate/90
rotate/90 → 顺时针 90°
EXIF 自适应旋转
旋转
读取图片 EXIF 方向信息自动旋转，手机拍的照片特别需要。
https://ci-test.wxmt.tcloudbase.com/doggie.jpg?imageMogr2/auto-orient
auto-orient → 按 EXIF 校正
垂直镜像翻转
旋转
沿水平轴翻转（上下颠倒）。
https://ci-test.wxmt.tcloudbase.com/doggie.jpg?imageMogr2/flip/vertical
flip/vertical → 上下颠倒
水平镜像翻转
旋转
沿垂直轴翻转（左右镜像）。
https://ci-test.wxmt.tcloudbase.com/doggie.jpg?imageMogr2/flip/horizontal
flip/horizontal → 左右镜像
🧩格式转换4 个示例
转 WebP
格式
输出 WebP 格式，体积通常比 JPG 小 25-35%，浏览器兼容性良好。
https://ci-test.wxmt.tcloudbase.com/doggie.jpg?imageMogr2/format/webp
format/webp
主格式失败时降级
格式
优先输出 heif，若客户端不支持则降级为 jpg。仅下载时生效。
https://ci-test.wxmt.tcloudbase.com/doggie.jpg?imageMogr2/format/heif/backup-format/jpg
heif → 降级 jpg
静图与动图分别转码
格式
静图转 webp，动图转 gif（动图支持 gif/png/webp/avif）。
https://ci-test.wxmt.tcloudbase.com/doggie.jpg?imageMogr2/format/webp/anima-format/gif
静图 webp / 动图 gif
输出原图（不处理）
格式
format/src 表示保持原格式，常配合 watermark 一起用：format/src/watermark/...。
https://ci-test.wxmt.tcloudbase.com/doggie.jpg?imageMogr2/format/src
format/src → 保持原格式
🎚️质量调节4 个示例
绝对质量（取最小值）
质量
设定目标质量 0-100。当原图质量低于设定值时，结果不会差于原图。
https://ci-test.wxmt.tcloudbase.com/doggie.jpg?imageMogr2/quality/60
quality/60
强制绝对质量（带 !）
质量
末尾加
! 强制按目标值压缩，即使原图质量更高也会被压下来。
https://ci-test.wxmt.tcloudbase.com/doggie.jpg?imageMogr2/quality/60!
quality/60!
相对质量（按原图百分比）
质量
rquality/60 = 原图质量的 60%。适合"减半压一次"的场景。
https://ci-test.wxmt.tcloudbase.com/doggie.jpg?imageMogr2/rquality/60
rquality/60
最低质量（兜底提升）
质量
lquality/60 = 质量不低于 60%。原图质量更高则保持，不会主动压。
https://ci-test.wxmt.tcloudbase.com/doggie.jpg?imageMogr2/lquality/60
lquality/60
🎨图像效果5 个示例
高斯模糊
效果
格式
blur/<半径>x<标准差>。下载时半径 1-500，常用于做背景虚化。
https://ci-test.wxmt.tcloudbase.com/doggie.jpg?imageMogr2/blur/15x3
blur/15x3
锐化
效果
取值 10-300，推荐 70。提升边缘清晰度，对缩略图特别有用。
https://ci-test.wxmt.tcloudbase.com/doggie.jpg?imageMogr2/sharpen/70
sharpen/70
亮度调节
效果
取值 -100 ~ 100，0 为不变，正数变亮、负数变暗。
https://ci-test.wxmt.tcloudbase.com/doggie.jpg?imageMogr2/bright/30
bright/30 → +30 亮度
对比度调节
效果
取值 -100 ~ 100，0 为不变，正数增强、负数减弱。
https://ci-test.wxmt.tcloudbase.com/doggie.jpg?imageMogr2/contrast/20
contrast/20 → +20 对比度
灰度图
效果
0 不变，1 转灰度。
https://ci-test.wxmt.tcloudbase.com/doggie.jpg?imageMogr2/grayscale/1
grayscale/1 → 灰度图
⚡极致压缩1 个示例
主动触发极智压缩
极致压缩
通过
imageSlim 主动触发，深度压缩后仍保持较好观感，适合列表页/缩略图场景。
https://ci-test.wxmt.tcloudbase.com/doggie.jpg?imageSlim
imageSlim
🚀高级压缩5 个示例
HEIF 编码
高级压缩
新一代高效图片编码，体积比 JPG 减小 80%+（官方实测 96.0%）。
https://ci-test.wxmt.tcloudbase.com/doggie.jpg?imageMogr2/format/heif
format/heif
TPG 动图压缩
高级压缩
腾讯自研动图格式，体积比 GIF 减小 90%+（官方实测 97.3%），需搭配 TPG 解码 SDK 使用。
https://ci-test.wxmt.tcloudbase.com/doggie.jpg?imageMogr2/format/tpg
format/tpg
AVIF 编码
高级压缩
基于 AV1 的开源高效图片格式，压缩率高（官方实测 95.3%），主流现代浏览器已支持。
https://ci-test.wxmt.tcloudbase.com/doggie.jpg?imageMogr2/format/avif
format/avif
ASTC 纹理压缩
高级压缩
GPU 纹理压缩格式，专为移动端游戏 / OpenGL 纹理设计。
https://ci-test.wxmt.tcloudbase.com/doggie.jpg?imageMogr2/format/astc
format/astc（GPU 纹理专用）
SVGC 压缩
高级压缩
对 SVG 进行压缩优化输出，减小 SVG 体积。
https://ci-test.wxmt.tcloudbase.com/doggie.jpg?imageMogr2/format/svgc
format/svgc（SVG 优化）
🔏盲水印1 个示例
文字盲水印
盲水印
在原图中嵌入肉眼不可见的水印信息，用于版权追踪。参数
text/YWJj 是 base64 编码后的水印文本（原文 abc）。
https://ci-test.wxmt.tcloudbase.com/doggie.jpg?watermark/3/type/3/text/YWJj
watermark/3/type/3/text/YWJj
🧪组合示例（实战推荐）6 个示例
标准缩略图（缩放 + 质量 + WebP）
组合
列表页最常用的组合：限制最大边、压到 75 质量、转 webp 省流量。
https://ci-test.wxmt.tcloudbase.com/doggie.jpg?imageMogr2/thumbnail/300x/quality/75/format/webp
thumbnail/300x + quality/75 + format/webp
圆角缩略图（缩放 + 圆角 + WebP）
组合
卡片式 UI 常用：等比缩放到宽度 300，再做 20px 圆角。
https://ci-test.wxmt.tcloudbase.com/doggie.jpg?imageMogr2/thumbnail/300x/rradius/20/format/webp
thumbnail/300x + rradius/20 + format/webp
封面图（缩放裁剪 + 中心 + 锐化 + WebP）
组合
Banner 通用：按中心裁成 600×400、锐化提清晰度、转 webp。
https://ci-test.wxmt.tcloudbase.com/doggie.jpg?imageMogr2/crop/600x400/gravity/center/sharpen/70/format/webp
crop/600x400 + center + sharpen/70 + format/webp
圆形头像（内切圆 + WebP）
组合
头像专用：先按宽度 200 缩放，再做内切圆裁剪，最后转 webp。
https://ci-test.wxmt.tcloudbase.com/doggie.jpg?imageMogr2/thumbnail/200x/iradius/200/format/webp
thumbnail/200x + iradius/200 + format/webp
手机照片修正（EXIF + 质量 + WebP）
组合
用户上传的手机照片，先按 EXIF 校正方向，再做轻度压缩并转 webp。
https://ci-test.wxmt.tcloudbase.com/doggie.jpg?imageMogr2/auto-orient/thumbnail/800x/quality/80/format/webp
auto-orient + thumbnail/800x + quality/80 + format/webp
极致压缩 + HEIF（最小体积）
组合
先用极致压缩，再转 HEIF。体积最小但需客户端支持 HEIF 解码（建议配合
backup-format 兜底）。
https://ci-test.wxmt.tcloudbase.com/doggie.jpg?imageSlim/format/heif/backup-format/jpg
imageSlim + format/heif + backup-format/jpg