文档中心

对象存储

请输入

图片处理

图片处理概述

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

计费说明

使用图片处理功能时，会产生图片处理费用、请求费用和流量费用，计费详情，请参见数据处理费用、请求次数费用和流量费用。

对低频存储、归档闪回存储类型的图片使用图片处理功能时，会产生数据取回费用，按照处理前图片大小进行收费，计费详情，请参见数据取回费用。

使用限制

类别	使用限制
格式	仅支持对 jpg/jpeg、png、bmp、gif、webp 和 tiff 格式的原图执行图片处理操作。说明部分图片处理操作支持的原图格式存在特殊情况，会在对应的单篇文档中予以额外说明。
大小	原图大小不能超过 20MB。原图宽、高不能超过 30000 px，总像素不能超过 2.5 亿 px（旋转操作的原图宽、高不能超过 4096 px）。 webp 格式原图宽、高限制为 16383 px，超过后只能下载原图，不能图片处理。缩放后的图片宽、高不能超过 16384 px，总像素不能超过 16777216 px。
QPS	图片处理操作在每个地域的每秒请求数 QPS 的上限为 50。说明如果您有计算量较大的场景或使用时超过该限制，请提交工单联系技术支持或客户经理评估。
并发数	图片处理并发数默认限制如下：华北2（北京）：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/jpeg 和 webp 格式图片的质量。
格式转换	format	转换图片格式。
获取信息	info	获取图片信息，包括基本信息、EXIF 信息。
自适应方向	auto-orient	将携带旋转参数的图片进行自适应旋转。
内切圆	circle	以图片中心点为圆心，裁剪出指定大小的圆形图片。
索引切割	indexcrop	按指定x或y轴的大小切分图片，之后选取其中一张图片。
圆角矩形	rounded-corners	按指定圆角大小将图片裁剪成圆角矩形。
模糊效果	blur	对图片进行模糊处理。
旋转	rotate	按指定角度以顺时针方向旋转图片。
渐进显示	interlace	将 jpg/jpeg 格式的图片调整为渐进显示。
获取图片主色调	average-hue	获取图片主色调。
亮度	bright	调整图片亮度。
锐化	sharpen	对图片进行锐化处理。
对比度	contrast	调整图片对比度。
图片高级压缩	format	将图片转换为 HEIF 高压缩比格式。
图片处理持久化	save	将处理后的图片保存至指定的存储桶。
异常图片检测	inspect	检测图片中是否包含除图片以外的可疑文件，例如 MPEG-TS 文件。
去除图片元信息	strip	去除图片的 EXIF、gAMA、iCCP 等信息。

最近更新时间：2026.02.03 17:53:48

这个页面对您有帮助吗？

有用

无用