veImageX 当前支持您通过自定义访问 URL 的方式使用 T 版图片处理能力。您可以在源地址访问 URL 后拼接不同处理能力以及对应取值，以实现不同的图片处理效果。具体已支持能力、配置说明及相关访问示例如下所示。

注意事项

• 原图大小、分辨率等输入限制请参考图片处理使用限制。
• 该使用方式为白名单能力，使用前请提交工单联系技术支持完成相关配置。

前提条件

已开启自定义处理样式功能。

基础图片处理

快速缩略模版

您可通过以下常用图片处理模板，生成不同效果的缩略图。

imageView2/<mode>/w/<Width>
                 /h/<Height>
                 /format/<Format>
                 /q/<Quality>
                 /rq/<Quality>
                 /lq/<Quality>

示例

• 原图：https://imagexdemo.volcimagextest.com/tos-cn-i-i4o5y3y840/imagexdemo.jpeg

• 指定使用快速缩略模版 2 （缩略图的宽高最小值为 500 x 400）的处理图访问地址：https://imagexdemo.volcimagextest.com/tos-cn-i-i4o5y3y840/imagexdemo.jpeg?imageView2/2/w/500/h/400

缩放（thumbnail）

imageMogr2/thumbnail/<imageSizeAndOffsetGeometry>

示例

• 原图：https://imagexdemo.volcimagextest.com/tos-cn-i-i4o5y3y840/imagexdemo.jpeg

• 指定忽略原图宽高比例模式，宽高为 500x400 的处理图访问地址：https://imagexdemo.volcimagextest.com/tos-cn-i-i4o5y3y840/imagexdemo.jpeg?imageMogr2/thumbnail/500x400!

格式转换（format）

支持格式转换以及渐进显示。

imageMogr2/format/<Format>

示例

• 原图：https://imagexdemo.volcimagextest.com/tos-cn-i-i4o5y3y840/imagexdemo.jpeg

• 指定图片格式转换为 avif 的处理图访问地址：https://imagexdemo.volcimagextest.com/tos-cn-i-i4o5y3y840/imagexdemo.jpeg?imageMogr2/format/avif

高斯模糊（blur）

为图片增加模糊效果。

imageMogr2/blur/<radius>x<sigma>

示例

• 原图：https://imagexdemo.volcimagextest.com/tos-cn-i-i4o5y3y840/imagexdemo.jpeg

• 指定高斯模糊半径为 8，标准差为 5 的处理图访问地址：https://imagexdemo.volcimagextest.com/tos-cn-i-i4o5y3y840/imagexdemo.jpeg?imageMogr2/blur/8x5

旋转（rotate）

imageMogr2/rotate/<rotateDegree>
          /flip/<flip>

示例

• 原图：https://imagexdemo.volcimagextest.com/tos-cn-i-i4o5y3y840/imagexdemo.jpeg

• 指定顺时针旋转 60 度的处理图访问地址：https://imagexdemo.volcimagextest.com/tos-cn-i-i4o5y3y840/imagexdemo.jpeg?imageMogr2/rotate/60

裁剪（cut）

提供图片裁剪的功能，支持以下多种裁剪方式：

• 自定义裁剪：设置裁剪锚点后（锚点参考九宫格方位图），可基于该锚点自定义设置需要裁剪的宽高；

• 缩放裁剪：设置指定的宽高后，会先进行等比缩小后再裁剪；

• 内切圆裁剪：可以将图片裁剪为圆形；

• 圆角裁剪：可以将图片的四角裁剪为圆弧形；

• 人脸智能裁剪：可以自动识别图片内的人脸并裁剪出来；

• 自适应裁剪：按指定的宽高比对图片进行裁剪。

imageMogr2/cut/<width>x<height>x<dx>x<dy>
          /crop/<imageSizeAndOffsetGeometry>
          /iradius/<radius>
          /rradius/<radius>
          /rcrop/<MinRatio>x<MaxRatio>

示例

• 原图：https://imagexdemo.volcimagextest.com/tos-cn-i-i4o5y3y840/imagexdemo.jpeg

• 指定自定义裁剪，相对于图片左上顶点水平向右平移 100 像素，垂直向下平移 10 像素，指定目标图片大小为 600×600 进行裁剪的处理图访问地址：https://imagexdemo.volcimagextest.com/tos-cn-i-i4o5y3y840/imagexdemo.jpeg?imageMogr2/cut/600x600x100x10

• 指定缩放裁剪模式，宽高为 600x400 的处理图访问地址：https://imagexdemo.volcimagextest.com/tos-cn-i-i4o5y3y840/imagexdemo.jpeg?imageMogr2/crop/600x400

• 指定内切圆裁剪，半径为 200 的处理图访问地址：https://imagexdemo.volcimagextest.com/tos-cn-i-i4o5y3y840/imagexdemo.jpeg?imageMogr2/iradius/200

• 指定圆角裁剪，半径为 100 的处理图访问地址：https://imagexdemo.volcimagextest.com/tos-cn-i-i4o5y3y840/imagexdemo.jpeg?imageMogr2/rradius/100

• 指定自适应裁剪，宽高比的范围为最小 1:2，最大 1:1 的处理图访问地址：https://imagexdemo.volcimagextest.com/tos-cn-i-i4o5y3y840/imagexdemo.jpeg?imageMogr2/rcrop/50x100

渐进显示（interlace）

仅支持 jpeg 的渐进式加载。

imageMogr2/interlace/<Mode>

示例

• 原图：https://imagexdemo.volcimagextest.com/tos-cn-i-i4o5y3y840/imagexdemo.jpeg

• 指定设置为渐进显示的处理图访问地址：https://imagexdemo.volcimagextest.com/tos-cn-i-i4o5y3y840/imagexdemo.jpeg?imageMogr2/interlace/1

亮度（bright）

imageMogr2/bright/<value>

示例

• 原图：https://imagexdemo.volcimagextest.com/tos-cn-i-i4o5y3y840/imagexdemo.jpeg

• 指定亮度为 70 的处理图访问地址：https://imagexdemo.volcimagextest.com/tos-cn-i-i4o5y3y840/imagexdemo.jpeg?imageMogr2/bright/70

对比度（contrast）

imageMogr2/contrast/<value>

示例

• 原图：https://imagexdemo.volcimagextest.com/tos-cn-i-i4o5y3y840/imagexdemo.jpeg

• 指定对比度为 -50 的处理图访问地址：https://imagexdemo.volcimagextest.com/tos-cn-i-i4o5y3y840/imagexdemo.jpeg?imageMogr2/contrast/-50

锐化（sharpen）

imageMogr2/sharpen/<value>

示例

• 原图：https://imagexdemo.volcimagextest.com/tos-cn-i-i4o5y3y840/imagexdemo.jpeg

• 指定锐化为 70 的处理图访问地址：https://imagexdemo.volcimagextest.com/tos-cn-i-i4o5y3y840/imagexdemo.jpeg?imageMogr2/sharpen/70

灰度图（grayscale）

imageMogr2/grayscale/<value>

示例

• 原图：https://imagexdemo.volcimagextest.com/tos-cn-i-i4o5y3y840/imagexdemo.jpeg

• 指定转为灰度图的处理图访问地址：https://imagexdemo.volcimagextest.com/tos-cn-i-i4o5y3y840/imagexdemo.jpeg?imageMogr2/grayscale/1

获取图片 EXIF 信息（exif）

http://域名/文件存储路径?exif

示例

• 原图：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"
   },
   ...后续内容已省略...
}

获取图片基本信息（info）

http://域名/文件存储路径?imageInfo

示例

• 原图：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>

示例