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

简介

本文档提供关于图片质量评估的 API 概览以及 SDK 示例代码。
API
说明
图片质量评估功能为同步请求方式,您可以通过本接口对图片文件进行检测,从多方面评估,最终给出综合客观的清晰度评分和主观的美观度评分。该接口属于 GET 请求。

图片质量评估

功能说明

评估图片的清晰度和主观的美观度。

方法原型

func (s *CIService) ImageQuality(ctx context.Context, obj string) (*ImageQualityResult, *Response, error)

请求示例

key := "pic/car.png"
res, _, err := c.CI.ImageQuality(context.Background(), key)

参数说明

参数名称
参数描述
key
对象键(Key)是对象在存储桶中的唯一标识。例如,在对象的访问域名examplebucket-1250000000.cos.ap-guangzhou.myqcloud.com/pic/pic.jpg中,对象键为 pic/pic.jpg。

结果说明

type ImageQualityResult struct {
XMLName xml.Name `xml:"Response"`
LongImage bool `xml:"LongImage,omitempty"`
BlackAndWhite bool `xml:"BlackAndWhite,omitempty"`
SmallImage bool `xml:"SmallImage,omitempty"`
BigImage bool `xml:"BigImage,omitempty"`
PureImage bool `xml:"PureImage,omitempty"`
ClarityScore int `xml:"ClarityScore,omitempty"`
AestheticScore int `xml:"AestheticScore,omitempty"`
RequestId string `xml:"RequestId,omitempty"`
}
参数名称
参数描述
LongImage
取值为 TRUE 或 FALSE,TRUE 为长图,FALSE 为正常图,长图定义为长宽比大于等于3或小于等于1/3的图片。
BlackAndWhite
取值为 TRUE 或 FALSE,TRUE 为黑白图,FALSE 为否。黑白图即灰度图,指红绿蓝三个通道都是以灰度色阶显示的图片,并非视觉上的“黑白图片”。
SmallImage
取值为 TRUE 或 FALSE,TRUE 为小图,FALSE 为否, 小图定义为最长边小于179像素的图片。当一张图片被判断为小图时,不建议做推荐和展示,其他字段统一输出为0或 FALSE。
BigImage
取值为 TRUE 或 FALSE,TRUE 为大图,FALSE 为否,定义为最短边大于1000像素的图片。
PureImage
取值为 TRUE 或 FALSE,TRUE 为纯色图或纯文字图,即没有内容或只有简单内容的图片,FALSE 为正常图片。
ClarityScore
综合评分。图像清晰度的得分,对图片的噪声、曝光、模糊、压缩等因素进行综合评估,取值为[0, 100],值越大,越清晰。一般大于50为较清晰图片,标准可以自行把握。
AestheticScore
综合评分。图像美观度得分,从构图、色彩等多个艺术性维度评价图片,取值为[0, 100],值越大,越美观。一般大于50为较美观图片,标准可以自行把握。
RequestId
唯一请求 ID,每次请求都会返回。定位问题时需要提供该次请求的 RequestId。