The rounded-corners feature allows you to crop an image into a rounded rectangle with a specified radius. This topic introduces the parameters and provides examples of the rounded-corners feature.

Supported parameters

Parameter

Description

Value

Required

Parameter	Description	Value	Required
r	The radius of the rounded corner.	[1,4096]	Yes

Notes

If the output format does not support an alpha channel, such as JPG or JPEG, the area outside the rounded rectangle will be filled with white.

If the input format supports an alpha channel, such as PNG, WebP, BMP, or other raster image formats, the area outside the rounded rectangle will be transparent. We recommend that you save as a PNG file.

If the corner radius exceeds half of the length of the short side of the original image, it will automatically be set to the largest possible inscribed circle radius for the image.

Examples

Set the radius to 100, the output format to JPG, and fill the area outside the rounded rectangle with white.

https://tos-tools.tos-cn-beijing.volces.com/misc/sample.png?x-tos-process=image/rounded-corners,r_100/format,jpg

Set the radius to 100, the output format to PNG, and make the area outside the rounded rectangle transparent.

https://tos-tools.tos-cn-beijing.volces.com/misc/sample.png?x-tos-process=image/rounded-corners,r_100/format,png

Last updated: 2026.02.03 17:51:49

Public security network record in Beijing: No. 11010802032137