修改缩略图设置

修改缩略图&水印版本

请求地址

https://api.upyun.com/buckets/thumbs/

HTTP请求方法

POST

是否需要登陆授权

是，关于登录授权，参见授权机制

请求参数

必选 数据类型及范围 说明
bucket_name true string 空间名
thumb_name true string 版本名称
type true string 缩略方式
gifto false string 将动态GIF转换成静态图片
animate false string GIT多帧水印打印设置
value false integer 限定尺寸：宽度
value_h false integer 限定尺寸：高度
unsharp false string 锐化图片
watermark_enable false string 是否添加水印
watermark_file false binary 水印图片
watermark_opacity false integer 透明度
watermark_align true string 水印位置
watermark_margin_x false integer 距离左边
watermark_margin_y false string 距离上边
format false string 静态图片输出格式
quality false integer 图片质量
rotate false enum('auto', 'disable') 图片旋转，auto：自动扶正；disable：取消旋转
compress false enum('enable', 'disable') JPG/PNG 压缩优化，enable：开启压缩
progressive false enum('enable', 'diable') 渐进式图片展示，enable：开启，disable：关闭
gaussblur false enum('enable', 'disable') enable：开启高斯模糊，disable：关闭高斯模糊
gaussblur_radio false integer (0<= gaussblur_radio <=50) 高斯模糊半径（开启高斯模糊时， 参数有效，否则被忽略）
gaussblur_deviation false integer (0< gaussblur_deviation <1000) 高斯模糊标准差（开启高斯模糊时有效，否则被忽略）

buckent_name 说明：

参数取值 说明
仅允许使用英文、数字 创建后不允许修改或删除

type 说明：

参数取值 说明
fix_width 限定宽度，高度自适应
fix_height 限定高度，宽度自适应
fix_max 限定最长边，短边自适应
fix_min 限定最短边，长边自适应
fix_width_or_height 限定宽度和高度
fix_scale 等比例缩小图片
unchanged 保持原尺寸不变
fix_both 放大较小图片, 并裁剪较大图片

width 说明：

参数取值 说明
0-2000 整数值 没有输入或者超出，将被自动设置为500

height 说明：

参数取值 说明
整数值 和width相乘不能超过2亿

gifto 说明：

参数取值 说明
true 将动态GIF转换成静态图片
false 不将动态GIF转换成静态图片

animate 说明：

参数取值 说明
true 进行gif多帧水印打印
false 不进行gif多帧水印打印

watermark_enable 说明：

参数取值 说明
false 不添加水印
true 添加水印(所有图片)，gifto ：添加水印(仅转换后的静态图片)
gifto 添加水印(仅转换后的静态图片)

watermark_opacity 说明：

参数取值 说明
10-100 整数值 默认为100

format 说明：

参数取值 说明
默认 保持原来图片格式（gif，jpg，png）其他的都转换成jpg
jpg 转为jpg格式
png 转为png格式
webp 转为webp格式

quality 说明：

参数取值 说明
1-100 整数值 数值越大质量越好，当输出格式为png时，忽略该数值

返回结果

{
    "result": true 
}
错误返回值与错误代码，参见错误代码说明
Last edited by hubiao, 2015-09-28 10:46:18