jpeg

渐进显示

开启后会先显示图片的模糊轮廓，再加载为清晰的图片。但开启获取原图配置后可能导致设置失效。
需搭配客户端加载 SDK 实现图片的渐进式加载，详见使用移动端 SDK 实现图片渐进式加载。

自适应质量编码

在基准压缩质量参数的前提下，根据图片信息的统计特性，选择最佳的编码参数，在不影响图片主观画质的情况下尽量减小图片体积。

• 模型：
  • v2：图片码率可节省约 10%+。
  • v3：相较于 v2 模型，图片的画质更优，图片码率可节省约 5% ~ 10%。
• 像素限制：您可通过指定格式转换后的图片的长 * 宽的最大像素，使满足该像素限制的图片使用指定模型实现自适应质量编码。默认值为 10000000px，最大值不得超过图片处理分辨率限制。

自适应质量编码

在基准压缩质量参数的前提下，根据图片信息的统计特性，选择最佳的编码参数，在不影响图片主观画质的情况下尽量减小图片体积。

• 模型：
  • v2：图片码率可节省约 10%+。
  • v3：相较于 v2 模型，图片的画质更优，图片码率可节省约 5% ~ 10%。
• 像素限制：您可通过指定格式转换后的图片的长 * 宽的最大像素，使满足该像素限制的图片使用指定模型实现自适应质量编码。默认值为 10000000px，最大值不得超过图片处理分辨率限制。

缩略图

HEIF 缩略图是在原图基础上，编码缩小一定倍数的小分辨率图片，跟大图一起封装在同一张图片中，缩小倍数不建议过大，一般为 5~10 之间相对合理。
需搭配客户端加载 SDK 实现图片的渐进式加载，详见使用移动端 SDK 实现图片渐进式加载。

JPEG 转码复原

具体场景使用方式，详见当 jpeg 转 heic 转 jpeg 时，如何使最终输出的 jpeg 与最初 jpeg 原图的体积大小基本保持一致？

自适应质量编码

在基准压缩质量参数的前提下，根据图片信息的统计特性，选择最佳的编码参数，在不影响图片主观画质的情况下尽量减小图片体积。

• 模型：
  • v1：图片码率可节省约 5%。
  • v2：图片码率可节省约 10%+。
  • v3：相较于 v2 模型，图片的画质更优，图片码率可节省约 5% ~ 10%。
• 像素限制：您可通过指定格式转换后的图片的长 * 宽的最大像素，使满足该像素限制的图片使用指定模型实现自适应质量编码。默认值为 10000000px，最大值不得超过图片处理分辨率限制。

通过自定义压缩参数来修改原图质量。值越小，压缩率越高，画质越差。质量参数类型分为绝对质量参数和相对质量参数，默认为绝对质量参数。支持 URL 输入。

除对 PNG 无损压缩外，其他格式和 PNG 瘦身模式下均有效。

• 设置绝对质量参数：将原图质量压缩至指定百分比，如果原图质量小于指定参数值，则返回原图。

  • 若原图质量为 95，模板指定固定值90时，返回最终图片质量为 90。
  • 若原图质量为 80，模板指定固定值90时，返回最终图片质量为 80。

• 设置相对质量参数：相对于原图的压缩比，即对原图按指定百分比进行质量压缩。

  注意

  仅当输出为 jpeg 或 webp 时支持配置，且仅当原图格式为 jpeg 时，设置才会生效。若原图为其他格式，则等同于指定绝对质量参数。

  • 若原图质量为 100，模板指定固定值90时，返回最终图片质量约为 90。
  • 若原图质量为 80，模板指定固定值90时，返回最终图片质量约为 72。
