图片处理配置

为了方便用户对批量图像进行统一能力处理， veImageX 支持用户对内部功能进行配置修改并组合保存成模板。

计费概述

图片处理配置的不同配置项分属不同计费项，其中输出为 HEIC、HEIF、AVIF、AVIS 和 VVIC 格式时为高效图像压缩服务计费，截帧、小视频转动图属于增值服务计费项，此外其他配置均属于基础图像处理计费项。具体计费说明请参考产品计费文档。

前提条件

已开通 veImageX 服务，如未开通请参考服务管理。

注意事项

• 部分配置项支持 URL 动态传参，您在指定后，可以在支持在资源管理的 URL 中指定或更新该配置项的参数取值，以查看多种处理图效果。
• 如需在模板中使用画质增强、漫画风类增值服务，请在开通对应服务后再进行模板配置。
• 删除模板属于敏感（高危）操作，您可以参考安全设置为 IAM 子用户设置全局的安全规则。配置完成后，系统将在您执行敏感操作时要求进行二次校验，以保护您的账号安全。

操作步骤

新建模板

1. 登录 veImageX 控制台，进入处理配置页面，在下拉列表中选择相应的图片服务。

   说明

   此处仅展示类型为图像处理服务的 veImageX 服务。

   

2. 点击新建模板按钮，进入新增图片模板配置页面。

3. 参考编辑模板，完成参数配置后，单击保存完成模板创建。

编辑模板

1. 新建模板页面内，请参考下表配置常规输出设置。模板内支持实时预览到参数修改后示例图经过处理的效果。通过 URL 动态输入的参数，该编辑操作无法被预览。

   

   输出设置项说明如下表所示。

   编辑项	说明
   模板名称	自定义模板名称。当存在模板名重复时，系统将进行规避操作，保证模板名字唯一性。
   输出格式	默认 URL 的最后一个字节定义输出格式，当前支持格式如下： 原图格式: image 静图格式: png、jpeg、heic、avif、webp、vvic 动图格式：awebp、heif、avis
   自适应策略	支持 WEBP、HEIC、AVIF 自适应和智能策略。该能力属于高效图像压缩服务计费项。
   截帧	截帧服务一般针对视频/动图进行截图处理，可以配合裁剪或缩放等使用。该能力属于增值服务计费项。 动图截帧： 智能模式：从动图首帧开始逐帧检测当前帧亮度是否大于 80，并最终返回第一个亮度大于 80 的帧。 全局最优：从动图首帧开始逐帧检测并返回亮度最大的一帧。 超时时间：指定处理超时时间，若在指定时间范围内处理未完成则返回失败。取值范围为[100,10000]，单位为 ms。默认为 1500。 视频截帧： 智能模式：从视频首帧开始逐帧地检测当前帧是否为黑屏，并最终返回第一个非黑屏的帧。 指定时间：指定截帧时间。取值范围为[0,视频时长]，单位为 ms。默认为 0，表示返回首帧。若指定时间 > 视频长度，则返回视频最后一帧。
   小视频转动图	支持将视频格式文件转为动图格式文件，支持选择起始时间、转换时长、抽帧方式等。该能力属于增值服务计费项。
   渐进显示	仅当输出格式为 jpeg 时，支持开启。开启后会先显示图片的模糊轮廓，再加载为清晰的图片。
   动图强制转换	仅当输出格式为静图格式时支持设置，支持将输入的动图原图按照当前指定动图格式（AWEBP、HEIF、AVIS）输出并实现动图效果，不遵循静图输出格式。支持 URL 动态传参。
   鉴权保护	由于服务是按使用量计费，为防止其他人盗链而产生额外费用建议打开鉴权保护功能。 仅当设置了鉴权 key 之后，鉴权控制才能生效。
   png 瘦身	仅输出格式为 png 时可设置，开启后可配合压缩质量参数设置一起使用，是一种有损压缩方式。
   FPS 限制	降低 FPS 将改善动图的播放体验，开启后会对 FPS 超过限制值的动图进行抽帧处理，FPS 未超过限制值时不会进行处理。
   降级格式	用于首次访问处理超时返回的降级格式。
   ALPHA 编码	对于包含透明图的场景建议开启，若不开启则针对透明图场景默认采用降级的图片格式进行编码。
   色位深度	图像 10bit 编码，对图像每个通道用 10bit 来表示，相比 8bit 可以提供更多的色彩范围，可以使颜色变化的更加细腻，但会增加图像体积。
   缩略图	HEIF 缩略图是在原图基础上，编码缩小一定倍数的小分辨率图片，跟大图一起封装在同一张图片中，缩小倍数不建议过大，一般为 5~10 之间相对合理，当前仅输出为 heic 格式时涉及。
   ROI 编码	仅当输出为 heic 格式时支持配置。 兴趣区域图像编码，可通过算法手段对图像中包括文字的人眼感兴趣区域进行识别检测，并使用不同参数编码，达到码率分配更优的目的。 说明 例如，文字区域检测算法会定位图片中出现文字的区域，并用于图片的编码优化，使图片中文字区域的质量更高。
   渐进显示	开启后会先显示图片的模糊轮廓，再加载为清晰的图片。默认关闭。 仅支持 jpeg 格式，开启获取原图可能导致设置失效。
   防盗链	打开该功能需要设置失效期，失效期默认为URL参数序列中的最后一个。 在打开鉴权控制后，该功能才能生效。
   获取原图	该功能打开后，压缩和编辑操作无效。
   压缩质量参数	通过自定义压缩参数（默认为绝对质量参数）来修改原图质量。值越小，压缩率越高，画质越差。 支持 URL 输入。支持指定为相对质量参数。 除对 PNG 无损压缩外，其他格式和 PNG 瘦身模式下均有效。 注意 仅当原图格式为 jpeg 时，相对质量参数设置生效；若原图为其他格式，则等同于指定绝对质量参数。 仅当原图格式为 jpeg 时，您可通过在原图加载 URL 后拼接 ~info后，在浏览器访问拼接地址并查看quality值获取原图质量参数，例如https://p-test.com/imstore-test/taylor.jpg~info。 在选用 URL 输入后，您可以分别指定两种质量参数： 设置绝对质量参数为 70：q70 设置相对质量参数为 70：Q70 设置绝对质量参数：将原图质量压缩至指定百分比，如果原图质量小于指定参数值，则返回原图。 若原图质量为 95，模板指定固定值90时，返回最终图片质量为 90。 若原图质量为 80，模板指定固定值90时，返回最终图片质量为 80。 设置相对质量参数：相对于原图的压缩比，即对原图按指定百分比进行质量压缩。 若原图质量为 100，模板指定固定值90时，返回最终图片质量约为 90。 若原图质量为 80，模板指定固定值90时，返回最终图片质量约为 72。 指定体积输出：仅当输出为 jpeg 格式时支持配置。使用该配置后，您需要在 URL 中指定转码为 jpeg 后输出的图片体积大小，单位为 Byte。此功能开启后指定的编码质量参数无效。
   自适应质量编码	仅当输出为 heic 格式时支持配置。 在基准 压缩质量参数 前提下，根据图片信息的统计特性，选择最佳的编码参数，在不影响图片主观画质的情况下尽量减小图片体积。
   处理结果持久化	开启持久化配置后，将会按照您配置的智能降冷策略保存最终处理结果。此时持久化处理结果将按照资源存储计费项进行计量计费。 在您后续进行相同模板请求时，您可直接获取持久化处理结果，减少图像处理花费的时间和成本，提升使用体验。 说明 模板更新后，持久化处理结果不会通过刷新缓存被刷新，所以请先删除原有持久化处理结果后，再使用刷新缓存更新处理结果。 关闭持久化后，新增资源不再启用持久化能力，而历史资源仍然优先被读取持久化处理结果。
   模糊图占位	默认关闭。开启后，在弱网情况下使用客户端加载图片时，会首先展示出基于原图压缩/处理后的模糊色块图，以提升用户体验。
   自适应旋转	默认开启。开启后，将会根据原图中 EXIF 旋转信息，先自动旋转至正确方向显示后再进行图片处理。 建议开启该功能，否则有可能导致图片处理效果不符合预期。 说明 当原图格式为 jpeg、webp、png、avif、tiff、heic 时，自适应旋转配置生效。
   保留 EXIF 信息	默认关闭。开启后，可保留处理后的全部或部分 EXIF 信息。 全部保留 部分保留：自定义保留的 EXIF 类型，输入多个时以英文逗号分隔。常见类型有 Make、Model、PixelXDimension、PixelYDimension、UserComment、DateTime 等，更多信息请参考标准 EXIF 标签。 并非每一张图片都包含 EXIF 信息，您可通过查询查询图片 meta 信息在返回的 exif 字段查看图片包含的 EXIF 内容。 说明 仅当为以下两种场景时，保留 EXIF 信息配置生效： 原图格式为 png、jpeg、heic、webp、avif 且指定输出格式为 image 指定输出格式为 png、jpeg、heic、avif、webp 无论是否关闭自适应旋转，所有经模板处理后的图片均会被清除图片内的旋转信息。如需获取上传原图的旋转信息，请参考查询图片 meta 信息接口在返回的 exif 字段中获取。
   透明图降级 PNG	仅当输出为 jpeg 格式时支持配置。 默认关闭。开启后，若输入的原图带有 alpha 透明通道，最终输出格式将会由指定的 jpeg 格式降级为 png 格式。

