tencent cloud

Overview

COS uses the imageMogr2 API of Cloud Infinite (CI) to perform Image Advanced Compression, which allows you to easily convert images into formats that provide a high compression ratio, such as TPG and HEIF. This effectively reduces the transmission time, loading time, and the use of bandwidth and traffic.

An image can be processed:

• Upon download
• Upon upload
• In cloud

Note：

• To use Image Advanced Compression, enable this feature on the desired bucket’s configuration page. For more information, please see Setting Advanced Compression.
• To use the TPG format, ensure that the environment where images are loaded supports TPG decoding. Tencent Cloud CI provides the TPG decoder−integrated SDKs for iOS, Android, and Windows clients to facilitate quick integration with TPG.
• Currently, iOS 11 or later and Android P have native support for the HEIF format.
• Image Advanced Compression is charged by CI. For detailed pricing, please see Billing and Pricing.

API Format

1. Processing upon download

download_url?imageMogr2/format/<Format>

2. Processing upon upload

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/<Format>"
}]
}

3. Processing in-cloud data

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/<Format>"
}]
}

Note：

Processing upon download is used as an example here, which does not store the output image in a bucket. If you need to store the output image, please see Persistent Image Processing and use Processing upon upload or Processing in-cloud data.

Parameters

Examples

Assume that the input image is a 1,335.2 KB image in PNG format, as shown below:

You can convert the image into TPG format using the following URL:

http://example-1258125638.cos.ap-shanghai.myqcloud.com/sample.png?imageMogr2/format/tpg

Alternatively, you can convert the image into HEIF format using the following URL:

http://example-1258125638.cos.ap-shanghai.myqcloud.com/sample.png?imageMogr2/format/heif

Compression ratio comparison