智能裁剪
最近更新时间：2023.04.21 18:14:32
首次发布时间：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 格式。 |
- 单击保存，完成模板创建。
获取结果图
方式一 通过模板获取
- 登录火山引擎控制台，选择 资源管理 > 资源管理 > 上传文件，上传本地待处理图片。
- 选择域名以及建立好的智能裁剪模板，单击生成地址，在右侧界面选择地址链接进行复制或在线打开，查看图片裁剪效果。
方式二 通过调用 OpenAPI 获取
在创建模板后，您可以通过调用 GetImageSmartCropResult 获取经模板处理后的结果图访问地址。
说明
- 当前 GetImageSmartCropResult 中仅开放了智能人脸裁剪能力；
- 基础裁剪以及贴片裁剪能力，请参考 CreateImageTemplate创建模板并参考GetResourceURL获取裁剪后结果图。
方式三 通过调试 SDK 获取
开通服务后，您可通过接入服务端 SDK 的方式，使用智能裁剪获取处理后图片地址。具体内容请参考：
说明
当前 SDK 中仅开放了智能人脸裁剪能力，其他裁剪能力还在陆续开放中，敬请期待。
方式四 通过自拼接获取
您可在图片处理配置上传完原图后，通过自拼接处理后图片 URL 方式获取处理后图片地址。
拼接格式：http(s)://服务下绑定的域名/图片URI~模板配置（创建的模板名称:{可选参数}.输出格式）
如下图所示。
说明
以上仅为举例，请以实际为准。如果存在中文字符，则以其 16 进制表示。