调用格式
API_url?cai=imageMogr2/cut/<width>x<height>x<dx>x<dy>
/crop/<imageSizeAndOffsetGeometry>
/iradius/<radius>
/rradius/<radius>
/scrop/<Width>x<Height>
参数 | 含义 |
---|---|
API_url | API的访问链接,具体构成为<BucketName-APPID>.cos.<Region>.myqcloud.com/<picture name>, 例如 examplebucket-1250000000.cos.ap-shanghai.myqcloud.com/picture.jpeg |
/ignore-error/1 | 当处理参数中携带此参数时,针对文件过大、参数超限等导致处理失败的场景,会直接返回原图而不报错 |
普通裁剪
操作名称:cut。
参数 | 含义 |
---|---|
<width> | 指定目标图片的宽为 width |
<height> | 指定目标图片的高为 height |
<dx> | 相对于图片左上顶点水平向右偏移 dx |
<dy> | 相对于图片左上顶点水平向下偏移 dy |
栗子举个
https://service-rivjlduv-1306777571.sh.apigw.tencentcs.com/release/?cai=imageMogr2/cut/600x600x100x10
缩放裁剪
操作名称:crop。
参数 | 含义 |
---|---|
/crop/<Width>x | 指定目标图片宽度为 Width,高度不变。Width 取值范围应大于0,小于原图宽度 |
/crop/x<Height> | 指定目标图片高度为 Height,宽度不变。Height 取值范围应大于0,小于原图高度 |
/crop/<Width>x<Height> | 指定目标图片宽度为 Width,高度为 Height 。Width 和 Height 取值范围都应大于0,小于原图宽度/高度 |
栗子举个
https://service-rivjlduv-1306777571.sh.apigw.tencentcs.com/release/?cai=imageMogr2/crop/300x400/gravity/center
内切圆裁剪参数说明
操作名称:iradius。
参数 | 含义 |
---|---|
/iradius/<radius> | 内切圆裁剪功能,radius 是内切圆的半径,取值范围为大于0且小于原图最小边一半的整数。内切圆的圆心为图片的中心。图片格式为 gif 时,不支持该参数。 |
https://service-rivjlduv-1306777571.sh.apigw.tencentcs.com/release/?cai=imageMogr2/iradius/200
圆角裁剪参数说明
操作名称:rradius。
参数 | 含义 |
---|---|
/rradius/<radius> | 圆角裁剪功能,radius 为图片圆角边缘的半径,取值范围为大于0且小于原图最小边一半的整数。圆角与原图边缘相切。图片格式为 gif 时,不支持该参数。 |
人脸智能裁剪参数说明
操作名称:scrop。
参数 | 含义 |
---|---|
/scrop/<Width>x<Height> | 基于图片中的人脸位置进行缩放裁剪。目标图片的宽度为 Width、高度为 Height。 |
九宫格方位图
九宫格方位图可为图片的多种操作提供位置参考。红点为各区域位置的原点(通过 gravity 参数选定各区域后位移操作会以相应远点为参照)。