在线咨询GET /v1/storage/oss/{bucket}/{object}?imageRotate=value&type=1 HTTP/1.1
Host: cname.domain.com
Authorization: AWS {access-key}:{hash-of-header-and-secret}
图片处理
返回介绍页- 基本信息
- 图片旋转
- 获取图片信息
- 图片瘦身
- 图片格式转换
- 图片裁剪
- 图片缩放
- 固定图片大小
- 图片水印
- 图片效果
图片处理API文档
图片处理提供对图片的基本操作API，包括图片的缩略、剪裁、信息处理、参数调节等；
在使用图片处理的服务之前，需先把图片存储在对象存储中，此服务以API的形式提供，对象存储与图片处理单独计费。
图片处理为小时计费，按每小时调用图片处理API的请求次数计算，价格如下：
| 计费项 | 计费单价 | 计费公式 |
|---|---|---|
| 图片处理 | 0.1元/千次 | 每千次请求的单价*每小时实际请求次数/1000 |
注：此产品每小时计费，当一小时产生了图片处理费用但不足0.01元时，按0.01元扣费。
通用信息说明：TYPE代表图片格式,PNG的时候TYPE=1，JPG的时候为2,不传该参数默认按照JPG处理，如果是PNG格式需要指定TYPE字段，处理成功返回图片的BASE64编码后的数据，处理失败则返回异常信息。
目录
图片旋转
获取图片信息
图片瘦身
图片格式转换
图片裁剪
图片缩放
固定图片大小
图片水印
图片效果
图片旋转
图片旋转，可以对图片进行一定角度的翻转(逆时针)。
请求语法：
接口参数说明：
OBJECT必须为图片(名称可以不必为图片，但是内容必须为图片，不满足的时候返回异常信息)，目前支持JPG(JPEG)和PNG格式。
VALUE值在（0-360）之间
旋转图片可能会导致图片的尺寸变大。
旋转对图片的尺寸有限制，图片的宽或者高不能超过4096。
获取图片信息
获取图片信息，该接口可以获取图片的基本信息，包括大小，格式，MD5值等。
GET /v1/storage/oss/{bucket}/{object}?imageInfo&type=1 HTTP/1.1
Host: cname.domain.com
Authorization: AWS {access-key}:{hash-of-header-and-secret}
说明：
出错返回错误信息，成功返回图片基本信息，格式如下
{
"FORMAT": "JPEG",
"HEIGHT": 1000,
"MD5": "1da97ca056810107c781ad1b2e524e32",
"MODE": "RGB",
"SIZE": 87185,
"WIDTH": 809
}
图片瘦身
图片瘦身(压缩)，可以在最大程度的保证图片质量的基础上对图片进行压缩，减小图片大小，需要选择合适的压缩值。
GET /v1/storage/oss/{bucket}/{object}?imageSlim=value&type=1 HTTP/1.1
Host: cname.domain.com
Authorization: AWS {access-key}:{hash-of-header-and-secret}
接口参数说明：
OBJECT必须为图片(名称可以不必为图片，但是内容必须为图片，不满足的时候返回异常信息)，目前支持JPG(JPEG)和PNG格式。
JPG格式图片，VALUE指定图像保存时的品质，降低品质可以实现图像的压缩（瘦身），取值为[0,100], 0时图像可以得到极大地压缩
但是图像的品质会被大大降低，如果值过大会导致图片SIZE增大，但是质量最好。
PNG格式图片，VALUE取值范围为[0,9],为0时，压缩比最小，图像的品质最好。
该接口无法判断图片格式和TYPE是否匹配，只能按照TYPE字段处理图片，需要用户确实TYPE值的正确性。
图片格式转换
图片格式转换，目前暂时支持png和jpg转化。
GET /v1/storage/oss/{bucket}/{object}?imageFormat=value&type=1 HTTP/1.1
Host: cname.domain.com
Authorization: AWS {access-key}:{hash-of-header-and-secret}
接口参数说明：
VALUE为12（PNG2JPG）或21(JPG2PNG)。
图片裁剪
目录
裁剪（IMAGE CUT OFF）
GET /v1/storage/oss/{bucket}/{object}?imageCutOff=value&type=1 HTTP/1.1
Host: cname.domain.com
Authorization: AWS {access-key}:{hash-of-header-and-secret}
接口参数说明：
VALUE=100_233_223_232。
距离图片左边界距离X， 距离图片上边界距离Y，距离图片左边界距离+裁剪框宽度X+W，距离图片上边界距离+裁剪框高度Y+H。
(X, Y, X+W, Y+H), X,Y是裁剪框左上角的坐标， X+W,Y+H是右下角的坐标。
上面的值如果超出图片边界则截图到最边缘(当前处理方式）。
内切圆（IMAGE INSCRIBED CIRCLE）
内切圆，可以把图片保存成圆形，并指定圆形的大小。
GET /v1/storage/oss/{bucket}/{object}?imageInscribedCircle =value&type=1 HTTP/1.1
Host: cname.domain.com
Authorization: AWS {access-key}:{hash-of-header-and-secret}
IMAGEINSCRIBEDCRICLE代表内切圆半径。
图片被保存成PNG格式。
生成圆角（IMAGE ROUNDPIC）
ROUNDPIC 将图片生成圆角图片，并且可以指定图片的圆角大小。
这个接口支持的原图片格式有PNG、JPG，处理后的图片格式为PNG。
GET /v1/storage/oss/{bucket}/{object}?imageRoundPic=value&type=1 HTTP/1.1
Host: cname.domain.com
Authorization: AWS {access-key}:{hash-of-header-and-secret}
VALUE值为圆角半径，如果超过最短边一半则不处理。
图片被保存成PNG格式。
图片缩放
图片缩放（按照比例）。
GET /v1/storage/oss/{bucket}/{object}?imageScale=value&type=1 HTTP/1.1
Host: cname.domain.com
Authorization: AWS {access-key}:{hash-of-header-and-secret}
说明：
VALUE=0.3_0.7（缩小比例，分别对应高和宽，值在（0,1]）。
VALUE=1.5_2.8（放大比例，分别对应高和宽，值>=1）。
目标图的大小乘积不大于4096*4096，单边大小不超过4096*4。
固定图片大小
目录
双边固定（FIX Double Size）
固定图片宽高大小。
GET /v1/storage/oss/{bucket}/{object}?imageFixDoubleSize =value&type=1 HTTP/1.1
Host: cname.domain.com
Authorization: AWS {access-key}:{hash-of-header-and-secret}
VALUE=W100或者VALUE=H205, //W 高度 H 宽度。
强制固定图片大小，该操作可能会导致图片变形，单边长度不超过4096*4，W*H不超过4096*4096。
单边固定（FIX Single Size）
GET /v1/storage/oss/{bucket}/{object}?imageFixSingleSize =value&type=1 HTTP/1.1
Host: cname.domain.com
Authorization: AWS {access-key}:{hash-of-header-and-secret}
VALUE=W100或者VALUE=H205, //W 高度 H 宽度。
单边固定，另一边随比例缩放(IMAGEFIXSINGLESIZE=W_120)，一般不超过4096，可能会导致图片变形。
图片水印
目录
文字水印（WORD WATERMARK）
GET /v1/storage/oss/{bucket}/{object}?imageAddWordWatermark=str&position=12_40&color=231_123_100&type=1 HTTP/1.1
Host: cname.domain.com
Authorization: AWS {access-key}:{hash-of-header-and-secret}
说明：
STR为水印内容，需要注意，如果带有空格，使用POSTMAN发送请求的时候空格会被转义(尽量不要携带空格)。
POSITION为水印写入起始位置，不超过原图片大小，如果字符串过长可能导致水印添加不完整或者失败。
COLOR为字体颜色，RGB三原色，取值范围[0,255],非必须参数。
暂时不支持自定义字体格式，大小和中文。
图片水印（IMAGE WATERMARK）
GET /v1/storage/oss/{bucket}/{object}?imageAddImageWatermark=url&type=1 HTTP/1.1
Host: cname.domain.com
Authorization: AWS {access-key}:{hash-of-header-and-secret}
URL为水印图片的路径，完整路径为BUCKETNAME/OBJECTNAME/TYPE, BUCKETNAME,OBJECTNAME是必填项，TYPE为图片类型，PNG的时候1，JPG的时候为2，不传默认按照JPG处理，路径也可以为BUCKETNAME/OBJECTNAME或者BUCKETNAME/OBJECTNAME/。
POSITION表示图片水印添加的位置, 可选参数，默认放在右下角(3)，取值以及代表含义0:左上,1:右上,2:左下,3:右下,4:中间。
混合水印（MIXED WATERMARK）
GET /v1/storage/oss/{bucket}/{object}?imageAddMixWatermark&imagePath=url&type=1&imagePosition=value &word=str&wordPosition=12_40&color=231_123_100 HTTP/1.1
Host: cname.domain.com
Authorization: AWS {access-key}:{hash-of-header-and-secret}
文字水印和图片水印，详细规则见上面两个接口参数。
图片效果
目录
获取色调（IMAGE DOMINANT COLOR）
图片主色调，接口用于获取图片的平均色调。
GET /v1/storage/oss/{bucket}/{object}? imageDominantColor&type=1 HTTP/1.1
Host: cname.domain.com
Authorization: AWS {access-key}:{hash-of-header-and-secret}
说明：
返回RGB颜色的字符串。
简笔画（IMAGE Stick figure）
简笔画效果。
GET /v1/storage/oss/{bucket}/{object}? imageStickFigure&type=1 HTTP/1.1
Host: cname.domain.com
Authorization: AWS {access-key}:{hash-of-header-and-secret}
图片滤波（IMAGE FILTER EFFECT）
模糊锐化平滑浮雕轮廓等，方式详见说明：
GET /v1/storage/oss/{bucket}/{object}?imageFilterEffect=operation&type=1 HTTP/1.1
Host: cname.domain.com
Authorization: AWS {access-key}:{hash-of-header-and-secret}
说明：
OPERATION值为以下任意一个均可: GAUSSIAN_BLUR，BLUR,EMBOSS，SHARPEN，SMOOTH，DETAIL，FIND_EDGES，EDGE_ENHANCE，CONTOUR，SMOOTH_MORE, EDGE_ENHANCE_MORE。
高斯模糊:GAUSSIAN_BLUR
模糊:BLUR
浮雕:EMBOSS
锐化:SHARPEN
平滑：SMOOTH
细节：DETAIL
找到边缘:FIND_EDGES
边缘增强:EDGE_ENHANCE
轮廓:CONTOUR
深度平滑:SMOOTH_MORE
深度边缘增强:EDGE_ENHANCE_MORE
图片增强（IMAGE ENHANCE）
图片增强，可以对处理后的图片进行亮度/对比度增强。
GET /v1/storage/oss/{bucket}/{object}? imageEnhance=operation& multiple=value&type=1 HTTP/1.1
Host: cname.domain.com
Authorization: AWS {access-key}:{hash-of-header-and-secret}
说明：
VALUE:浮点数,大于等于1.0，必填参数。
OPERATION：BRIGHTNESS(亮度)或者CONTRAST（对比度），必填参数。
操作像素点（IMAGE PONIT）
操作像素点，在图片上显示的效果是图片变亮或者变暗。
GET /v1/storage/oss/{bucket}/{object}? imagePoint=value& multiple=value&type=1 HTTP/1.1
Host: cname.domain.com
Authorization: AWS {access-key}:{hash-of-header-and-secret}
说明：
VALUE类型是浮点或者整形，大于0小于等于3,小于1的时候图片变暗，大于1的时候变亮。
图片左右镜像（IMAGE FLIP_LEFT_RIGHT）
图片左右镜像。
GET /v1/storage/oss/{bucket}/{object}? imageFlip&type=1 HTTP/1.1
Host: cname.domain.com
Authorization: AWS {access-key}:{hash-of-header-and-secret}
商品已成功加入购物车