功能描述
图片质量评估功能为同步请求方式，您可以通过本接口对图片文件进行检测，从多方面评估，最终给出综合客观的清晰度评分和主观的美观度评分。注意：本接口属于 GET 请求，为同步请求方式，需携带签名，具体签名设置请参见 请求签名。成功调用接口会产生 图片质量评估费用 和 COS 读请求费用。如果图片属于 COS 上的低频存储类型，成功调用接口会产生 COS 低频数据取回费用。不支持对 COS 上的归档存储类型和深度归档存储类型的图片进行处理，如果需要处理此类型图片，请先 恢复归档文件。
授权说明
授权策略中 action 设置为 ci:CreateAssessQualityJob 。查看所有 action。
服务开通
使用该功能需提前开通数据万象，并绑定存储桶。详情请参见 绑定存储桶。
使用限制
使用该接口时，请先确认相关限制条件。详情请参见 使用限制。图片支持格式：PNG、JPG、JPEG。图片大小：所下载图片经 Base64 编码后不超过4MB。图片像素：建议大于50 * 50像素，否则影响识别效果。长宽比：建议长边与短边的比例小于5:1。
请求
请求示例
GET /?ci-process=AssessQuality HTTP/1.1Host: .cos..myqcloud.comDate: Authorization:
说明 Authorization: Auth String （详情请参见 请求签名 文档）。
请求参数
| 参数名称 | 描述 | 类型 | 是否必选 |
| ObjectKey | 对象文件名，例如：folder/document.jpg。 | String | 是 |
| ci-process | 数据万象处理能力，图像质量检测固定为 AssessQuality。 | String | 是 |
请求头
此接口仅使用公共请求头部，详情请参见 公共请求头部 文档。
请求体
该请求无请求体。
响应
响应头
此接口仅返回公共响应头部，详情请参见 公共响应头部 文档。
响应体
该响应体返回为 application/xml 数据，包含完整节点数据的内容展示如下：
FALSE FALSE FALSE TRUE FALSE 89 70
具体的数据内容如下：
| 节点名称（关键字） | 父节点 | 描述 | 类型 |
| 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 /?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****
FALSE FALSE FALSE TRUE FALSE 89 70 NTk0MjdmODlfMjQ4OGY3XzYzYzhf****
对象存储官网1折活动，限时活动，即将结束，速速收藏
同尘科技为腾讯云授权服务中心。
购买腾讯云产品享受折上折，更有现金返利。同意关联立享优惠
转转请注明出处：https://www.yunxiaoer.com/145210.html
