文档中心

图片处理概述

最近更新时间：2024.03.20 19:30:02

首次发布时间：2022.11.18 17:58:40

TOS 支持处理存储的图片文件，您可以通过 GetObject 接口，在请求中携带图片处理的相关参数。TOS 支持的图片处理功能包括图片缩放、图片裁剪、图片水印、格式转换等。

说明

使用图片处理服务时，会产生图片处理费用、请求费用和流量费用。详细计费介绍，请参见数据处理费用、请求次数费用和流量费用。

使用限制

类别	使用限制
格式	原图格式仅支持 JPG、PNG、BMP、GIF、WEBP 和 TIFF。
大小	原图大小不能超过 20MB。原图宽、高不能超过 30000 px，总像素不能超过 2.5 亿 px（旋转操作的原图宽、高不能超过 4096 px）。缩放后的图片宽、高不能超过 16384 px，总像素不能超过 16777216 px。
QPS	图片处理和视频处理每秒请求数 QPS 限制如下：北京地域：20 其他地域：10 说明如果您有计算量较大的场景或使用时超过该限制，请提交工单联系技术支持或客户经理评估。
服务端加密	支持对使用 SSE-TOS、SSE-C、SSE-KMS 加密的图片进行处理，使用限制如下： SSE-C 加密对使用 SSE-C 加密的图片进行处理时，必须携带 SSE-C 的 `x-tos-server-side-encryption-customer-algorithm`、`x-tos-server-side-encryption-customer-key`、`x-tos-server-side-encryption-customer-key-MD5` 头域，关于 SSE-C 头域的详细介绍，请参见使用用户提供密钥的服务端加密（SSE-C）。支持为经过 SSE-C 加密的图片添加图片水印，但是不支持将经过 SSE-C 加密的图片作为水印添加到图片上。例如对 aaa 、bbb 图片进行 SSE-C 加密，ccc 图片没有进行 SSE-C 加密，支持将 ccc 图片作为水印添加到 bbb 图片，不支持将 aaa 图片作为水印添加到 bbb 图片。 SSE-KMS 加密不支持匿名处理经过 SSE-KMS 加密的图片，您必须开通 KMS 服务，具备访问主密钥的权限，才能使用有效签名处理经过 SSE-KMS 加密的图片。您可以使用预签名、API 或 SDK 处理经过 SSE-KMS 加密的图片，关于图片处理的 API 和 SDK 详细介绍，请参见下文的使用 REST API 和基础图片处理（Java SDK）。将图片转存至指定的存储桶时，将默认继承存储桶的服务端加密方式，如果转存的存储桶默认加密方式为 SSE-KMS 加密，请确保当前账号拥有对应存储桶 KMS 密钥的权限，否则图片转存会失败。

图片处理方式

图片处理特性目前提供 REST API、文件 URL 两种使用方式，您可以随时对存储在TOS对象存储桶中的图片进行简单的缩放、裁剪、添加水印等操作，并快速获取处理后的图片。

说明

处理后的图片会即时返回，不会保存到您的存储桶中。

使用 REST API
请求示例如下：

GET /example.jpg?x-tos-process=image/resize,w_300 HTTP/1.1
Host: endpoint
X-Tos-Content-Sha256: sha256
X-Tos-Date: 20220827T132948Z
Authorization: authorization

使用文件 URL
示例 URL 如下：
```
http://bucket.endpoint/example.jpg?x-tos-process=image/resize,w_300
```
说明
对于私有图片，您需要使用 SDK 生成带图片处理参数的预签名 URL，再执行图片处理操作。关于各语言的预签名 URL 的详细介绍，请参见以下文档：
- 生成用于执行图片处理的预签名 URL 示例
- 生成图片转码/视频截帧的预签名 URL

图片处理功能

TOS 图片处理支持以下功能，当您在请求中指定多个参数时，TOS 将按照参数顺序依次对图片进行处理。

说明

图片像素相关的参数，如无特殊说明，均只支持正整数，取值范围请参见各参数说明。

图片处理功能	参数	说明
图片缩放	resize	将图片缩放至指定大小。
图片水印	watermark	为图片添加图片或文字水印。
自定义裁剪	crop	裁剪指定大小的矩形图片。
质量变换	quality	调整 JPG 和 WebP 格式图片的质量。
格式转换	format	转换图片格式。
获取信息	info	获取图片信息，包括基本信息、EXIF 信息。
自适应方向	auto-orient	将携带旋转参数的图片进行自适应旋转。
内切圆	circle	以图片中心点为圆心，裁剪出指定大小的圆形图片。
索引切割	indexcrop	按指定x或y轴的大小切分图片，之后选取其中一张图片。
圆角矩形	rounded-corners	按指定圆角大小将图片裁剪成圆角矩形。
模糊效果	blur	对图片进行模糊处理。
旋转	rotate	按指定角度以顺时针方向旋转图片。
渐进显示	interlace	将 JPG 格式的图片调整为渐进显示。
获取图片主色调	average-hue	获取图片主色调。
亮度	bright	调整图片亮度。
锐化	sharpen	对图片进行锐化处理。
对比度	contrast	调整图片对比度。
图片处理持久化	save	将处理后的图片保存至指定的存储桶。
异常图片检测	inspect	检测图片中是否包含除图片以外的可疑文件，例如 MPEG-TS 文件。

使用限制

图片处理方式

图片处理功能