文档中心>数据万象>API 文档>图片处理>图片基础压缩(WebP)

图片基础压缩(WebP)

最近更新时间:2024-04-09 15:54:31

我的收藏

功能描述

图片压缩指在图片质量保持不变的情况,尽可能的减小图片大小,以达到节省图片存储空间、减少图片访问流量、提升图片访问速度的效果。
数据万象(Cloud Infinite,CI) 产品推出了 WebP 压缩功能,可将图片转换为 webp 压缩图片格式,其在压缩方面相比 jpg 格式更优越。在相同图片质量的情况下,webp 格式图片要比 jpg 格式图片减小25%以上,可以适配多终端使用场景。

授权说明

通过子账号使用时,需要授予对应权限,具体请参见 COS action,CI 其他权限请参见 数据万象 action
下载时处理:授权策略中 action 设置为 cos:GetObject
上传时处理:授权策略中 action 设置为 cos:PutObject
云上数据处理:授权策略中 action 设置为 cos:GetObjectcos:PutObject(注意 GetObject 对应的 resource 为源文件,PutObject 对应的 resource 为转存的文件)。

服务开通

使用该功能将默认为您开通数据万象,并绑定存储桶,无需角色授权,即可直接使用。

使用限制

使用该接口时,请先确认相关限制条件。详情请参见 使用限制

费用说明

WebP 压缩为付费服务,费用同基础图片处理,具体费用请参见 图片处理费用,产生的费用将由数据万象收取。
如果采用下载时处理的方式,且通过外网进行下载,调用会产生 流量费用
说明:
图片转换为 WebP 格式后,部分浏览器无法读取 WebP 图片的 exif 信息,导致没有旋转。您可参见 旋转 文档,增加 auto-orient 参数,对原图旋转后再进行压缩。
WebP 压缩默认继承原始图片的质量参数。您可参见 质量变换 文档,通过修改图片质量来调节压缩率。

接口示例

1. 下载时处理

GET /<ObjectKey>?imageMogr2/format/webp HTTP/1.1
Host: <BucketName-APPID>.cos.<Region>.myqcloud.com
Date: <GMT Date>
Authorization: <Auth String>

2. 上传时处理

PUT /<ObjectKey> HTTP/1.1
Host: <BucketName-APPID>.cos.<Region>.myqcloud.com
Date: GMT Date
Authorization: Auth String
Pic-Operations:
{
"is_pic_info": 1,
"rules": [{
"fileid": "exampleobject",
"rule": "imageMogr2/format/webp"
}]
}
说明
Pic-Operations 为 json 格式的字符串,具体参数信息可参考 图片持久化处理

3. 云上数据处理

POST /<ObjectKey>?image_process HTTP/1.1
Host: <BucketName-APPID>.cos.<Region>.myqcloud.com
Date: GMT Date
Content-length: Size
Authorization: Auth String
Pic-Operations:
{
"is_pic_info": 1,
"rules": [{
"fileid": "exampleobject",
"rule": "imageMogr2/format/webp"
}]
}
说明
Authorization: Auth String,详情请参见 请求签名 文档。

处理参数说明

参数
含义
ObjectKey
对象文件名,例如 folder/sample.jpg。
/format/<Format>
压缩格式,此处为 webp。

实际案例

说明
本篇文档中的实际案例仅包含下载时处理,该类处理不会保存处理后的图片至存储桶。如有保存需求,请使用上传时处理云上数据处理方式。
假设原图格式为 png,图片大小为1335.2KB,如下图所示:
img


将原图转换为 webp 格式,请求 URL 如下:
http://example-1258125638.cos.ap-shanghai.myqcloud.com/sample.png?imageMogr2/format/webp
效果如下:
img


压缩率对比
格式
图片大小
png(原图)
1335.2KB
webp
65KB(压缩率95.13%)