文档中心

对象存储

请输入

用户指南

图片处理体验中心

TOS 控制台集成了图片裁剪、图片水印等功能，实现图片处理配置的可视化，便于您快速体验图片处理功能。本文介绍在 TOS 控制台使用图片裁剪、图片水印等功能的使用限制、操作步骤。

功能介绍

此前，TOS 仅支持通过 GetObject 接口，在请求中携带图片处理的相关参数来实现图片裁剪、图片水印等操作，详细介绍，请参见图片处理概述。

为了提升使用体验，TOS 控制台现已集成图片裁剪等功能，通过图形化界面实现图片处理配置的可视化管理。您可以在 TOS 控制台对存储的图片文件进行图片调整图片亮度等操作，处理完成后，您可以直接下载处理后的图片文件，也可以将处理后的图片存储到指定存储桶。

TOS 控制台支持的图片处理操作如下：

分类	图片处理操作
裁剪	自定义裁剪
		内切圆
		圆角矩形
效果	图片亮度
		图片对比度
		图片旋转
		图片锐化
		图片模糊
水印	图片水印
水印		文字水印

使用限制

类别	使用限制
格式	仅支持对 jpg/jpeg、png、bmp、gif、webp 和 tiff 格式的原图执行图片处理操作。
大小	原图大小不能超过 20MB。原图宽、高不能超过 30000 px，总像素不能超过 2.5 亿 px（旋转操作的原图宽、高不能超过 4096 px）。
QPS	图片处理操作在每个地域的每秒请求数 QPS 的上限为 50。说明如果您有计算量较大的场景或使用时超过该限制，请提交工单联系技术支持或客户经理评估。
并发数	图片处理并发数默认限制如下：华北2（北京）：20 其他地域：10 说明如果您有计算量较大的场景或使用时超过该限制，请提交工单联系技术支持或客户经理评估。
服务端加密	支持对使用 SSE-TOS、SSE-C、SSE-KMS 加密的图片进行处理，使用限制如下： SSE-C 加密对使用 SSE-C 加密的图片进行处理时，必须携带 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 加密的图片作为水印添加到图片上。例如对 aaa 、bbb 图片进行 SSE-C 加密，ccc 图片没有进行 SSE-C 加密，支持将 ccc 图片作为水印添加到 bbb 图片，不支持将 aaa 图片作为水印添加到 bbb 图片。 SSE-KMS 加密不支持匿名处理经过 SSE-KMS 加密的图片，您必须开通 KMS 服务，具备访问主密钥的权限，才能使用有效签名处理经过 SSE-KMS 加密的图片。

图片裁剪

登录对象存储控制台。

在左侧导航栏，选择多媒体体验中心 > 图片处理。

在图片处理体验中心页面顶部导航栏，选择存储图片的存储桶。

在图片上传区域，单击选择图片。

在选择文件对话框，选中图片，单击确定。

在左侧操作栏，单击裁剪，选择裁剪方式，配置对应参数。

标准裁剪

标准裁剪需要指定原图上的任意一点作为起始坐标，根据指定的宽高裁剪出区域。

参数	说明
裁剪起始位置	裁剪的起始坐标原点。
起点横坐标	裁剪起始点横坐标偏移（相对于指定的坐标原点）。说明横坐标向右偏移为正，向左偏移为负。
起点纵坐标	裁剪起始点纵坐标偏移（相对于指定的坐标原点）。说明纵坐标向下偏移为正，向上偏移为负。
宽	裁剪宽度，单位为 px。
高	裁剪高度，单位为 px。
裁剪形状	将图片裁剪成矩形、圆角矩形或圆形，说明如下：矩形：按照上文设置的宽度、高度将图片裁剪为矩形。圆角矩形：指定圆角大小，将图片裁剪为圆角矩形。圆形：指定半径大小，将以图片的中心为圆心，根据指定的半径将图片裁剪为圆形。

自由裁剪

自由裁剪需要先指定裁剪比例，系统将在图片上按比例生成一个可调整区域，您可以自由拖动并缩放该区域，TOS 将根据选定的范围裁剪图片。

参数	说明
选择裁剪比例	按比例生成一个可调整区域，您可以自由拖动并缩放区域，TOS 将根据选定的范围裁剪图片。操作如下：单击开始裁剪，选择裁剪比例，然后拖动调整裁剪区域。选定范围后，单击确认裁剪。说明仅支持裁剪原图。
裁剪形状	将图片裁剪成矩形、圆角矩形或圆形，说明如下：矩形：按照上文选定的范围将图片裁剪为矩形。圆角矩形：指定圆角大小，将图片裁剪为圆角矩形。圆形：指定半径大小，将以图片的中心为圆心，根据指定的半径将图片裁剪为圆形。

参数设置完成后，TOS 会自动按照配置裁剪图片。您可以在图片上传区域查看裁剪后的图片。

说明

在图片处理体验中心页面顶部导航栏，长按对比图标可查看处理前的图片，松开后恢复显示处理后的图片，单击重置图标可将图片恢复至原始状态。

导出处理后图片。

下载处理后图片

在图片处理体验中心页面右上角，单击下载，可将处理后图片下载至本地。

分享处理后图片

在图片处理体验中心页面右上角，单击复制链接，将该预签名链接分享给其他用户，其他用户可通过该链接访问处理后图片。

将处理后图片保存至指定存储桶

