图片处理机制介绍

简介

对象存储提供了一套便捷的图片处理机制，通过这套机制可以对存储桶中的图片进行一系列的图片处理操作。

图片处理机制分为以下三种方式：

下载时处理

您可以通过在图片的 URL 后加上 图片处理参数，实现访问图片的时候同步获取到处理后的图片。

请求语法

GET /<ObjectKey>?<图片处理参数> HTTP/1.1
Host: <BucketName-APPID>.cos.<Region>.myqcloud.com
Date: <GMT Date>
Authorization: <Auth String>

示例

请求

GET /filename.jpg?imageMogr2/format/png HTTP/1.1
Host: examplebucket-1250000000.cos.ap-chengdu.myqcloud.com
Date: Wed, 28 Oct 2015 20:32:00 GMT
Authorization:XXXXXXXXXXXX

返回

HTTP/1.1 200 OK
Content-Type: image/png
Content-Length: 565
Date: Fri, 10 Apr 2020 09:35:16 GMT
Last-Modified: Fri, 10 Apr 2020 09:35:05 GMT
x-cos-request-id: NWFjMzQ0MDZfOTBmYTUwXzZkZV8z****

上传时处理

上传时处理功能可以帮助使用者在上传时实现图片处理。您只需要在请求包头部中加入 Pic-Operations 项并设置好相应的 图片处理参数，就可在图片上传时实现相应的图片处理，并可将原图和处理结果存入到 COS。目前支持32M以内的图片处理。

请求语法

图片上传的请求包与 COS V5 简单上传文件接口一致，只在请求包头部增加图片处理参数。

PUT /<ObjectKey> HTTP/1.1
Host: <BucketName-APPID>.cos.<Region>.myqcloud.com
Date: GMT Date
Authorization: Auth String
Pic-Operations: <PicOperations>

说明：

• COS 简单上传文件接口，请参见 COS PUT Object 文档。
• Authorization: Auth String（详情请参见 请求签名 文档）。
• 持久化处理的 QPS 限制为100，如您有更高需求请 联系我们。

请求内容

Pic-Operations 为 json 格式的字符串，具体参数如下：

rules（json 数组）中每一项具体参数如下：

返回内容

响应包体具体数据内容如下：

UploadResult 节点内容：

OriginalInfo 节点内容：

ImageInfo 节点内容：

ProcessResults 节点内容：

Object 节点内容：

示例

请求

PUT /filename.jpg HTTP/1.1
Host: examplebucket-1250000000.cos.ap-chengdu.myqcloud.com
Date: Wed, 28 Oct 2015 20:32:00 GMT
Authorization:XXXXXXXXXXXX
Pic-Operations: {"is_pic_info":1,"rules":[{"fileid":"test.png","rule":"imageMogr2/format/png"}]}
Content-Length: 64

[Object]

返回

HTTP/1.1 200 OK
Content-Type: application/xml
Content-Length: 645
Date: Tue, 03 Apr 2018 09:06:16 GMT
Status: 200 OK
x-cos-request-id: NWFjMzQ0MDZfOTBmYTUwXzZkZV8z****

<UploadResult>
        <OriginalInfo>
            <Key>filename.jpg</Key>
            <Location>examplebucket-1250000000.cos.ap-chengdu.myqcloud.com/filename.jpg</Location>
            <ETag>&quot;580cd6930444576523c25f86ce2af9b1fc2d5484&quot;</ETag>
            <ImageInfo>
                <Format>JPEG</Format>
                <Width>640</Width>
                <Height>427</Height>
                <Quality>100</Quality>
                <Ave>0xa18454</Ave>
                <Orientation>1</Orientation>
                <FrameCount>1</FrameCount>
            </ImageInfo>
        </OriginalInfo>
        <ProcessResults>
            <Object>
                <Key>test.png</Key>
                <Location>examplebucket-1250000000.cos.ap-chengdu.myqcloud.com/test.png</Location>
                <Format>png</Format>
                <Width>640</Width>
                <Height>427</Height>
                <Size>463092</Size>
                <Quality>100</Quality>
                <ETag>&quot;eaa4e3d8fd498bbc63be3b71c46b9c61f23e3f0c&quot;</ETag>
                <FrameCount>1</FrameCount>
            </Object>
        </ProcessResults>
</UploadResult>

注意：

上传时处理支持 COS V5 的分块上传功能，您在使用 COS V5 的 Complete Multipart Upload 接口时只需在请求包头部中加入 Pic-Operations 项，即可实现图片处理。

POST /<ObjectKey>?uploadId=UploadId HTTP/1.1
Host: <BucketName-APPID>.cos.<Region>.myqcloud.com
Date: GMT Date
Content-length: Size
Authorization: Auth String
Pic-Operations: <PicOperations>

说明：

COS 接口请参见 COS Complete Multipart Upload 文档。

云上数据处理

对象存储的图片处理 API 能够对已存储在 COS 的图片进行相应处理操作，并将结果存入到 COS。

请求语法

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: <PicOperations>

请求内容

Pic-Operations 为 json 格式的字符串，具体参数如下：

rules（json 数组）中每一项具体参数如下：

|
| rule | String | 是 | 处理参数，参见对象存储图片处理 API。若按指定样式处理，则以 style/ 开头，后加样式名，如样式名为 test，则 rule 字段为 style/test |

返回内容

响应包体具体数据内容如下：

UploadResult 节点内容：

OriginalInfo 节点内容：

ImageInfo 节点内容：

ProcessResults 节点内容：

Object 节点内容：

示例

请求

POST /filename.jpg?image_process HTTP/1.1
Host: examplebucket-1250000000.cos.ap-chengdu.myqcloud.com
Date: Wed，18 Jan 2017 16:17:03 GMT
Authorization: XXXXXXXXXX
Pic-Operations: {"is_pic_info":1,"rules":[{"fileid":"test.png","rule":"imageMogr2/format/png"}]}
Content-Length: XX

返回

HTTP/1.1 200 OK
Content-Type: application/xml
Content-Length: 645
Date: Tue, 03 Apr 2018 09:06:16 GMT
Status: 200 OK
x-cos-request-id: NWFjMzQ0MDZfOTBmYTUwXzZkZV8z****

<UploadResult>
            <OriginalInfo>
                <Key>filename.jpg</Key>
                <Location>examplebucket-1250000000.cos.ap-chengdu.myqcloud.com/filename.jpg</Location>
                <ETag>&quot;eaa4e3d8fd498bbc63be3b71c46b9c61f23e3f0c&quot;</ETag>
                <ImageInfo>
                    <Format>JPEG</Format>
                    <Width>640</Width>
                    <Height>427</Height>
                    <Quality>100</Quality>
                    <Ave>0xa18454</Ave>
                    <Orientation>1</Orientation>
                    <FrameCount>1</FrameCount>
                </ImageInfo>
            </OriginalInfo>
            <ProcessResults>
                <Object>
                    <Key>test.png</Key>
                    <Location>examplebucket-1250000000.cos.ap-chengdu.myqcloud.com/test.png</Location>
                    <Format>png</Format>
                    <Width>640</Width>
                    <Height>427</Height>
                    <Size>463092</Size>
                    <Quality>100</Quality>
                    <ETag>&quot;eaa4e3d8fd498bbc63be3b71c46b9c61f23e3f0c&quot;</ETag>
                    <FrameCount>1</FrameCount>
                </Object>
            </ProcessResults>
</UploadResult>