裁剪

您可以通过自定义图片裁剪参数，调整 veImageX 中存储图片大小。本文介绍 veImageX 图片处理中的图片裁剪功能参数及示例。

裁剪类型

基础裁剪

• 指定宽高裁剪（按比例裁剪并缩放）：
  寻找裁剪区域：根据设置大小的比例和裁剪位置计算裁剪位置，即使输出大小是 1x1 像素，也是先在原图上寻找一个尽可能大的正方形裁剪区域。
• 内切圆裁剪：
  • 如果指定半径大于原图最大内切圆的半径，则圆的大小仍然是图片的最大内切圆。
  • 如果图片的最终格式是 png、webp 等支持透明通道的图片，那么图片非圆形区域的地方将会以透明填充。
  • 如果图片的最终格式是 jpg，那么非圆形区域是以白色进行填充。推荐保存成 png 格式。

智能人脸裁剪

提供了普通人脸裁剪和动漫人脸裁剪两种选择，根据设置的大小比例进行裁剪，且对原图只会缩小不会放大。

• 裁剪以人脸为主，如果识别到人脸会将人脸区域尽量居中，不保证图片的完整性(比如会把文字截断等)。
• 通常在没有识别到可裁剪位置或者模型调用超时时会进行降级处理。

智能贴边裁剪

适用于裁剪背景色为纯白或纯黑的图片，如果原图有接近纯色的边框需要删除，可以使用该裁剪方式去掉四边纯色边框。

注意事项

• 支持动图静图的裁剪处理。
• 控制台支持通过 URL 动态输入裁剪设置大小。
• 裁剪为 veImageX 的基础图片处理功能，其计费详情请参见后付费-按量计费。

效果图

基础裁剪

以下展示了指定 600x600 裁剪结果图与原图的图片对比。

处理图访问地址如下所示，您可在网站输入该地址并自定义裁剪宽高值，查看多种图片裁剪效果：

http://p3-mofang.byteimg.com/tos-cn-i-x9vch4xmek/example.jfif~tplv-x9vch4xmek-crop:600:600.image

原图	指定 600x600 裁剪结果图

智能人脸裁剪

原图	指定宽高 400x400 裁剪结果图

使用方法

使用控制台

Step 1：创建模板

您可以通过登录 veImageX 控制台创建模板，具体操作详情请参考新建模板。

Step 2：获取结果图访问地址

如果您已在控制台创建好模板，则在控制台获取您的结果图访问地址的具体操作请参考获取结果图 URL。

使用 OpenAPI

Step 1：创建模板

您可以通过调用 CreateImageTemplate创建您的模板，veImageX 也支持在该接口与其他功能进行组合配置创建模板。

Step 2：获取结果图访问地址

在创建模板后，您可以通过调用 GetResourceURL获取经模板处理后的结果图访问地址。

案例讲解

在调用 CreateImageTemplate 接口创建模板时，您需要设置Filters组合参数配置您的图片处理功能配置，具体的参数配置请参考图片编辑数据结构。

• Name取值为crop：即裁剪功能名称；
• Param为具体的操作参数：Key为裁剪各参数名称，Value为相应参数设置。

上图案例中饱和度为 50的Filters关键请求示例如下所示。

"Filters":[
      {
         "Name":"crop",
         "Param":{
		        "crop":5,                           //裁剪方式为居中裁剪
		        "width":600,                          //裁剪后图像宽度为600px
		        "height":600,                          //裁剪后图像高度为600px
            }
       }
  ]