文档中心

图片处理


图片主色调信息

接口

imgAve

描述:

获取图片的主色调,用于计算一幅图片的平均色调,并以0xRRGGBB形式返回。 支持的图片格式:jpg、jpeg、bmp、png、webp、tiff、pcx、svg、ht、gif、wbmp 不支持的图片格式:ai、tga、psd、eps、raw、pcd

权限

该接口操作需要具备GetObject权限,假如获取对象不存在,你可能存在以下两种返回:

  • 假如用户具有该对象所在Bucket的ListBucket权限,会返回状态码404错误;
  • 假如用户不具备该对象所在Bucket的ListBucket权限,会返回状态码403错误。

请求:

语法
https://BucketName.kss.ksyun.com/object@base@tag=imgAve HTTP/1.1
Host: BucketName.kss.ksyun.com
请求参数

该请求不需要设置参数。

请求头部

该请求不需要设置特殊的头部。

响应:

响应头部
头部名称 必填 说明
Content-Type MIME类型,固定为application/json
响应内容

响应格式以Json字符串的形式提供结果。

字段名称 说明
RGB 图片主色调,0xRRGGBB格式。
特殊错误
HTTP状态码 含义
400 请求报文格式错误
404 资源不存在
403 访问拒绝
500 服务端操作失败。

示例

1、在Web浏览器中输入以下请求:
https://ks3.kss.ksyun.com/image_deal/kssyun.png@base@tag=imgAve

2、获取返回结果   
{
    "RGB":"0x6c6d74"
}