文档

格式转换

更新时间:

通过格式转换参数,您无需将图片下载到本地进行转换,只需指定URL转换存储在OSS内原图的格式。本文介绍对图片进行格式转换时所用到的参数及示例。

使用场景

  • 适应不同设备和平台:不同的浏览器、操作系统或移动设备可能支持不同的图片格式。例如,WebP格式在浏览器上能提供更好的压缩效率,通过OSS图片格式转换,可以将上传的图片转换为多种格式,确保在各种终端上的兼容性和最佳显示效果。

  • 节省存储成本:某些图片格式(如WebP)在保证视觉质量的前提下,文件大小通常小于其他传统格式。通过格式转换功能,可以在不牺牲图像质量的情况下减少存储空间占用,从而降低存储成本。

  • 统一资源管理:在电商、社交、媒体等行业中,需要对大量用户上传的图片进行标准化处理。您可以将上传的图片统一转换成指定格式,便于后续的一致管理和分发。

参数说明

操作名称:format

参数说明如下:

取值范围

描述

jpg

将原图保存为JPG格式。

重要

不支持将存在透明通道的HEIC格式的图片保存为JPG格式。

png

将原图保存为PNG格式。

webp

将原图保存为WebP格式。

bmp

将原图保存为BMP格式。

gif

原图为GIF图片则继续保存为GIF格式;原图不是GIF图片,则按原图格式保存。

tiff

将原图保存为TIFF格式。

heic

将原图保存为HEIF格式。

说明

仅华北3(张家口)、华东2(上海)、华南1(深圳)、华东1(杭州)、华北2(北京)、新加坡地域支持HEIF格式。

avif

将原图保存为AVIF格式。

说明

仅华北3(张家口)、华东2(上海)、华南1(深圳)、华东1(杭州)、华北2(北京)、新加坡地域支持AVIF格式。

注意事项

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

    例如image/resize,w_100/format,jpg

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

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

  • 如果原图没有透明通道,转换成PNG、Web、BMP等存在透明通道的格式,默认会把透明填充成白色。

  • OSS不支持将透明色填充为黑色。

示例

您可以通过文件URL、SDK、API方式设置图片处理参数。本文以文件URL为例进行介绍。文件URL仅适用于公共访问的图片。如果是私有访问的图片,请使用SDK、API处理图片。更多信息,请参见图片处理操作方式

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

常见问题

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

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

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

图片格式转换的处理过程是否会影响页面加载速度?

图片格式转换的处理过程会影响您的页面加载速度。

GIF可以转换MP4格式么?

如果需要将GIF转换成MP4格式,请提交工单申请。

  • 本页导读 (1)
文档反馈