控制台指南

最佳实践

开发者指南

API 文档

SDK 文档

诚邀爱技术、爱分享的你,成为文档内容共建者> HOT

功能描述

图片质量评估功能为同步请求方式,您可以通过本接口对图片文件进行检测,从多方面评估,最终给出综合可观的清晰度评分和主观的美观度评分。该接口属于 GET 请求。

费用说明

限制说明

  • 图片支持格式:PNG、JPG、JPEG。
  • 图片大小:所下载图片经 Base64 编码后不超过4MB
  • 图片像素:建议大于50 * 50像素,否则影响识别效果。
  • 长宽比:建议长边与短边的比例小于5:1
  • 调用接口需携带签名,具体规则请参见 请求签名 文档。

请求

请求示例

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-image
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>

目录