图像压缩质量参数设置多少比较合适？

图像压缩质量参数的设置仅针对有损压缩有效，目前支持有损压缩的格式有 webp、heic、jpeg 等。压缩参数值越小，压缩率越高，则图像画质越差，veImageX 默认压缩参数值为 75。

• 如果您的业务主打高清大屏、电视大屏等场景，您的压缩参数可以选择 85~90 的区间。
• 对于极端场景，在要求图像质量基本不变的情况下，可以设置压缩参数在 90 以上，此时图像大小会增大但实际画质并无太大差别。

图片地址是必须要通过接口获取吗？

否。
veImageX 支持自拼接 URL 以及控制台获取等方式来获取处理后图片地址。

• 您可直接使用域名、资源 URI 以及模板配置来自行拼接处理后图片 URL。具体 URL 拼接规则请参见 veImageX 控制台 > 图片处理配置（图片地址访问规则）。
• 您也可以在资源管理页面，在已上传的文件操作列，获取图片地址，veImageX 还提供了精简 URL 和源地址 URL 等，您可按照自己的需求进行选择。

图片处理降级格式的应用场景和处理逻辑？

对于图像处理分辨率过大或者编码耗时过高的场景，veImgaeX 会对图像进入降级模式异步进行编码，但目前仅针对特定格式，例如：动图、HEIF、AVIF 等格式。默认仅针对首次访问会进行降级，而对于附加组件的降级，请以附加组件的设置为准。

为什么模板输出格式没有 GIF？

veImageX 支持模板以 GIF 格式输出，但不建议使用 GIF 格式，因为其体积大，效果不好。若您想使用 GIF，则只需要将模板后缀改为 gif 即可。通常对于动图我们建议使用 awebp、heif、avis 等更先进的格式来代替 GIF。

windows 系统下如何浏览 heif 格式图片？

• 您可以在 Windows 10 上安装由 Microsoft 推出的 HEIF 图像拓展，这样您就可以使用系统自带的照片软件打开 HEIF 图像。
• 您也可以使用 veImageX 将图片导入后预览图像。

png 瘦身压缩优化，体积有可能不变正常吗？

PNG 瘦身，如果同时出现下面两种情况将有可能图片体积不变。

1. 没有任何图片处理（比如缩放、水印）。
2. 没有执行格式转换，即输入和输出图片都是 png 格式。

这是主要因为算法在做处理后图像体积变大了，因此为了保证体验，输出了原文件，这个时候会发现体积没有变化。

为什么 apng 动图经过 veImageX 图片处理后输出了一张静图？

veImageX 暂时不支持对 apng动图格式进行解码。如果模板配置了对图片做处理，即使输出.image格式也无法输出 apng 动图，只能降级生成 png 静图。如果您仅需要访问 apng 动图，可通过配置原图模板的方式来访问，即在模板中指定输出格式为 image，并开启获取原图。

使用模板裁剪、缩放数值设置为 0，还会对图片进行处理吗？

模板配置了缩放、裁剪等配置时，即使数值设置为 0，但 veImageX 依然会对图片进行处理，与原图会有相应差异。具体差异体现在修改了 MD5 值。

图片 url 加载报错 fail to make image decoder 的原因？

可能有以下几个原因。

• 源文件损坏。
• 源文件格式不支持，veImageX 无法解码源文件。支持格式请参考处理格式说明。
• 源文件超出处理范围，像素值或者文件的体积超限，具体请参考使用限制。

为什么同一张图，有时 info 信息里显示 orientation 为 Top-Left，有时 info 信息里显示为空？

info 信息中 orientation 为空或显示为 Top-Left 均表示不旋转，两者表示含义相同。具体请见~info Exif 介绍。

当 jpeg 转 heic 转 jpeg 时，如何使最终输出的 jpeg 与最初 jpeg 原图的体积大小基本保持一致？

首先在 jpeg 转 heic 时，需要将原图体积大小存储至 heic 图中。在 heic 转 jpeg 时，将读取存储的原图体积大小数据后输出 jpeg 结果图。具体配置操作详见以下内容。

1. 在 jpeg 转 heic 阶段：使 heic 存储原图体积大小数据
   • 服务端：支持以下两种配置方式
     1. 在 veImageX 控制台，创建仅执行转码的模板（除质量参数外，无其他处理配置）。
        1. 指定输出格式为 heic
        2. 开启 JPEG 转码复原
        3. 保存输出格式特殊配置
        4. 保存模板
           
     2. 在使用 CreateImageMigrateTask API 迁移 jpeg 图时，务必要指定 Transcode.Format 为 heic 以及 Transcode.ReserveJpegSize 为 true。
   • 客户端：使用 Android/iOS HEIF 编码库，在编码接口中指定 sourceSize（图片解码前的原始体积大小）。

     注意

     HEIF 编码库为 veImageX 的白名单能力，您需要购买 License 使用，具体请提交工单联系技术支持。

2. 在 heic 转 jpeg 阶段：读取 heic 中存储的体积大小并输出 jpeg 结果图
   • 服务端： 在 veImageX 控制台，创建仅执行转码的模板（除质量参数外，无其他处理配置）。
     1. 指定输出格式为 jpeg
     2. 在压缩质量参数配置中勾选 JPEG 转码复原
     3. 保存模板
        
   • 客户端：暂不支持配置

高斯模糊的模糊半径默认值是多少？

veImageX 仅支持您对高斯模糊的标准差（sigma）进行修改，而高斯模糊的模糊半径默认为标准差的 3 倍。

如何将彩色图片转为黑白图片？

通过降低图片的饱和度，使彩色图片转换为黑白图片。
示例，下表中展示了彩色原图，和将原图的饱和度调整为 -100 后的黑白结果图。

获取图片主题色失败，报错 {"code":5013,"error":"fail to process image by ai"}

获取主题色功能只适用于三通道（RGB）色彩空间的图片，其余色彩空间（如单通道的黑白图）不支持获取主题色。