Docs

Torch Object Storage

User Guide

Image Processing Experience Center

You can now process images directly in the TOS console. This feature includes options for cropping and adding watermarks, allowing you to quickly and easily configure your image processing settings. This topic describes the constraints, limitations, and steps for processing images directly in the console.

Introduction

Previously, TOS only supported image processing by including relevant parameters in requests via the GetObject API. For more information, see Image processing overview.

To improve the user experience, the TOS console now offers a graphical interface for managing image processing configurations visually, including image cropping. You can adjust the brightness of stored image files and perform other operations directly in the console. After processing, you can either download the files immediately or save them to a specified bucket.

The following image processing operations are supported by the TOS console:

Category	Operations
Crop	Crop
		Circle
		Rounded-corners
Effect	Brightness
		Contrast
		Rotate
		Sharpen
		Blur
Watermark	Image watermark
Watermark		Text watermark

Constraints and limitations

Category	Description
Format	The original image must be in the JPG, JPEG, PNG, BMP, GIF, WebP, or TIFF format.
Size	The original image size must be 20 MB or smaller. The original image can have a width and height of up to 30,000 pixels, for a total of up to 250 million pixels. However, the width and height cannot exceed 4,096 pixels for the rotate operation.
QPS	The QPS limit for processing images in each region is 50. tip If you have a compute-intensive workload or usage that exceeds these limits, submit a ticket to consult with our technical team or your designated account manager.
Concurrency	The default concurrency limits for processing images are as follows: China (Beijing): 20 Other regions: 10 tip If you have a compute-intensive workload or usage that exceeds these limits, submit a ticket to consult with our technical team or your designated account manager.
Server-side encryption	You can use TOS to process images encrypted with SSE-TOS, SSE-C, or SSE-KMS, but there are some limitations to consider: SSE-C When processing an image encrypted with SSE-C, you must include the following SSE-C request headers. For more information on SSE-C headers, see Using server-side encryption with customer-provided keys (SSE-C). x-tos-server-side-encryption-customer-algorithm x-tos-server-side-encryption-customer-key x-tos-server-side-encryption-customer-key-MD5 You can add a watermark to an image encrypted with SSE-C. However, you cannot use an SSE-C-encrypted image as a watermark on another image. For example, if images aaa and bbb are encrypted with SSE-C but image ccc is not, then you can add ccc as a watermark to bbb. However, you cannot add image aaa as a watermark to image bbb. SSE-KMS You cannot process images encrypted with SSE-KMS via anonymous access. To process SSE-KMS-encrypted images, you must activate Key Management Service (KMS) and have permission to access the master key. Requests must also be signed using valid credentials.

Cropping images

In the left navigation pane, select Multimedia Experience Center > Image processing.

On the Image Processing Experience Center page, select the bucket where your image is stored in the top menu bar.

In the image upload area, click Select image.

In the Select file dialog box, select the image and click OK.

In the left action bar, click Crop. Then, select a cropping method and adjust the relevant settings.

Standard cut

To crop an image using standard cut, first select a starting point on the original image. Then, specify the width and height to define the cropping area.

Parameter	Description
Crop start position	The origin for cropping.
Abscissa of starting point	The horizontal offset of the starting point (X-axis) relative to the specified origin (g). tip A positive value shifts the starting point to the right, while a negative value shifts the starting point to the left.
Starting ordinate	The vertical offset of the starting point (Y-axis) relative to the specified origin (g). tip A positive value shifts the starting point down, while a negative value shifts the starting point up.
Width	The width of the crop, in pixels (px).
High	The height of the crop, in pixels (px).
Crop shape	You can crop the image into a rectangle, rounded rectangle, or circle. Rectangle: Crops the image into a rectangle based on the specified width and height. Rounded rectangle: Crops the image into a rounded rectangle based on the specified corner radius. Round: Crops the image into a circle centered in the middle, based on the specified radius.

Free cropping

To use free cropping, you must first specify the crop ratio. The system will then generate an adjustable cropping area on the image according to the selected ratio. You can then freely drag and resize this area. TOS will then crop the image based on the selected range.

Parameter	Description
Select crop ratio	Specify the crop ratio to create an adjustable cropping area. You can freely drag and resize this area. TOS will then crop the image based on the selected range. Steps: Click Start cropping to select a crop ratio. Then, drag to adjust the cropping area. Once you have decided on the area, click Confirm crop. tip Only the original image can be cropped.
Crop shape	You can crop the image into a rectangle, rounded rectangle, or circle. Options: Rectangle: Crops the image into a rectangle based on the specified width and height. Rounded rectangle: Crops the image into a rounded rectangle based on the specified corner radius. Round: Crops the image into a circle centered in the middle, based on the specified radius.

Once the parameters are configured, TOS will automatically crop the image. You can view the cropped image in the image upload area.

tip

On the Image Processing Experience Center page, press and hold the compare icon in the top menu bar to view the image before processing. Release it to return to the processed image. Click the reset icon to revert the image to its original state.

Export the processed image.

Download the processed image

On the Image Processing Experience Center page, click Download in the upper-right corner to save the processed image to your local device.

Share the processed image