• 指定体积输出：仅当输出为 jpeg 格式时支持配置，支持以下两种配置方式：
  • URL 输入：勾选后，您需要在 URL 中指定转码为 jpeg 后输出的图片体积大小，单位为字节（Byte）。此功能开启后，您指定的编码质量参数则为无效配置。
    指定体积输出的取值范围如下所示。
    • 最小取值：绝对质量参数为 5 处理原图后的体积大小。
    • 最大取值：原图的宽度像素值 x 高度像素值 x 8 的值。
  • JPEG 转码复原：仅当原图为 heic 时生效。勾选后，将按照 heic 中存储的原图体积大小输出对应体积的 jpeg 结果图。
    具体场景使用方式，详见当 jpeg 转 heic 转 jpeg 时，如何使最终输出的 jpeg 与最初 jpeg 原图的体积大小基本保持一致？

输出体积上限

仅当指定输出格式为 jpeg 和 webp 时，支持配置。

默认关闭，开启后，您需要在 URL 中指定输出的图片体积上限，单位为字节（Byte）。如果图片按照模板中配置的质量参数进行压缩处理后，其大小超过了指定的体积上限，那么系统将自动调整质量参数的大小，直到压缩后的图片大小低于指定的上限。

动图强制转换

仅当指定输出格式为 png、jpeg、webp、avif、heic 和 vvic 时，支持配置。

支持将输入的动图原图按照当前指定动图格式（awebp、heif、avis）输出并实现动图效果，不遵循静图输出格式。支持 URL 动态传参。

截帧

仅当指定输出格式为 png、jpeg、webp、avif、heic 和 vvic 时，支持配置。

截帧服务一般针对视频/动图进行截图处理，可以配合裁剪或缩放等使用。该能力属于增值服务计费项。

• 动图截帧：
  • 智能模式：从动图首帧开始逐帧检测当前帧亮度是否大于 80，并最终返回第一个亮度大于 80 的帧。
  • 全局最优：从动图首帧开始逐帧检测并返回亮度最大的一帧。
  • 超时时间：指定处理超时时间，若在指定时间范围内处理未完成则返回失败。取值范围为[100,10000]，单位为 ms。默认为 1500。
• 视频截帧：
  • 智能模式：从视频首帧开始逐帧地检测当前帧是否为黑屏，并最终返回第一个非黑屏的帧。
  • 指定时间：指定截帧时间。取值范围为[0,视频时长]，单位为 ms。默认为 0，表示返回首帧。若指定时间 > 视频长度，则返回视频最后一帧。

FPS 限制

仅当指定输出格式为 awebp、avis 和 heif 时，支持配置。

默认关闭，开启后，可对帧率超过指定 FPS 值的动图进行抽帧处理，从而降低帧率，达到在特定情况下改善动图播放体验的效果。

小视频转动图

仅当指定输出格式为 awebp、avis 和 heif 时，支持配置。

支持将视频格式文件转为动图格式文件，支持选择起始时间、转换时长、抽帧方式等。该能力属于增值服务计费项。详细说明请参考小视频转动图。

自适应旋转

仅当输出格式为 image、png、jpeg、webp、avif 和 heic 时支持配置，同时仅当原图格式为 jpeg、webp、png、avif、tiff、heic 时，该配置才会生效。

默认开启。开启后，将会根据原图中 EXIF 旋转信息，先自动旋转至正确方向显示后再进行图片处理。建议开启该功能，否则有可能导致图片处理效果不符合预期。

保留 EXIF 信息

默认关闭。开启后，可保留处理后的全部或部分 EXIF 信息。

• 保留全部信息
• 保留部分信息：自定义保留的 EXIF 类型，输入多个时以英文逗号分隔。常见类型有 Make、Model、PixelXDimension、PixelYDimension、UserComment、DateTime 等，更多信息请参考标准 EXIF 标签。

并非每一张图片都包含 EXIF 信息，您可通过查询查询图片 meta 信息在返回的 exif 字段查看图片包含的 EXIF 内容。

处理结果持久化

开启持久化配置后，将会按照您配置的智能降冷策略保存最终处理结果。此时持久化处理结果将按照资源存储计费项进行计量计费。
在您后续进行相同模板请求时，您可直接获取持久化处理结果，减少图像处理花费的时间和成本，提升使用体验。