在图片处理体验中心页面底部，单击复制按钮，获取图片裁剪参数，将图片裁剪参数拼接到图片 URL 中，然后添加持久化参数，将处理后的图片保存至指定的存储桶。详细介绍，请参见图片处理持久化。

图片效果

登录对象存储控制台。

在左侧导航栏，选择多媒体体验中心 > 图片处理。

在图片处理体验中心页面顶部导航栏，选择存储图片的存储桶。

在图片上传区域，单击选择图片。

在选择文件对话框，选中图片，单击确定。

在左侧操作栏效果区域，配置对应参数。

参数	说明
亮度	调整图片的亮度，取值范围为 [-100，100]，说明如下：取值＜0：降低图片亮度。取值 =0：不调整图片亮度。取值＞0：提高图片亮度。
对比度	调整图片的对比度，取值范围为 [-100，100]，说明如下：取值＜0：降低图片对比度。取值=0：维持原图对比度。取值＞0：提高图片对比度。
旋转	按顺时针方向旋转图片，您需要设置图片顺时针旋转的角度。注意若图片旋转的角度不是 90°、180°、270°、360° 时，会导致处理后的图片尺寸变大。旋转功能对图片的尺寸有限制，图片的宽或者高不能超过 4096 px。
锐化	调整图片的锐化效果，取值范围为 [50,399]。取值越大，图片越清晰，但过大的值可能会导致图片失真。为达到较优效果，推荐取值为 100。
模糊	为图片增加模糊效果，说明如下：模糊半径：取值范围为 [1,50]，取值越大，图片越模糊。模糊标准差：取值范围为 [1,50]，取值越大，图片越模糊。

参数设置完成后，TOS 会自动按照配置处理图片。您可以在图片上传区域查看处理后的图片。

说明

在图片处理体验中心页面顶部导航栏，长按对比图标可查看处理前的图片，松开后恢复显示处理后的图片，单击重置图标可将图片恢复至原始状态。

导出处理后图片。

下载处理后图片

在图片处理体验中心页面右上角，单击下载，可将处理后图片下载至本地。

分享处理后图片

在图片处理体验中心页面右上角，单击复制链接，将该预签名链接分享给其他用户，其他用户可通过该链接访问处理后图片。

将处理后图片保存至指定存储桶

在图片处理体验中心页面底部，单击复制按钮，获取图片处理参数，将图片处理参数拼接到图片 URL 中，然后添加持久化参数，将处理后的图片保存至指定的存储桶。详细介绍，请参见图片处理持久化。

图片水印

登录对象存储控制台。

在左侧导航栏，选择多媒体体验中心 > 图片处理。

在图片处理体验中心页面顶部导航栏，选择存储图片的存储桶。

在图片上传区域，单击选择图片。

在选择文件对话框，选中图片，单击确定。

在左侧操作栏，单击水印，选择水印方式，然后配置对应参数。

图片水印

参数	说明
水印图片	选择水印图片。说明水印图片必须与原图位于同一存储桶。
缩放比例	对水印图片进行百分比缩放。
水印位置	选择水印在图片中的放置位置，设置水印的垂直边距、水平边距。垂直边距：距离图片边缘的垂直距离，这个参数只有当水印位置是左上、中上、右上、左下、中下、右下才有意义。水平边距：距离图片边缘的水平距离。这个参数只有当水印位置是左上、左中、左下、右上、右中、右下才有意义。
不透明度	水印图片的不透明程度，取值越大，不透明度越高。

文字水印

参数	说明
文字内容	文字水印内容。说明文字水印功能暂时不支持繁体中文。
文字字体	文字水印的字体。
文字字号	文字水印的字体大小。
文字旋转	文字水印按顺时针方向旋转的角度。
文字颜色	文字水印的字体颜色。十六进制颜色码，取值为 000000 到 FFFFFF。
文字铺满	是否将水印文字铺满原图。
文字阴影	文字水印的阴影。说明文字旋转后，文字阴影功能无法生效。
水印位置	选择水印在图片中的放置位置，设置水印的垂直边距、水平边距。垂直边距：距离图片边缘的垂直距离，这个参数只有当水印位置是左上、中上、右上、左下、中下、右下才有意义。水平边距：距离图片边缘的水平距离。这个参数只有当水印位置是左上、左中、左下、右上、右中、右下才有意义。
不透明度	水印文字的不透明程度，取值越大，不透明度越高。

参数设置完成后，TOS 会自动按照配置处理图片。您可以在图片上传区域查看处理后的图片。

说明

在图片处理体验中心页面顶部导航栏，长按对比图标可查看处理前的图片，松开后恢复显示处理后的图片，单击重置图标可将图片恢复至原始状态。

导出处理后图片。

下载处理后图片

在图片处理体验中心页面右上角，单击下载，可将处理后图片下载至本地。

分享处理后图片

在图片处理体验中心页面右上角，单击复制链接，将该预签名链接分享给其他用户，其他用户可通过该链接访问处理后图片。

将处理后图片保存至指定存储桶

在图片处理体验中心页面底部，单击复制按钮，获取图片处理参数，将图片处理参数拼接到图片 URL 中，然后添加持久化参数，将处理后的图片保存至指定的存储桶。详细介绍，请参见图片处理持久化。

最近更新时间：2026.07.16 18:55:13

这个页面对您有帮助吗？

有用

无用