On the Image Processing Experience Center page, click Copy Link in the upper-right corner to copy the pre-signed URL. You can then share this link with others so that they can access the processed image.

Save the processed image to a specific bucket

On the Image Processing Experience Center page, click the copy icon at the bottom to copy the cropping parameters. Add these parameters to the image URL, and then add persistence parameters to save the processed image to the specified bucket. For more information, see Saving processed files.

Applying effects to images

In the left navigation pane, select Multimedia Experience Center > Image processing.

On the Image Processing Experience Center page, select the bucket where your image is stored in the top menu bar.

In the image upload area, click Select image.

In the Select file dialog box, select the image and click OK.

In the left action bar, click Effect and adjust the relevant settings.

Parameter	Description
Brightness	Adjusts the brightness of the image. The value range is from -100 to 100. Value < 0: Reduces image brightness. Value = 0: No adjustment to image brightness. Value > 0: Increases image brightness.
Contrast Ratio	Adjusts the contrast of the image. The value range is from -100 to 100. Value < 0: Decreases image contrast. Value = 0: No adjustment to image contrast. Value > 0: Increases image contrast.
Spin	Rotates the image clockwise by a specified degree. warning If the rotation angle is not a multiple of 90°, the size of the processed image will increase. The width or height of the image must not exceed 4096 pixels.
Sharpen	Sharpens an image. The value range is from 50 to 399. Higher values increase image clarity, but excessively high values may cause distortion. For optimal results, a value of 100 is recommended.
Blurry	Blurs the image. Blur Radius: The value range is from 1 to 50. The larger the value is, the blurrier the image. Standard Deviation in Gaussian Blur: The value range is from 1 to 50. The larger the value is, the blurrier the image.

Once the parameters are configured, TOS will automatically process the image. You can view the processed image in the image upload area.

tip

Export the processed image.

Download the processed image

On the Image Processing Experience Center page, click Download in the upper-right corner to save the processed image to your local device.

Share the processed image

On the Image Processing Experience Center page, click Copy Link in the upper-right corner to copy the pre-signed URL. You can then share this link with others so that they can access the processed image.

Save the processed image to a specific bucket

On the Image Processing Experience Center page, click the copy icon at the bottom to copy the image processing parameters. Add these parameters to the image URL, and then add persistence parameters to save the processed image to the specified bucket. For more information, see Saving processed files.

Adding watermarks

In the left navigation pane, select Multimedia Experience Center > Image processing.

On the Image Processing Experience Center page, select the bucket where your image is stored in the top menu bar.

In the image upload area, click Select image.

In the Select file dialog box, select the image and click OK.

In the left action bar, click Watermark. Then, select a Watermarking method and adjust the relevant settings.

Image watermark

Parameter	Description
Watermark image	Select an image to use as the watermark. tip The watermark image must be in the same bucket as the original image.
Scale	Specify the percentage by which to resize the watermark image.
Watermark Location	Specify the location of the watermark in the image, along with the vertical and horizontal margins. Vertical margin: The vertical distance between the watermark and the edge of the image. This parameter only applies when the watermark position is set to top left, top center, top right, bottom left, bottom center or bottom right. Horizontal margin: The horizontal distance between the watermark and the edge of the image. This parameter only applies when the watermark is set to top left, center left, bottom left, top right, center right, or bottom right.
Opacity	Specify the opacity of the watermark image. A higher value indicates greater opacity.

Text watermark

Parameter	Description
Text Content	Text watermark content. tip Text watermarking does not currently support traditional Chinese characters.
Text Font	Font of the text watermark.
Text size	Size of the text watermark.
Text Rotation	Degree of the clockwise rotation of the text watermark.
Text Color	Color of the text watermark. Enter a hexadecimal color code ranging from 000000 to FFFFFF.
Text Filling the Space	Specify whether the text watermark should fill the original image.
Text Shadow	Shadow opacity of the text watermark. tip The text shadow feature will not work if the text is rotated.
Watermark Location	Specify the location of the watermark in the image, along with the vertical and horizontal margins. Vertical margin: The vertical distance between the watermark and the edge of the image. This parameter only applies when the watermark position is set to top left, top center, top right, bottom left, bottom center or bottom right. Horizontal margin: The horizontal distance between the watermark and the edge of the image. This parameter only applies when the watermark is set to top left, center left, bottom left, top right, center right, or bottom right.
Opacity	Specify the opacity of the text watermark. A higher value indicates greater opacity.

Once the parameters are configured, TOS will automatically process the image. You can view the processed image in the image upload area.

tip

Export the processed image.

Download the processed image

On the Image Processing Experience Center page, click Download in the upper-right corner to save the processed image to your local device.

Share the processed image

On the Image Processing Experience Center page, click Copy Link in the upper-right corner to copy the pre-signed URL. You can then share this link with others so that they can access the processed image.

Save the processed image to a specific bucket

On the Image Processing Experience Center page, click the copy icon at the bottom to copy the image processing parameters. Add these parameters to the image URL, and then add persistence parameters to save the processed image to the specified bucket. For more information, see Saving processed files.

Last updated: 2026.08.20 17:53:16