×

图片处理

返回介绍页
  • 基本信息
  • 图片旋转
  • 获取图片信息
  • 图片瘦身
  • 图片格式转换
  • 图片裁剪
  • 图片缩放
  • 固定图片大小
  • 图片水印
  • 图片效果

图片处理API文档

图片处理提供对图片的基本操作API,包括图片的缩略、剪裁、信息处理、参数调节等;

在使用图片处理的服务之前,需先把图片存储在对象存储中,此服务以API的形式提供,对象存储与图片处理单独计费。

图片处理为小时计费,按每小时调用图片处理API的请求次数计算,价格如下:

计费项 计费单价 计费公式
图片处理 0.1元/千次 每千次请求的单价*每小时实际请求次数/1000

注:此产品每小时计费,当一小时产生了图片处理费用但不足0.01元时,按0.01元扣费。

通用信息说明:TYPE代表图片格式,PNG的时候TYPE=1,JPG的时候为2,不传该参数默认按照JPG处理,如果是PNG格式需要指定TYPE字段,处理成功返回图片的BASE64编码后的数据,处理失败则返回异常信息。

目录

相关产品

对象存储

非结构化数据的通用数据存储平台

安全可靠、低成本

1

云主机

优质均衡、优质配置

SSD 55元/月起

SAS 38元/月起        

数据库MYSQL版

高性能MYSQL数据库服务

主从双机102元/月起

1

图片旋转

图片旋转,可以对图片进行一定角度的翻转(逆时针)。

请求语法:

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}

接口参数说明:

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}

免费咨询获取折扣