对象存储 TPG 压缩-API 文档-文档中心-腾讯云

功能描述
图片压缩指在图片质量保持不变的情况，尽可能的减小图片大小，以达到节省图片存储空间、减少图片访问流量、提升图片访问速度的效果。
对象存储（Cloud Object Storage，COS）基于 数据万象（Cloud Infinite，CI）产品推出了 TPG 压缩功能，可将图片转换为 tpg 格式，它是腾讯推出的自研图片格式，能支持动图，目前 QQ 浏览器、QQ 空间等产品已默认支持 tpg 图片，在图片质量相同的情况下，图片大小比 gif 格式图片减少90%以上，比 png 图片小50%以上。
授权说明
下载时处理：授权策略中 action 设置为 cos:GetObject、ci:SetImageAdvancedCompression。
上传时处理：授权策略中 action 设置为 cos:PutObject、ci:SetImageAdvancedCompression。
云上数据处理：授权策略中 action 设置为 cos:GetObject、cos:PutObject、ci:SetImageAdvancedCompression（注意 GetObject 对应的 resource 为源文件，PutObject 对应的 resource 为转存的文件）。
 查看所有 action。
服务开通
使用该功能需提前开通数据万象，并绑定存储桶。详情请参见 绑定存储桶。
使用 TPG 压缩，需要先开通存储桶的图片高级压缩功能，您需要在相应的存储桶配置页中通过开关按钮开启功能，详情请参见 图片高级压缩。
使用限制
使用该接口时，请先确认相关限制条件。详情请参见 使用限制。
支持格式：支持将 jpg、png、bmp、gif、webp、heif、avif 等格式图片转换为 tpg 格式。
体积限制：处理图片原图大小不超过32MB、宽高不超过30000像素且总像素不超过2.5亿像素，处理结果图宽高设置不超过9999像素；针对动图，原图宽 x 高 x 帧数不超过2.5亿像素。
动图帧数限制：gif 帧数限300帧。
前提条件
使用 TPG 压缩，需要先开通存储桶的图片高级压缩功能，您需要在相应的存储桶配置页中通过开关按钮开启功能，详情请参见 设置图片高级压缩。
TPG 是腾讯自研的图片格式，使用前请确认图片加载环境已支持 TPG 解码，腾讯云数据万象提供集成 TPG 解码器的 iOS、Android 终端 SDK，可帮助您快速接入和使用 TPG。
使用方式
COS 通过数据万象 imageMogr2 接口提供 tpg 压缩功能。
该功能支持以下的处理方式：
下载时处理
上传时处理
云上数据处理
说明
 TPG 压缩为付费服务，计费项为图片高级压缩费用，由数据万象收取，具体费用请参见数据万象 图片处理费用。
接口示例
1. 下载时处理
GET /<ObjectKey>?imageMogr2/format/tpg 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/tpg"
}]
}
说明
 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/tpg"
}]
}
说明
Authorization: Auth String（详情请参见 请求签名 文档）。
通过子账号使用时，需要授予相关的权限，详情请参见 授权粒度详情 文档。
处理参数说明
参数
含义
download_url
文件的访问链接，具体构成为<BucketName-APPID>.cos.<Region>.myqcloud.com/<picture name>， 例如examplebucket-1250000000.cos.ap-shanghai.myqcloud.com/picture.jpeg。
/format/<Format>
压缩格式，此处为 tpg。
实际案例
说明
 本篇文档中的实际案例仅包含下载时处理，该类处理不会保存处理后的图片至存储桶。如有保存需求，请使用上传时处理或云上数据处理方式。
假设原图格式为 png，图片大小为1335.2KB，如下图所示：
﻿
﻿
将原图转换为 tpg 格式，请求 URL 如下：
http://example-1258125638.cos.ap-shanghai.myqcloud.com/sample.png?imageMogr2/format/tpg
压缩率对比
格式
图片大小
png（原图）
1335.2KB
tpg
36.67KB（压缩率97.3%）

参数	含义
download_url	文件的访问链接，具体构成为<BucketName-APPID>.cos.<Region>.myqcloud.com/<picture name>，例如`examplebucket-1250000000.cos.ap-shanghai.myqcloud.com/picture.jpeg`。
/format/<Format>	压缩格式，此处为 tpg。

格式	图片大小
png（原图）	1335.2KB
tpg	36.67KB（压缩率97.3%）

TPG 压缩

本页目录：

功能描述

授权说明

服务开通

使用限制

前提条件

使用方式

接口示例

1. 下载时处理

2. 上传时处理

3. 云上数据处理

处理参数说明

实际案例