导航
智能裁剪
最近更新时间：2024.06.03 15:21:35首次发布时间：2022.09.26 10:10:14
智能裁剪是 veImageX 提供的全新图片裁剪附加能力，支持对输入图片进行指定尺寸变换，可自动判断主体区域位置，支持自动化适配不同尺寸图片内容裁剪图片最佳区域。您可进入智能裁剪体验产品功能。
使用场景
- 动漫及游戏制作：遵循美学构图原则，可自动识别图片中对应动漫内容后保留其所在区域，可大幅节省人力提高成片效率。
- 封面制作：支持适配各类平台的素材尺寸规格，可自定义图片比例并输出结果图，进行客户端图像分发。
- 图像内容搜索：将原始素材进行智能裁剪，支持图片尺寸自动适配并识别出主体内容，提高搜索正确性。
前提条件
计费说明
智能裁剪功能属于附加组件下智能处理模块，属于后付费计费，使用后会产生附加组件智能处理费用。
使用限制
使用该组件前，请先确认智能裁剪的限制条件，详见附加组件使用限制。
操作步骤
模板配置
登录火山引擎控制台，选择 处理配置 > 新建模板，创建图片处理模板。
在新建模板的配置编辑中，关于模板基础输出设置参数及后续功能详细请见图像处理配置。
在编辑操作中选择 基础图像处理 > 裁剪 > 智能人脸裁剪，填写相应配置。
智能裁剪参数配置如下表所示。
基础裁剪
智能人脸裁剪
智能贴边裁剪
| 配置 | 说明 |
|---|---|
| 裁剪方式 | 支持裁剪方式如下所示： 1. 指定宽高裁剪 2. 内切圆裁剪 |
| 裁剪位置 | 支持居中、居上、居下、居左、居右、定向裁剪、自定义裁剪。 1. 选择居中、居上、居下、居左、居右时，将按照各个方向的中心为原点扩展边界； 2. 选择定向裁剪时，根据裁剪原点位置和宽高，确定裁剪区域，再根据裁剪起点位置进行偏移，裁剪该偏移区域和原图相交的地方； 3. 选择自定义裁剪时，需要设置左上角和右下角的坐标，以此为界裁剪成长方形。 |
| 设置大小 | 仅当选择居中、居上、居下、居左、居右时可设置； 可自定义裁剪边界的宽高值，当原图小于设置的宽高时，原图将不被裁剪。单位为 px。 |
| 起点X位置 | 仅当选择定向裁剪时可设置。 默认左上角为原点，取值范围为[0，图片边界]，取值如下所示： 1. X > 0：向右偏移； 2. X < 0：向左偏移。 |
| 起点Y位置 | 仅当选择定向裁剪时可设置。 默认左上角为原点，取值范围为[0，图片边界]，取值如下所示： 1. Y > 0 ：向下偏移； 2. Y < 0 ：向上偏移。 |
| 裁剪宽度 | 仅当选择定向裁剪时可设置。 裁剪后图像宽度，仅当选择定向裁剪时可设置，若裁剪宽度不指定，默认为 0，即为原图宽度。 |
| 裁剪高度 | 仅当选择定向裁剪时可设置。 裁剪后图像高度，仅当选择定向裁剪时可设置，若裁剪高度不指定，默认为 0，即为原图高度。 |
| 裁剪原点位置 | 仅当选择定向裁剪时可设置。 默认位于图片左上角，具体分布请见下图。 |
| 输入坐标 | 仅当选择自定义裁剪时可设置。 输入裁剪目标的左上角和右下角的 X 和 Y 值，确定最终裁剪范围。 |
| 内切半径 | 仅当选择内切圆时可设置。 取值为整数，取值范围为[1，2048]。 1. 如果指定半径大于原图最大内切圆的半径，则圆的大小仍然是图片的最大内切圆。 2. 如果图片的最终格式是 png、webp 等支持透明通道的格式，则图片非圆形区域的地方将以透明填充。 3. 如果图片的最终格式是 jpg，则非圆形区域是以白色进行填充。推荐您保存成 png 格式。 |
- 单击保存，完成模板创建。
获取地址
方式一 通过模板获取
登录火山引擎控制台，选择 资源管理，上传本地待处理图片或使用已有图片。
单击操作列获取地址按钮，选择域名以及建立好的智能裁剪模板，单击生成地址，在右侧界面选择地址链接进行复制或在线打开，查看图片裁剪效果。
说明
各类地址之间的区别，详见获取资源地址。
方式二 通过自拼接获取
创建图片裁剪模板以及上传待处理原图后，您可通过自拼接处理后图片 URL 方式获取模板处理后的结果图地址。
拼接格式：http(s)://服务下绑定的域名/图片URI~模板配置（创建的模板名称:{可选参数}.输出格式）
如下图所示。
说明
以上仅为举例，请以实际为准。如果存在中文字符，则以其 16 进制表示。
其他方式
OpenAPI
开通计费配置后，您可通过调用 GetImageSmartCropResult 获取智能裁剪结果图访问地址。
服务端 SDK
开通计费配置后，您可通过接入服务端 SDK 的方式，使用智能裁剪获取处理后图片地址。具体内容请参考：