文档中心

对象存储OSS API参考手册

最近更新时间：2023-04-16 17:00:00

7 图片处理接口描述

图片处理是对象存储服务为用户提供高效、安全、易用、低成本的图片处理服务，包括图片缩放、图片剪切、图片水印、格式转换、图片压缩等。您可以在 GetObject 请求中携带图片处理参数对图片文件进行处理，并且可以快速获取到处理后的图片

7.1 图片处理接口说明

1. 操作说明

您可以通过在 GetObject 请求中添加图片处理参数或图片样式参数的方式来下载到处理后的图片。

2. 请求消息样式

GET /bucketname/example.jpg?x-oss-process=value

HTTP/1.1 Host: CecCloud.com

Date: date

Authorization: authorization

表7-1 请求消息参数列表

3. 请求示例

编码模式示例

GET /bucketname/example.jpg?x-oss-process=image/resize,p_50/format,png

HTTP/1.1 Accept-Encoding: gzip,deflate

Authorization: AWS 04RZT432N80TGDF2Y2G2:pkRtbbpzetVSUoTralXIkRLWsCQ=

Date: Mon, 27 Sep 2018 01:51:25 GMT

Host: CecCloud.com

样例模式示例

GET /bucketname/example.jpg?x-oss-process=style/mystyle

HTTP/1.1 Accept-Encoding: gzip,deflate

Authorization: AWS 04RZT432N80TGDF2Y2G2:pkRtbbpzetVSUoTralXIkRLWsCQ=

Date: Mon, 27 Sep 2018 01:51:25 GMT

Host: CecCloud.com

7.2 图片处理参数

7.2.1 图片缩放

通过 resize 操作能够使图片按照一定规则进行缩放，支持按照指定宽高和比例进行缩放。

1. 操作说明

操作名称：resize

resize ,<p|h|w|w,h >,[limit]

表7-2 图片缩放参数列表

2. 请求示例

GET /bucketname/example.jpg?x-oss-process=image/resize,p_50

HTTP/1.1 Accept-Encoding: gzip,deflate

Authorization: AWS 04RZT432N80TGDF2Y2G2:pkRtbbpzetVSUoTralXIkRLWsCQ=

Date: Mon, 27 Sep 2018 01:51:25 GMT

Host: CecCloud.com

3. 响应示例

HTTP/1.1 200 OK

x-amz-request-id: 5FBCAEB7BB9A1AD0FF1285552415340

Content-Type: application/octet-stream; charset=UTF-8

Date: Mon, 27 Sep 2018 01:53:35 GMT

Content-Length: 560

[560 bytes of object data]

7.2.2 格式转换

通过 formate 操作能够将原图转换为支持的图片格式，支持按照指定宽高和比例进行缩放。格式当前支持六种格式，包括 jpg、 png、webp、bmp、gif、tiff。

1. 操作说明

操作名称：format

format ,<格式>

2. 请求示例

GET /bucketname/example.jpg?x-oss-process=image/format,png

HTTP/1.1 Accept-Encoding: gzip,deflate

Authorization: AWS 04RZT432N80TGDF2Y2G2:pkRtbbpzetVSUoTralXIkRLWsCQ=

Date: Mon, 27 Sep 2018 01:51:25 GMT

Host: CecCloud.com

3. 响应示例

HTTP/1.1 200 OK

x-amz-request-id: 5FBCAEB7BB9A1AD0FF1285552415340

Content-Type: application/octet-stream; charset=UTF-8

Date: Mon, 27 Sep 2018 01:53:35 GMT

Content-Length: 560

[560 bytes of object data]

7.2.3 文字水印

通过 watermark 操作能够将原图添加文字水印时使用的参数，包括字体大小、字体类型以及文字颜色等。

1. 操作说明

操作名称：watermark

watermark ,<txt_xxx>,[其他可选参数]：

表7-3 文字水印参数列表

图7-1 区域数值对应图

2. 请求示例

GET

/bucketname/example.jpg?x-ossprocess=image/watermark,text_dGVzdA==,rotate_0,g_nw

HTTP/1.1 Accept-Encoding: gzip,deflate

Authorization: AWS 04RZT432N80TGDF2Y2G2:pkRtbbpzetVSUoTralXIkRLWsCQ=

Date: Mon, 27 Sep 2018 01:51:25 GMT

Host: CecCloud.com

3. 响应示例

HTTP/1.1 200 OK

x-amz-request-id: 5FBCAEB7BB9A1AD0FF1285552415340

Content-Type: application/octet-stream; charset=UTF-8

Date: Mon, 27 Sep 2018 01:53:35 GMT

Content-Length: 560

[560 bytes of object data]

7.2.4 图片压缩

通过 quality 操作能够将原图进行压缩，不使用压缩则可能会使图片占用的空间变大。

1. 操作说明

操作名称：quality

quality，<q_xx>

表7-4 图片压缩参数列表

2. 请求示例

GET

/bucketname/example.jpg?x-oss-process=image/quality,q_50

HTTP/1.1 Accept-Encoding: gzip,deflate

Authorization: AWS 04RZT432N80TGDF2Y2G2:pkRtbbpzetVSUoTralXIkRLWsCQ=

Date: Mon, 27 Sep 2018 01:51:25 GMT

Host: CecCloud.com

3. 响应示例

HTTP/1.1 200 OK

x-amz-request-id: 5FBCAEB7BB9A1AD0FF1285552415340

Content-Type: application/octet-stream; charset=UTF-8

Date: Mon, 27 Sep 2018 01:53:35 GMT

Content-Length: 560

[560 bytes of object data]

意见反馈

文档内容是否对您有帮助？

如您有其他疑问，您也可以通过在线客服来与我们联系探讨在线客服