格式转换
更新时间：2026-08-31
接口描述
图片格式转换用于将图片转换为指定的目标格式。
通过图片处理参数 x-bce-process=image/format,f_{format} 指定目标图片格式。format 支持取值为 jpg、png、bmp、webp、heic、gif、auto。
格式转换参数
action 名称：format
| 参数名 | 类型 | 必填 | 说明 |
|---|---|---|---|
f |
String | 是 | 指定目标图片格式。取值为 jpg、png、bmp、webp、heic、gif、auto。取值为 auto 时，根据请求 Header 中的 Accept 字段自动选择最优格式。 |
如果值为 auto，则根据请求 Header 中的 Accept 字段自动选择最优格式，当前支持自适应为 webp。如果无法匹配，则保持原图格式。响应头中会按照 HTTP 规范返回 Vary: Accept。
需要特别注意的是，使用 auto 时，单个链接会有多个缓存副本。如果使用百度智能云 CDN，则需要 CDN 开启多副本缓存功能。如果没有开启此功能，CDN 会缓存第一次请求的结果；当第一次请求返回的是 webp 格式时，会导致 Safari、IE 等浏览器看不到图片。2020/01/01 之后创建 CDN 域名默认都开启了此功能，之前创建的域名需要提工单开启。
示例
-
格式自适应，在 Chrome 等支持 WebP 的浏览器下返回为 WebP 格式，不支持 WebP 的浏览器中返回为原图格式。
https://doc.bce.baidu.com/bce-documentation/BOS/image.jpg?x-bce-process=image/format,f_auto
评价此篇文章