2. 在编辑操作界面，请参考下表配置参数。

   

   编辑配置项说明如下表所示。

导入导出模板

veImageX 支持将配置好的图片处理模板导出，以 imagex 文件保存至本地。同时也支持将本地的模板文件导入，生成新的图片模板。

1. 选中要导出的图片处理模板，点击导出模板，将自动生成 imagex 文件保存至本地。

   

2. 点击导入模板，选择 imagex 模板文件上传。

   

后续操作

管理模板

1. 登录 veImageX 控制台，单击图片处理配置。

2. 您可以在图片处理配置页面执行以下操作。

• 预览： 在创建完成的模板页面，点击预览，可以在弹出的效果预览弹框查看图片处理效果、模板配置参数以及处理后示例图图片地址。

  

• 编辑： 点击编辑，重新进入该模板的配置编辑页面，修改模板参数，具体请参考编辑模板。

• 删除： 点击删除，在弹出的确认删除弹框中，输入要删除的模板名称，点击确认。删除模板成功。

  

• 回收站： 点击回收站，进入回收站页面。

  • 选择模板，点击恢复。在弹出的确认恢复框中单击确定，完成模板恢复。
  • 选择模板，点击删除。在弹出的确认删除模板框中输入模板名称后，单击确定。完成回收站内模板永久删除。
  

  说明

  在回收站删除模板后，该模板不可恢复。

调用 URL

1. 自拼接图片 URL 格式为：http(s)://域名/图片URI~模板配置（模板名称:{可选参数}.格式 ）

2. 可点击进入具体模板，在参数配置说明中查看该模板对应的参数输入顺序。

   

   

   说明

   以上仅为举例，请以实际为准。如果存在中文字符，则以其 16 进制表示。