tencent cloud

Cloud Object Storage

Release Notes and Announcements
Release Notes
Announcements
Product Introduction
Overview
Features
Use Cases
Strengths
Concepts
Regions and Access Endpoints
Specifications and Limits
Service Regions and Service Providers
Billing
Billing Overview
Billing Method
Billable Items
Free Tier
Billing Examples
Viewing and Downloading Bill
Payment Overdue
FAQs
Getting Started
Console
Getting Started with COSBrowser
User Guide
Creating Request
Bucket
Object
Data Management
Batch Operation
Global Acceleration
Monitoring and Alarms
Operations Center
Data Processing
Content Moderation
Smart Toolbox
Data Processing Workflow
Application Integration
User Tools
Tool Overview
Installation and Configuration of Environment
COSBrowser
COSCLI (Beta)
COSCMD
COS Migration
FTP Server
Hadoop
COSDistCp
HDFS TO COS
GooseFS-Lite
Online Tools
Diagnostic Tool
Use Cases
Overview
Access Control and Permission Management
Performance Optimization
Accessing COS with AWS S3 SDK
Data Disaster Recovery and Backup
Domain Name Management Practice
Image Processing
Audio/Video Practices
Workflow
Direct Data Upload
Content Moderation
Data Security
Data Verification
Big Data Practice
COS Cost Optimization Solutions
Using COS in the Third-party Applications
Migration Guide
Migrating Local Data to COS
Migrating Data from Third-Party Cloud Storage Service to COS
Migrating Data from URL to COS
Migrating Data Within COS
Migrating Data Between HDFS and COS
Data Lake Storage
Cloud Native Datalake Storage
Metadata Accelerator
GooseFS
Data Processing
Data Processing Overview
Image Processing
Media Processing
Content Moderation
File Processing Service
File Preview
Troubleshooting
Obtaining RequestId
Slow Upload over Public Network
403 Error for COS Access
Resource Access Error
POST Object Common Exceptions
API Documentation
Introduction
Common Request Headers
Common Response Headers
Error Codes
Request Signature
Action List
Service APIs
Bucket APIs
Object APIs
Batch Operation APIs
Data Processing APIs
Job and Workflow
Content Moderation APIs
Cloud Antivirus API
SDK Documentation
SDK Overview
Preparations
Android SDK
C SDK
C++ SDK
.NET(C#) SDK
Flutter SDK
Go SDK
iOS SDK
Java SDK
JavaScript SDK
Node.js SDK
PHP SDK
Python SDK
React Native SDK
Mini Program SDK
Error Codes
Harmony SDK
Endpoint SDK Quality Optimization
Security and Compliance
Data Disaster Recovery
Data Security
Cloud Access Management
FAQs
Popular Questions
General
Billing
Domain Name Compliance Issues
Bucket Configuration
Domain Names and CDN
Object Operations
Logging and Monitoring
Permission Management
Data Processing
Data Security
Pre-signed URL Issues
SDKs
Tools
APIs
Agreements
Service Level Agreement
Privacy Policy
Data Processing And Security Agreement
Contact Us
Glossary
DocumentationCloud Object StorageAPI DocumentationData Processing APIsAI-Based Content RecognitionImage Quality Score

Image Quality Score

PDF
Focus Mode
Font Size
Last updated: 2026-01-09 22:04:30

Feature Description

The image quality scoring function uses a synchronous request method. You can detect image files through this interface, evaluate them from multiple aspects, and finally provide a comprehensive and objective clarity score along with a subjective aesthetic score.
Note:
This interface is a GET request, uses synchronous request method, and requires carrying a signature. For specific signature settings, please see Request Signature.
Archived storage type and deep archive storage type images on COS do not support processing. If you need to process such images, please first restore archived file.

Authorization Description

When used by a sub-account, you need to add ci:CreateAssessQualityJob to the action in the authorization policy. For all operation APIs supported by Cloud Infinite, please see Cloud Infinite action.

Service Activation

Using this feature requires enabling Cloud Infinite in advance and binding a bucket. For details, see Bind Bucket.
Using this feature requires enabling the AI Content Recognition Service in advance through Console Guide > Media Processing or the API to enable the AI Content Recognition Service.

Use Limits

When using this API, please first confirm the relevant restrictions. For details, see Usage Limits.
Supported image formats: PNG, JPG, JPEG.
Image size: The downloaded image after Base64 encoding must not exceed 4MB.
Image pixels: It is advisable to be larger than 50*50 pixels; otherwise, it will affect the recognition effect.
Aspect ratio: It is recommended that the ratio of the longer side to the shorter side be less than 5:1.

Fee Description

A successful API call incurs image quality assessment fees and COS read request fees.
If the image belongs to the low-frequency storage type on COS, a successful API call will incur COS low-frequency data retrieval fees.


Request

Request sample

GET /<ObjectKey>?ci-process=AssessQuality HTTP/1.1
Host: <BucketName-APPID>.cos.<Region>.myqcloud.com
Date: <GMT Date>
Authorization: <Auth String>
Note:
Authorization: Auth String. For details, see Request Signature document.

Request parameters

Parameter Name
Description
Type
Required or Not
ObjectKey
object filename, for example: folder/document.jpg.
String
Yes
ci-process
Cloud Infinite processing capability Image quality detection fixed as AssessQuality
String
Yes

Request header

This API only uses common request headers. For details, see Common Request Headers documentation.

Request body

The request does not have a request body.

Response

Response Headers

This API only returns the public response header. For details, see Common Response Headers documentation.

Response Body

The response body is returned as application/xml. An example including the complete node data is shown below:
<Response>
  <LongImage>FALSE</LongImage>
  <BlackAndWhite>FALSE</BlackAndWhite>
  <SmallImage>FALSE</SmallImage>
  <BigImage>TRUE</BigImage>
  <PureImage>FALSE</PureImage>
  <ClarityScore>89</ClarityScore>
  <AestheticScore>70</AestheticScore>
  <LowQualityScore>40</LowQualityScore>
  <RequestId></RequestId>
</Response>
The data are as follows:
Node Name (Keyword)
Parent Node
Description
Type
Response
None.
Container for saving results.
Container
The content of Response
Parameter Name
Description
Type
LongImage
Value is TRUE or FALSE. TRUE indicates a long image, FALSE indicates a normal image. A long image is defined as an image with an aspect ratio greater than or equal to 3 or less than or equal to 1/3.
Boolean
BlackAndWhite
Value is TRUE or FALSE. TRUE indicates a black and white image, FALSE indicates otherwise. A black and white image, which is a grayscale image, refers to an image where the red, green, and blue channels are displayed in grayscale. It is not a visual "black and white picture."
Boolean
SmallImage
Value is TRUE or FALSE. TRUE indicates a small image, FALSE indicates otherwise. A small image is defined as an image with a long side less than 179 pixels. When an image is judged as a small image, it is not recommended for recommendation and display. Other fields are uniformly output as 0 or FALSE.
Boolean
BigImage
Value is TRUE or FALSE. TRUE indicates a large image, FALSE indicates otherwise. Defined as an image with the shortest side greater than 1000 pixels.
Boolean
PureImage
Value is TRUE or FALSE. TRUE indicates a solid color image or plain text image, i.e., an image with no content or only simple content. FALSE indicates a normal image.
Boolean
ClarityScore
Image clarity score. A comprehensive evaluation is performed on factors such as noise, exposure, blur, and compression of an image. The value ranges from [0, 100]. The higher the value, the clearer the image. Generally, a value greater than 50 indicates a relatively clear image. The standard can be determined on one's own.
Integer
AestheticScore
Image aesthetics score. The image is evaluated from multiple artistic dimensions such as composition and color. The value ranges from [0, 100]. The higher the value, the more beautiful the image. Generally, a value greater than 50 indicates a relatively beautiful image. The standard can be determined on one's own.
Integer
LowQualityScore
Image content quality score. The content quality of an image is evaluated from multiple aspects such as background and image content. The value ranges from [0, 100]. The higher the value, the better the content quality. Generally, a value greater than 50 indicates relatively good content quality. The standard can be determined on one's own.
Integer
RequestId
Unique request ID, returned for each request. RequestId is required for locating a problem.
String

Error Codes

This request returns common error responses and error codes. For more information, see Error Codes.

Examples

Request

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=**********************************&q-sign-time=1497530202;1497610202&q-key-time=1497530202;1497610202&q-header-list=&q-url-param-list=&q-signature=**************************************

Response

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>
  <LowQualityScore>40</LowQualityScore>
  <RequestId>NTk0MjdmODlfMjQ4OGY3XzYzYzhf****</RequestId>
</Response>

Previous Topic: Game Scene RecognitionNext Topic: Intelligent Human Face Beauty Feature

Help and Support

Was this page helpful?

Help us improve! Rate your documentation experience in 5 mins.

Feedback