veImageX
veImageX
- 文档首页
veImageX开发指南数据处理（proscessing）图像处理裁剪
文档反馈
问问助手您可以通过自定义图片裁剪参数，调整 veImageX 中存储图片大小。本文介绍 veImageX 图片处理中的图片裁剪功能参数及示例。
注意事项
计费说明
裁剪为 veImageX 的基础图片处理功能，其计费详情请参见后付费-按量计费。
基础裁剪
对于居中/上/下/左/右裁剪，实际裁剪时是按照各个方向的中心为基准来扩展裁剪边界，同时您需要指定裁剪边界的宽高。
居中裁剪
仅指定裁剪宽/高时，仅居中裁剪原图指定边，另一边保持不变。
- 仅指定宽，会从原图宽的左右两侧各裁剪（原图宽 - 指定宽）的一半，高保持不变。
- 仅指定高，将从原图高的上下两侧各裁剪（原图高 - 指定高）的一半，宽保持不变。
示例：
原图宽高为 1024x684，设置裁剪宽度为 600，高为 0。则会从原图宽的左右侧裁剪 1024-600 的一半，即 212。裁剪后图片宽高为：600x684。
结果图访问地址：https://p3-mofang.byteimg.com/tos-cn-i-x9vch4xmek/example.jfif~tplv-x9vch4xmek-crop:600:0.image
原图宽高为 1024x684，设置裁剪宽度为 0，高度为 600。则会从原图高的上下两侧各裁剪 684-600 的一半，即 42。再将裁剪后图片缩小为宽高：1024x600。
处理图访问地址：http://p3-mofang.byteimg.com/tos-cn-i-x9vch4xmek/example.jfif~tplv-x9vch4xmek-crop:0:60.image
居上裁剪
- 仅指定宽，会从原图宽的左右两侧各裁剪（原图宽 - 指定宽）的一半，高保持不变。
- 仅指定高，将从原图高的下侧裁剪（原图高 - 指定高），宽保持不变。
- 示例：
原图宽高为 1024x684，设置裁剪宽度为 600，高度为 0。则会从原图宽的左右侧裁剪 1024-600 的一半，即 212。裁剪后图片宽高为：600x684。
处理图访问地址：http://p3-mofang.byteimg.com/tos-cn-i-x9vch4xmek/example.jfif~tplv-x9vch4xmek-crop.up:600:0.image
原图宽高为 1024x684，设置裁剪宽度为 0，高度为 600。则会从原图高的下侧裁剪 684-600，即 84。裁剪后图片宽高为：1024x600。
处理图访问地址：http://p3-mofang.byteimg.com/tos-cn-i-x9vch4xmek/example.jfif~tplv-x9vch4xmek-crop.up:0:600.image
居下裁剪
- 仅指定宽，会从原图宽的左右两侧各裁剪（原图宽 - 指定宽）的一半，高保持不变。
- 仅指定高，将从原图高的上侧裁剪（原图高 - 指定高），宽保持不变。
- 示例：
原图宽高为 1024x684，设置裁剪宽度为 600，高度为 0。则会从原图宽的左右侧裁剪 1024-600 的一半，即 212。裁剪后图片宽高为：600x684。
处理图访问地址：http://p3-mofang.byteimg.com/tos-cn-i-x9vch4xmek/example.jfif~tplv-x9vch4xmek-crop.down:600:0.image
原图宽高为 1024x684，设置裁剪宽度为 0，高度为 600。则会从原图高的上侧裁剪 684-600，即 84。裁剪后图片宽高为：1024x600。
处理图访问地址：http://p3-mofang.byteimg.com/tos-cn-i-x9vch4xmek/example.jfif~tplv-x9vch4xmek-crop.down:0:600.image
居左裁剪
- 仅指定宽，会从原图宽的右侧裁剪（原图宽-指定宽），高保持不变。
- 仅指定高，将从原图高的上下两侧各裁剪（原图高 - 指定高）的一半，宽保持不变。
- 示例：
原图宽高为 1024x684，设置裁剪宽度为 600，高度为 0。则会从原图宽的左侧裁剪 1024-600，即 424。裁剪后图片宽高为：600x684。
处理图访问地址：http://p3-mofang.byteimg.com/tos-cn-i-x9vch4xmek/example.jfif~tplv-x9vch4xmek-crop.left:600:0.image
原图宽高为 1024x684，设置裁剪宽度为 0，高度为 600。则会从原图高的上下两侧各裁剪 684-600 的一半，即 42。裁剪后图片宽高为：1024x600。
处理图访问地址：http://p3-mofang.byteimg.com/tos-cn-i-x9vch4xmek/example.jfif~tplv-x9vch4xmek-crop.left:0:60.image
居右裁剪
- 仅指定宽，会从原图宽的左侧裁剪（原图宽-指定宽），高保持不变。
- 仅指定高，将从原图高的上下两侧各裁剪（原图高 - 指定高）的一半，宽保持不变。
- 示例：
原图宽高为 1024x684，设置裁剪宽度为 600，高度为 0。则会从原图宽的左侧裁剪 1024-600，即 424。裁剪后图片宽高为：600x684。
处理图访问地址：http://p3-mofang.byteimg.com/tos-cn-i-x9vch4xmek/example.jfif~tplv-x9vch4xmek-crop.right:600:0.image
原图宽高为 1024x684，设置裁剪宽度为 0，高度为 600。则会从原图高的上下两侧各裁剪 684-600 的一半，即 42。裁剪后图片宽高为：1024x600。
处理图访问地址：http://p3-mofang.byteimg.com/tos-cn-i-x9vch4xmek/example.jfif~tplv-x9vch4xmek-crop.right:0:60.image
定向裁剪
设置裁剪原点后（原点参考九宫格方位图），可基于该锚点自定义设置需要裁剪的宽高。
示例：原图宽高为 1024x684，设置相对于图片左上原点水平向右平移 100 像素，垂直向下平移 200 像素，指定目标图片大小为 600×400 进行裁剪。
自定义裁剪
通过设置裁剪区域在原图中左上角和右下角的坐标裁剪图片，默认原图左上顶点为坐标原点（0,0）。
示例：原图宽高为 1024x684，指定裁剪的左上角坐标为（100,40），右下角坐标为（400,400），裁剪后图片的宽高为 300x400。
内切圆裁剪
可以将图片裁剪为圆形，内切圆的圆心为图片的中心，并根据裁剪半径对图片进行裁剪，取值范围为 [1,原图短边的一半]。如果指定半径大于原图最大内切圆的半径，则圆的大小仍然是图片的最大内切圆。
如果图片的最终输出格式是 png、webp 等支持透明通道的图片，那么图片非圆形区域的地方将会以透明填充。如果图片的最终输出格式是 jpg，该格式不支持透明通道。那么非圆形区域是以白色进行填充。推荐保存成 png 格式。
示例：原图宽高为 1024x684，设置内切圆裁剪半径为 300。
结果图访问地址：http://p3-mofang.byteimg.com/tos-cn-i-x9vch4xmek/example.jfif~tplv-x9vch4xmek-crop.radius.image
智能人脸裁剪
该裁剪模型可智能识别普通人脸照片和动漫人脸图片中的人脸内容，并根据指定的裁剪宽高对图片进行裁剪，最终保留图片中人脸内容，输出结果图。
说明
- 裁剪以人脸为主，如果识别到人脸会将人脸区域尽量居中，不保证图片的完整性（比如会把文字截断等）。
- 通常在没有识别到可裁剪位置或者模型调用超时时，会进行降级处理。
若仅指定宽/高，一般则仅裁剪原图指定的那条边，另一边基本保持不变。
- 例如，原图宽高为 1024x1024，指定裁剪宽为 0，裁剪高为 300，则裁剪后图片的宽高为 1024 x 300。
若同时指定宽高，算法将在识别人脸时，根据原图宽高比进行智能裁剪，再将裁剪后图片缩小为指定宽高。
- 例如，原图宽高为 1024x1024，指定裁剪宽高为 500x300，则裁剪后图片宽高为 500x300。裁剪示意图如下所示。
结果图访问地址访问地址：http://p3-mofang.byteimg.com/tos-cn-i-x9vch4xmek/cartoon-face.png~tplv-x9vch4xmek-crop.face:500:300.image
智能贴边裁剪
该裁剪模型可智能裁剪纯色背景的各边纯色边框，仅保留核心图像。适用于裁剪背景色为纯色，需要删除图片多余纯色边框的场景。
示例：原图宽高为 1024x684，指定四条裁剪边框距离原图中内容的距离均为 0，且不指定输出图片的宽高。
处理方式
上传图片
通过控制台、服务端 SDK 上传一张测试原图。
- 控制台上传图片：参考上传资源在资源管理上传图片。
- 服务端 SDK 上传图片：参考 Golang-上传资源上传图片。
新建图片处理模板
在 veImageX 控制台的处理配置中，新建图片处理模板。并在模板中依次完成以下配置：
设置模板名称
指定一个模板处理后的图片格式
保存图片格式设置
设置裁剪，具体配置说明详见裁剪配置。
保存图片处理模板配置，完成模板的创建。
获取结果图地址
通过控制台、自拼接、OpenAPI 获取模板处理后的结果图地址。
- 控制台获取结果图地址：参考获取资源地址，获取模板处理后的结果图地址。
- 自拼接获取获取结果图地址：参考自拼接结果图访问地址，手动拼接模板处理后结果图地址。
- OpenAPI 获取结果图地址：参考GetResourceURL，获取结果图地址。