智能图像扩展
最近更新时间：2024.01.24 18:12:24
首次发布时间：2023.01.06 14:01:52
veImageX 提供了图像智能扩展功能，支持对原图上下左右 4 个方向进行图片内容的扩展。算法会根据原图内容对扩展区域自动补充上相似内容，使补充结果图符合原图纹理与内容。您可进入智能图像扩展体验产品功能。
应用场景
- 广告展示平台适配：支持在广告主图片基础上做纯色的填充，适配不同的展示入口。可以有效避免图像放大缩小而带来的比例失调，提高图片利用率，减少处理工作量。
- 视觉素材设计，支持依据原图内容进行智能页面扩展，使扩展内容与原图的边沿融合自然。可提高您的图片处理效率，适应不同的设计需求。
使用限制
建议对原图分辨率小于等于 512 x 512 的图片执行扩展处理。经内部测试得出，其他尺寸的图片扩展效果较差。
在满足以下任一情况时，您可在原图的单方向（宽/高）进行最大 40% 的扩展处理。
- 横向拓展时：
- 情况 1：0.6 ≤ 原图宽高比 < 1.0
- 情况 2：当原图宽高比 ≥ 1.0 时，横向拓展长度需小于等于高度的 40%。
- 纵向拓展时：
- 情况 1：0.6 ≤ 原图高宽比 < 1.0
- 情况 2：当原图高宽比 ≥ 1.0 时，纵向拓展长度需小于等于宽度的 40%。
- 横向拓展时：
由于系统一次只能在一个方向（横向/纵向）上进行扩展处理，如果同时指定宽和高的扩展，将返回原图。
说明
如需分别对图片的宽和高进行扩展，您可进行两次扩展处理。如：首先，对图片宽进行左右两侧的扩展处理，然后对第一次的扩展结果图进行图片高的上下扩展处理。
前提条件
已完成服务配置。
计费说明
智能图像扩展功能属于增值服务项，故使用后会产生增值服务费用，当前支持后付费的计费方式，具体请参见增值服务。
操作步骤
开通服务
登录火山引擎控制台。
点击附加组件。
找到智能图像扩展组件，单击立即开通。
在订单确认界面，可了解计费模式、计费周期、服务区域、计费类型、计费项。单击确认订单。
页面显示提交成功，智能图像扩展组件开通成功。
模板配置
登录火山引擎控制台，选择 图片处理配置 > 新建模板，创建图片处理模板。
在新建模板的配置编辑中，关于模板基础输出设置参数及后续功能详细请见图像处理配置。
在编辑操作中选择 智能图像处理 > 智能图像扩展，填写相应配置。
智能图像扩展参数配置如下表所示。
| 配置 | 说明 |
|---|---|
| 向上填充 | 对输入图片沿上方扩展最多 40% 的图片边长，支持 URL 动态输入该值。 |
| 向下填充 | 对输入图片沿下方扩展最多 40% 的图片边长，支持 URL 动态输入该值。 |
| 向左填充 | 对输入图片沿左方扩展最多 40% 的图片边长，支持 URL 动态输入该值。 |
| 向右填充 | 对输入图片沿右方扩展最多 40% 的图片边长，支持 URL 动态输入该值。 |
模型选择 |
|
| 降级策略 | 即用于首次访问处理超时返回的降级格式，可选择优先返回处理后图片或原图。 |
是否持久化 | 处理后图片默认不占用 veImageX 存储，开启持久化配置后，veImageX 则会保存处理后结果图。 |
- 单击保存，完成模板创建。
获取地址
方式一 通过模板获取
- 登录火山引擎控制台，选择 资源管理 > 资源管理 > 上传文件，上传本地待处理图片。
- 选择域名以及建立好的智能图像扩展模板，单击生成地址，在右侧界面选择地址链接进行复制或在线打开，查看超分效果。
说明
如果您需要在获取地址查看并获取图像资源源地址，请在服务管理-基础配置下打开源地址访问功能。
对于支持 URL 动态输入的参数，您可在资源管理-获取地址的功能框中更改参数取值，进而获取不同处理效果结果图。
方式二 通过自拼接获取
您可在图片处理配置上传完原图后，通过自拼接处理后图像 URL 方式获取处理后图片地址。
拼接格式：http(s)://服务下绑定的域名/图片URI~模板配置（创建的模板名称:{可选参数}.输出格式）
如下图所示。
说明
以上仅为举例，请以实际为准。如果存在中文字符，则以其 16 进制表示。
其他方式
OpenAPI
完成服务开通后，您可通过调用 OpenAPI 的方式，获取图像扩展处理后图片地址。详细请见 GetImageBgFillResult。
服务端 SDK
完成服务开通后，您可通过接入服务端 SDK 的方式，调用接口从而获取图像扩展处理后图片地址。具体内容请参考：