全部文档
当前文档
最近更新时间：2025-11-07 14:43:25
roundedCorners
将图片剪切为圆角矩形。其圆角参数可通过两种方式定义：一是统一的圆角半径，二是独立的水平与垂直半径。
该接口操作需要是Bucket Owner或具有ks3:GetObject权限。
支持的图片格式包括JPG、JPEG、BMP、PNG、WebP、TIFF、PCX、GIF、WBMP、SVG、TIF、HEIF、HEIC。
如果图片的最终格式是PNG，WEBP，BMP等支持透明通道的图片，那么图片非圆角区域的地方将会以透明填充；如果图片的最终格式是JPG，JPEG等不支持透明通道的图片，那么非圆角区域是以白色进行填充。
https://<bucketName>.<endpoint>/<objectKey>@base@tag=roundedCorners&r=<radius>&F=<format>参数名称 | 参数含义 | 是否必填 | 取值范围 |
tag | 操作标志 | 是 | roundedCorners |
r | 指定圆角的半径，水平和垂直方向的值相同，可以使用像素数（如200）或百分比（如25p） | 否 说明：要么指定r，要么同时指定rx和ry | 像素数取值范围为[1，4096]，当像素数大于原图最小边的一半时，取最小边的二分之一 百分比取值范围为[1p，50p] |
rx | 圆角水平方向的半径 | 否 说明：需要与ry同时使用 | |
ry | 圆角垂直方向的半径 | 否 说明：需要与rx同时使用 | |
F | 指定目标图的输出格式。默认按照原图格式输出 | 否 | 输出格式支持JPG、JPEG、BMP、PNG、WebP、TIFF、PCX、GIF、WBMP、TIF、HEIF、HEIC |
该请求不需要设置特殊的头部。
头部名称 | 是否必填 | 说明 |
Content-Type | 是 | MIME类型，成功时为图片固定的MIME类型image/*，失败时为application/json |
如果请求处理成功，返回图片的二进制图片数据。
如果请求失败，则返回如下JSON格式的内容：
{
"code": <code String>,
"message": <ErrorMessage String>,
"requestId": <requestId String>
}HTTP状态码 | 描述 |
400 |
|
403 | 签名不匹配或无操作对应权限 |
404 | 请求的资源不存在 |
500 | 服务器端操作失败。如果遇到此种错误，请及时联系我们 |
原图
处理参数如下：
操作参数：roundedCorners
设置圆角半径为100px
保存为PNG格式
http://ks3-resources.ks3-cn-beijing.ksyuncs.com/suiyi.jpg@base@tag=roundedCorners&r=100&F=png目标图
处理参数如下：
操作参数：roundedCorners
设置水平圆角半径为10px，垂直圆角半径为100px
保存为PNG格式
http://ks3-resources.ks3-cn-beijing.ksyuncs.com/suiyi.jpg@base@tag=roundedCorners&rx=10&ry=100&F=png目标图
纯净模式