有奖捉虫:云通信与企业服务文档专题,速来> HOT

功能描述

图片质量评分功能为同步请求方式,您可以通过本接口对图片文件进行检测,从多方面评估,最终给出综合可观的清晰度评分和主观的美观度评分。
注意:
本接口属于 GET 请求,为同步请求方式,需携带签名,具体签名设置请参见 请求签名
不支持对 COS 上的归档存储类型和深度归档存储类型的图片进行处理,如果需要处理此类型图片,请先 恢复归档文件

授权说明

通过子账号使用时,需要授予 ci:CreateAssessQualityJob权限,详情请参见 数据万象 action

服务开通

使用该功能需提前开通数据万象,并绑定存储桶。详情请参见绑定存储桶

使用限制

使用该接口时,请先确认相关限制条件。详情请参见使用限制
图片支持格式:PNG、JPG、JPEG。
图片大小:所下载图片经 Base64 编码后不超过4MB。
图片像素:建议大于50*50像素,否则影响识别效果。
长宽比:建议长边与短边的比例小于5:1。

费用说明

成功调用接口会产生 图片质量评估费用COS 读请求费用
如果图片属于 COS 上的低频存储类型,成功调用接口会产生 COS 低频数据取回费用


请求

请求示例

GET /<ObjectKey>?ci-process=AssessQuality HTTP/1.1
Host: <BucketName-APPID>.cos.<Region>.myqcloud.com
Date: <GMT Date>
Authorization: <Auth String>
说明
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.1
Host: examplebucket-1250000000.cos.ap-beijing.myqcloud.com
Date: Tue, 03 Apr 2019 09:06:15 GMT
Authorization: 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 OK
Content-Type: application/xml
Content-Length: 414641
Date: Thu, 15 Jun 2017 12:37:29 GMT
Server: tencent-ci
x-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>