您可以通过格式转换参数,转换存储在OSS内原图的格式。本文介绍对图片进行格式转换时所用到的参数及示例。

参数说明

操作名称:format

参数说明如下:

取值范围 描述
jpg 将原图保存为JPG格式。
重要 不支持将存在透明通道的HEIC格式的图片保存为JPG格式。
png 将原图保存为PNG格式。
webp 将原图保存为WebP格式。
bmp 将原图保存为BMP格式。
gif 原图为GIF图片则继续保存为GIF格式;原图不是GIF图片,则按原图格式保存。
tiff 将原图保存为TIFF格式。
heic 将原图保存为HEIF格式。
avif 将原图保存为AVIF格式。
说明 使用HEIF和AVIF格式需要开通图片高级压缩功能,压缩率更高,收费方式和基础图片处理不同。更多信息,请参见图片高级压缩
说明
  • 如果原图没有透明通道,转换成PNG、Web、BMP等存在透明通道的格式,默认会把透明填充成白色。
  • OSS不支持将透明色填充为黑色。

注意事项

  • 图片处理包含缩放操作时,建议将格式转换参数放到处理参数的最后。

    例如image/resize,w_100/format,jpg

  • 图片处理包含缩放和水印操作时,建议将格式转换参数添加在缩放参数之后。

    例如image/reisze,w_100/format,jpg/watermark,...

示例

本文示例使用的Bucket为杭州地域名为image-demo的Bucket,图片外网访问地址为:

常见问题

图片格式转换时出现黑边怎么办?

图片格式有默认质量,进行格式转换时如果没有指定质量,将按照默认质量进行转换,此时可能会出现图片有黑边的情况。

如果您希望提升图片质量,建议您转换格式时同步将质量指定为100(?x-oss-process=image/quality,Q_100)。关于质量变换的更多信息,请参见质量变换