功能概述
腾讯云数据万象通过 imageAve 接口获取图片主色调信息。
授权说明
服务开通
使用该功能将默认为您开通数据万象，并绑定存储桶，无需角色授权，即可直接使用。
使用限制
费用说明
该接口为付费服务，产生的费用将由数据万象收取，详细计费说明可参见 图片处理费用。
如果采用下载时处理的方式，且通过外网进行下载，调用会产生 流量费用。
接口示例
GET /<ObjectKey>?imageAve HTTP/1.1Host: <BucketName-APPID>.cos.<Region>.myqcloud.comDate: <GMT Date>Authorization: <Auth String>
处理参数说明
请求参数
操作名称：imageAve
参数 | 含义 |
ObjectKey | 对象文件名，例如 folder/sample.jpg。 |
响应体
参数 | 含义 |
RGB | 返回的色调信息格式为：0xRRGGBB （RR、GG、BB都是十六进制数，表示红、绿、蓝三种颜色）。 |
实际案例
案例一：公有读
请求
http://examples-1251000004.cos.ap-shanghai.myqcloud.com/sample.jpeg?imageAve
响应
{"RGB": "0x736246"}
案例二：私有读、携带签名
获取方式同上，仅增加签名部分，并与获取参数以“&”连接，示例如下：
http://examples-1251000004.cos.ap-shanghai.myqcloud.com/sample.jpeg?q-sign-algorithm=<signature>&imageAve
说明：
注意事项
为了避免未授权人员通过访问不携带处理参数的链接实现访问和下载原图的情况，您可同时将处理参数签入到请求签名中，处理参数整体是参数的 key，value 为空，如下是简单的示例（仅做样式参考，可能已经过期无法直接访问），详细计算方法请参见 请求签名。
http://examples-1251000004.cos.ap-shanghai.myqcloud.com/sample.jpeg?q-sign-algorithm=sha1&q-ak=AKID********************&q-sign-time=1593342360;1593342720&q-key-time=1593342360;1593342720&q-header-list=&q-url-param-list=watermark%252f1%252fimage%252fahr0cdovl2v4yw1wbgvzlteyntewmdawmdqucgljc2gubxlxy2xvdwquy29tl3nodwl5aw4uanbn%252fgravity%252fsoutheast&q-signature=26a429871963375c88081ef60247c5746e834a98&watermark/1/image/aHR0cDovL2V4YW1wbGVzLTEyNTEwMDAwMDQucGljc2gubXlxY2xvdWQuY29tL3NodWl5aW4uanBn/gravity/southeast
