功能描述
图片质量评分功能为同步请求方式，您可以通过本接口对图片文件进行检测，从多方面评估，最终给出综合可观的清晰度评分和主观的美观度评分。
注意：
本接口属于 GET 请求，为同步请求方式，需携带签名，具体签名设置请参见 请求签名。
不支持对 COS 上的归档存储类型和深度归档存储类型的图片进行处理，如果需要处理此类型图片，请先 恢复归档文件。
授权说明
服务开通
使用该功能需提前开通数据万象，并绑定存储桶。详情请参见 绑定存储桶。
使用该功能需提前通过控制台或接口开通 AI 内容识别服务 。详情请参见 开通 AI 内容识别服务。
使用限制
使用该接口时，请先确认相关限制条件。详情请参见使用限制。
图片支持格式：PNG、JPG、JPEG。
图片大小：所下载图片经 Base64 编码后不超过4MB。
图片像素：建议大于50*50像素，否则影响识别效果。
长宽比：建议长边与短边的比例小于5:1。
费用说明
如果图片属于 COS 上的低频存储类型，成功调用接口会产生 COS 低频数据取回费用。
请求
请求示例
GET /<ObjectKey>?ci-process=AssessQuality HTTP/1.1Host: <BucketName-APPID>.cos.<Region>.myqcloud.comDate: <GMT Date>Authorization: <Auth String>
说明
请求参数
参数名称 | 描述 | 类型 | 是否必选 |
ObjectKey | 对象文件名，例如：folder/document.jpg。 | String | 是 |
ci-process | 数据万象处理能力，图像质量检测固定为 AssessQuality。 | String | 是 |
请求头
请求体
该请求的请求体为空。
响应
响应头
响应体
该响应体返回为 application/xml 数据，包含完整节点数据的内容展示如下：
<Response><LongImage>FALSE</LongImage><BlackAndWhite>FALSE</BlackAndWhite><SmallImage>FALSE</SmallImage><BigImage>TRUE</BigImage><PureImage>FALSE</PureImage><ClarityScore>89</ClarityScore><AestheticScore>70</AestheticScore><RequestId></RequestId></Response>
具体的数据内容如下：
节点名称（关键字） | 父节点 | 描述 | 类型 |
Response | 无 | 保存结果的容器。 | Container |
Response 的内容：
参数名称 | 描述 | 类型 |
LongImage | 取值为 TRUE 或 FALSE，TRUE 为长图，FALSE 为正常图，长图定义为长宽比大于等于3或小于等于1/3的图片。 | Boolean |
BlackAndWhite | 取值为 TRUE 或 FALSE，TRUE 为黑白图，FALSE 为否。黑白图即灰度图，指红绿蓝三个通道都是以灰度色阶显示的图片，并非视觉上的“黑白图片”。 | Boolean |
SmallImage | 取值为 TRUE 或 FALSE，TRUE 为小图，FALSE 为否, 小图定义为最长边小于179像素的图片。当一张图片被判断为小图时，不建议做推荐和展示，其他字段统一输出为0或 FALSE。 | Boolean |
BigImage | 取值为 TRUE 或 FALSE，TRUE 为大图，FALSE 为否，定义为最短边大于1000像素的图片。 | Boolean |
PureImage | 取值为 TRUE 或 FALSE，TRUE 为纯色图或纯文字图，即没有内容或只有简单内容的图片，FALSE 为正常图片。 | Boolean |
ClarityScore | 综合评分。图像清晰度的得分，对图片的噪声、曝光、模糊、压缩等因素进行综合评估，取值为[0, 100]，值越大，越清晰。一般大于50为较清晰图片，标准可以自行把握。 | Integer |
AestheticScore | 综合评分。图像美观度得分，从构图、色彩等多个艺术性维度评价图片，取值为[0, 100]，值越大，越美观。一般大于50为较美观图片，标准可以自行把握。 | Integer |
RequestId | 唯一请求 ID，每次请求都会返回。定位问题时需要提供该次请求的 RequestId。 | String |
错误码
实际案例
请求
GET /<ObjectKey>?ci-process=AssessQuality HTTP/1.1Host: examplebucket-1250000000.cos.ap-beijing.myqcloud.comDate: Tue, 03 Apr 2019 09:06:15 GMTAuthorization: q-sign-algorithm=sha1&q-ak=AKIDZfbOAo7cllgPvF9cXFrJD0a1ICvR****&q-sign-time=1497530202;1497610202&q-key-time=1497530202;1497610202&q-header-list=&q-url-param-list=&q-signature=28e9a4986df11bed0255e97ff90500557e0e****Host: examplebucket-1250000000.cos.ap-beijing.myqcloud.com
响应
HTTP/1.1 200 OKContent-Type: application/xmlContent-Length: 414641Date: Thu, 15 Jun 2017 12:37:29 GMTServer: tencent-cix-cos-request-id: NWFjMzQ0MDZfOTBmYTUwXzZkZV8z****<Response><LongImage>FALSE</LongImage><BlackAndWhite>FALSE</BlackAndWhite><SmallImage>FALSE</SmallImage><BigImage>TRUE</BigImage><PureImage>FALSE</PureImage><ClarityScore>89</ClarityScore><AestheticScore>70</AestheticScore><RequestId>NTk0MjdmODlfMjQ4OGY3XzYzYzhf****</RequestId></Response>
