veImageX 当前支持您通过自定义访问 URL 的方式使用 T 版图片处理能力。您可以在源地址访问 URL 后拼接不同处理能力以及对应取值,以实现不同的图片处理效果。具体已支持能力、配置说明及相关访问示例如下所示。
已开启自定义处理样式功能。
您可通过以下常用图片处理模板,生成不同效果的缩略图。
imageView2/<mode>/w/<Width> /h/<Height> /format/<Format> /q/<Quality> /rq/<Quality> /lq/<Quality>
参数 | 含义 |
---|---|
/0/w/ | 限定缩略图的长边最多为
当图片长宽相同时,默认长边为图片的高。 |
/1/w/ | 限定缩略图的宽高最小值。该操作会将图像等比缩放直至某一边达到设定最小值,之后将另一边居中裁剪至设定值。若只指定一边,则表示宽高相等的正方形。 |
/2/w/ | 限定缩略图的宽高最大值。该操作会将图像等比缩放至宽高都小于设定最大值。 |
/3/w/ | 限定缩略图的宽高最小值。该操作会将图像等比缩放至宽高都大于设定最小值。 |
/4/w/ | 限定缩略图的长边和短边的最小值分别为 |
/5/w/ | 限定缩略图的长边和短边的最大值分别为 |
/format/ | 目标缩略图的图片格式, |
/q/ | 图片质量,取值范围为 0 - 100,默认值为原图质量;取原图质量和指定质量的最小值; |
/rq/ | 图片的相对质量,取值范围 0 - 100,数值以原图质量为标准。 |
/lq/ | 图片的最低质量,取值范围为 0 - 100,设置结果图的质量参数最小值。
|
示例
https://imagexdemo.volcimagextest.com/tos-cn-i-i4o5y3y840/imagexdemo.jpeg
https://imagexdemo.volcimagextest.com/tos-cn-i-i4o5y3y840/imagexdemo.jpeg?imageView2/2/w/500/h/400
imageMogr2/thumbnail/<imageSizeAndOffsetGeometry>
参数 | 含义 |
---|---|
/thumbnail/! | 指定图片的宽高为原图的 |
/thumbnail/! | 指定图片的宽为原图的 |
/thumbnail/!x | 指定图片的高为原图的 |
/thumbnail/ | 指定目标图片宽度为 |
/thumbnail/x | 指定目标图片高度为 |
/thumbnail/ | 限定缩略图的宽度和高度的最大值分别为 说明
|
/thumbnail/! | 限定缩略图的宽度和高度的最小值分别为 说明
|
/thumbnail/ | 限定缩略图的宽度和高度的最大值分别为 说明
|
/thumbnail/ | 限定缩略图的宽度和高度的最大值分别为 说明
|
/thumbnail/ | 忽略原图宽高比例,指定图片宽度为 |
/thumbnail/@ | 等比缩放图片,缩放后的图像,总像素数量不超过 Area。 |
/pad/ | 将原图缩放为指定
|
/color/ | 填充颜色,缺省为白色,需设置为十六进制 RGB 格式(如 #FF0000),详情参考 RGB 编码表,需经过 URL 安全的 Base64 编码,默认值为 #FFFFFF。 |
示例
https://imagexdemo.volcimagextest.com/tos-cn-i-i4o5y3y840/imagexdemo.jpeg
https://imagexdemo.volcimagextest.com/tos-cn-i-i4o5y3y840/imagexdemo.jpeg?imageMogr2/thumbnail/500x400!
支持格式转换以及渐进显示。
imageMogr2/format/<Format>
参数 | 是否必选 | 含义 |
---|---|---|
/format/ | 是 | 将原图转换为指定格式, |
示例
https://imagexdemo.volcimagextest.com/tos-cn-i-i4o5y3y840/imagexdemo.jpeg
https://imagexdemo.volcimagextest.com/tos-cn-i-i4o5y3y840/imagexdemo.jpeg?imageMogr2/format/avif
为图片增加模糊效果。
imageMogr2/blur/<radius>x<sigma>
参数 | 含义 |
---|---|
设置模糊半径,取值范围为 1 - 50,数值越大,图片越模糊。 | |
设置正态分布的标准差,必须大于 0,数值越大,图片越模糊。 |
示例
https://imagexdemo.volcimagextest.com/tos-cn-i-i4o5y3y840/imagexdemo.jpeg
https://imagexdemo.volcimagextest.com/tos-cn-i-i4o5y3y840/imagexdemo.jpeg?imageMogr2/blur/8x5
imageMogr2/rotate/<rotateDegree> /flip/<flip>
参数 | 含义 |
---|---|
/rotate/ | 普通旋转:图片顺时针旋转角度,取值范围为 0 - 360,默认不旋转。 |
/flip/ | 镜像翻转,
|
示例
https://imagexdemo.volcimagextest.com/tos-cn-i-i4o5y3y840/imagexdemo.jpeg
https://imagexdemo.volcimagextest.com/tos-cn-i-i4o5y3y840/imagexdemo.jpeg?imageMogr2/rotate/60
提供图片裁剪的功能,支持以下多种裁剪方式:
imageMogr2/cut/<width>x<height>x<dx>x<dy> /crop/<imageSizeAndOffsetGeometry> /iradius/<radius> /rradius/<radius> /rcrop/<MinRatio>x<MaxRatio>
裁剪方式 | 参数 | 含义 |
---|---|---|
自定义裁剪 | /cut/ | 指定目标图片的宽为 |
/cut/ | 指定目标图片的高为 | |
/cut/ | 相对于图片裁剪锚点 | |
/cut/ | 相对于图片裁剪锚点 | |
/cut/gravity/ | 图片裁剪的锚点位置,默认为左上顶点 northwest,详情请参见九宫格方位图。 | |
缩放裁剪 | /crop/ | 先限定图片宽度最小值为 width,高度最小值为 height ,进行等比缩小,然后以宽为 width,高为 height 进行居中裁剪, |
/crop/gravity/ | 图片裁剪的锚点位置,默认为中心点 center,详情请参见 九宫格方位图。 | |
内切圆裁剪 | /iradius/ | 内切圆裁剪功能,
|
圆角裁剪 | /rradius/ | 圆角裁剪功能,
|
自适应裁剪 | /rcrop/ | 基于指定的图片宽高比范围进行裁剪。
|
示例
https://imagexdemo.volcimagextest.com/tos-cn-i-i4o5y3y840/imagexdemo.jpeg
https://imagexdemo.volcimagextest.com/tos-cn-i-i4o5y3y840/imagexdemo.jpeg?imageMogr2/cut/600x600x100x10
https://imagexdemo.volcimagextest.com/tos-cn-i-i4o5y3y840/imagexdemo.jpeg?imageMogr2/crop/600x400
https://imagexdemo.volcimagextest.com/tos-cn-i-i4o5y3y840/imagexdemo.jpeg?imageMogr2/iradius/200
https://imagexdemo.volcimagextest.com/tos-cn-i-i4o5y3y840/imagexdemo.jpeg?imageMogr2/rradius/100
https://imagexdemo.volcimagextest.com/tos-cn-i-i4o5y3y840/imagexdemo.jpeg?imageMogr2/rcrop/50x100
仅支持 jpeg 的渐进式加载。
imageMogr2/interlace/<Mode>
参数 | 含义 |
---|---|
/interlace/ | 输出为渐进式 jpg 格式。
该参数仅在输出图片格式为 jpg 格式时有效。如果输出非 jpg 图片格式,会忽略该参数,默认值为 0。 |
示例
https://imagexdemo.volcimagextest.com/tos-cn-i-i4o5y3y840/imagexdemo.jpeg
https://imagexdemo.volcimagextest.com/tos-cn-i-i4o5y3y840/imagexdemo.jpeg?imageMogr2/interlace/1
imageMogr2/bright/<value>
参数 | 含义 |
---|---|
/bright/ | 图片亮度调节功能,
|
示例
https://imagexdemo.volcimagextest.com/tos-cn-i-i4o5y3y840/imagexdemo.jpeg
https://imagexdemo.volcimagextest.com/tos-cn-i-i4o5y3y840/imagexdemo.jpeg?imageMogr2/bright/70
imageMogr2/contrast/<value>
参数 | 含义 |
---|---|
/contrast/ | 图片对比度调节功能,
|
示例
https://imagexdemo.volcimagextest.com/tos-cn-i-i4o5y3y840/imagexdemo.jpeg
https://imagexdemo.volcimagextest.com/tos-cn-i-i4o5y3y840/imagexdemo.jpeg?imageMogr2/contrast/-50
imageMogr2/sharpen/<value>
参数 | 含义 |
---|---|
/sharpen/ | 图片锐化功能, |
示例
https://imagexdemo.volcimagextest.com/tos-cn-i-i4o5y3y840/imagexdemo.jpeg
https://imagexdemo.volcimagextest.com/tos-cn-i-i4o5y3y840/imagexdemo.jpeg?imageMogr2/sharpen/70
imageMogr2/grayscale/<value>
参数 | 含义 |
---|---|
/grayscale/ | 将图片设置为灰度图。
|
示例
https://imagexdemo.volcimagextest.com/tos-cn-i-i4o5y3y840/imagexdemo.jpeg
https://imagexdemo.volcimagextest.com/tos-cn-i-i4o5y3y840/imagexdemo.jpeg?imageMogr2/grayscale/1
http://域名/文件存储路径?exif
配置 | 说明 |
---|---|
域名 | veImageX 图像处理服务中绑定的域名,状态为正常可用,您可在控制台获取。 |
文件存储路径 | 和域名同一个服务下存储的文件路径,您可在控制台获取。 |
示例
https://imagexdemo.volcimagextest.com/tos-cn-i-i4o5y3y840/imagexdemo.jpeg
https://imagexdemo.volcimagextest.com/tos-cn-i-i4o5y3y840/imagexdemo.jpeg?exif
具体返回参数如下所示
{ "Artist":{ "val":"Pedro Salaverria" }, "ColorSpace":{ "val":"sRGB" }, "Contrast":{ "val":"Normal" }, "Copyright":{ "val":"Pedro Salaverria (Photographer) - [None] (Editor)" }, "CustomRendered":{ "val":"Normal process" }, "DateTime":{ "val":"2016:04:14 16:24:38" }, "DateTimeDigitized":{ "val":"2016:04:14 16:24:38" }, "DateTimeOriginal":{ "val":"2016:04:14 16:24:38" }, "DigitalZoomRatio":{ "val":" 1" }, "ExifVersion":{ "val":"Exif Version 2.1" }, "ExposureBiasValue":{ "val":"0.00 EV" }, "ExposureMode":{ "val":"Manual exposure" }, "ExposureProgram":{ "val":"Manual" }, "ExposureTime":{ "val":"1/500 sec." }, "FNumber":{ "val":"f/8.0" }, "FileSource":{ "val":"DSC" }, "Flash":{ "val":"Flash did not fire, compulsory flash mode" }, ...后续内容已省略... }
http://域名/文件存储路径?imageInfo
配置 | 说明 |
---|---|
域名 | veImageX 图像处理服务中绑定的域名,状态为正常可用,您可在控制台获取。 |
文件存储路径 | 和域名同一个服务下存储的文件路径,您可在控制台获取。 |
示例
https://imagexdemo.volcimagextest.com/tos-cn-i-i4o5y3y840/imagexdemo.jpeg
https://imagexdemo.volcimagextest.com/tos-cn-i-i4o5y3y840/imagexdemo.jpeg?imageInfo
具体返回参数如下所示:
{ "size": 63859, //文件大小,单位为 Byte "format": "jpeg", //图片格式 "width": 1023, //宽度,单位为 px "height": 683, //高度,单位为 px "orientation": "Top-left" //记录图片拍摄的相机的旋转信息 }
您可通过|
分隔多种处理样式,实际处理时会按照先后顺序对图片进行不同处理,当前最多支持 10 层管道。
规则:http://域名/文件存储路径?imageMogr2/<操作1>|imageMogr2/<操作2>
配置 | 说明 |
---|---|
域名 | veImageX 图像处理服务中绑定的域名,状态为正常可用,您可在控制台获取。 |
文件存储路径 | 和域名同一个服务下存储的文件路径,您可在控制台获取。 |
示例
https://imagexdemo.volcimagextest.com/tos-cn-i-i4o5y3y840/imagexdemo.jpeg
https://imagexdemo.volcimagextest.com/tos-cn-i-i4o5y3y840/imagexdemo.jpeg?imageMogr2/blur/8x5|imageMogr2/thumbnail/!50p
T 版支持的管道操作符为 |
,使用其他符号(如 ?
)连接不同处理样式将无法正常生效,尽管参数解析可能不报错。如果您遇到该问题,可以自行检查请求参数,或者联系技术支持寻求帮助。