图片平均色调(imageAve)
imageAve接口用于计算一幅图片的平均色调,并以0xRRGGBB
形式返回。
注意:
- 请求图片长和宽均不能超过10000像素
- 请求图片总大小不超过20MB
请求报文
请求语法
GET <imageDownloadUri>?imageAve HTTP/1.1
Host: <imageDownloadHost>
头部信息
头部名称 | 必填 | 说明 |
---|---|---|
Host | 是 | 下载服务器域名,可为七牛三级域名或自定义二级域名,参考七牛自定义域名绑定流程。 |
响应报文
响应语法
HTTP/1.1 200 OK
Content-Type: application/json
Cache-Control: no-store
{
"RGB": "<ImageAve string>"
}
头部信息
头部名称 | 必填 | 说明 |
---|---|---|
Content-Type | 是 | MIME类型,固定为application/json 。 |
Cache-Control | 是 | 缓存控制,固定为no-store ,不缓存。 |
响应内容
- 如果请求成功,返回包含如下内容的JSON字符串(已格式化,便于阅读):
{
"RGB": "<ImageAve string>"
}
字段名称 | 必填 | 说明 |
---|---|---|
RGB | 是 | 图片主色调,0xRRGGBB 格式。 |
- 如果请求失败,返回包含如下内容的JSON字符串(已格式化,便于阅读):
{
"code": <HttpCode int>,
"error": "<ErrMsg string>",
}
字段名称 | 必填 | 说明 |
---|---|---|
code | 是 | HTTP状态码,请参考响应状态。 |
error | 是 | 与HTTP状态码对应的消息文本 |
响应状态码
HTTP状态码 | 含义 |
---|---|
200 | 请求成功 |
400 | 请求报文格式错误 |
404 | 资源不存在 |
599 | 服务端操作失败。 如遇此错误,请将完整错误信息(包括所有HTTP响应头部)提交工单 给我们。 |
注意:缩略图等经过云处理的新图片不支持该方法。
示例
在Web浏览器中输入以下图片地址:
https://o6nalx2hr.qnssl.com/0.jpg?imageAve
返回结果(内容经过格式化以便阅读):
{
"RGB": "0x85694d"
}
文档反馈
(如有产品使用问题,请提交工单)