You need to enable JavaScript to run this app.
导航
图片处理概述
最近更新时间:2024.04.26 11:58:13首次发布时间: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-algorithmx-tos-server-side-encryption-customer-keyx-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 的详细介绍,请参见以下文档:

图片处理功能

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 文件。

去除图片元信息

strip

去除图片的 EXIF、gAMA、iCCP 等信息。