全部文档
当前文档
最近更新时间：2025-10-30 20:23:04
blur
可以给图片添加全局模糊或任意位置的局部模糊。
该接口操作需要是Bucket Owner或具有ks3:GetObject权限。
https://<bucketName>.<endpoint>/<objectKey>@base@tag=blur&r=<radius>&s=<sigma>&w=<width>&h=<height>&x=<offsetX>&y=<offsetX>参数名称 | 参数含义 | 是否必填 | 取值范围 |
tag | 操作标志 | 是 | blur |
r | 模糊半径 | 是 | [1,50] 该值越大，图片越模糊 |
s | 正态分布的标准差 | 是 | [1,50] 该值越大，图片越模糊 |
w | 模糊区域的宽度 | 否 | [0, 图片宽度]，默认为图片宽度 |
h | 模糊区域的高度 | 否 | [0, 图片高度]，默认为图片高度 |
x | 模糊区域的起始横坐标，左上角坐标为（0，0） | 否 | [0, 图片宽度]，默认为0 |
y | 模糊区域的起始纵坐标，左上角坐标为（0，0） | 否 | [0, 图片高度]，默认为0 |
该请求不需要设置特殊的头部。
头部名称 | 是否必填 | 说明 |
Content-Type | 是 | MIME类型，成功时为图片固定的MIME类型image/*，失败时为application/json |
如果请求处理成功，返回图片的二进制图片数据。
如果请求失败，则返回如下JSON格式的内容：
{
"code": <code String>,
"message": <ErrorMessage String>,
"requestId": <requestId String>
}HTTP状态码 | 描述 |
400 |
|
403 | 签名不匹配或无操作对应权限 |
404 | 请求的资源不存在 |
500 | 服务器端操作失败。如果遇到此种错误，请及时联系我们 |
原图
处理参数如下：
操作参数：blur
设置模糊半径为5px
设置标准差为5
http://ks3-resources.ks3-cn-beijing.ksyuncs.com/suiyi.jpg@base@tag=blur&r=5&s=5目标图
处理参数如下：
操作参数：blur
设置模糊半径和标准差为5
设置模糊区域的起点为（50，50）
设置模糊区域的宽度为100px，高度为100px
http://ks3-resources.ks3-cn-beijing.ksyuncs.com/suiyi.jpg@base@tag=blur&r=5&s=5&x=50&y=50&w=100&h=100目标图
纯净模式