简介
本文档提供关于图片质量评估的 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。 |
