tencent cloud

Cloud Infinite

Release Notes and Announcements
Release Notes
Announcements
Product Introduction
Product Overview
Product Strengths
Use Cases
Feature Overview
Regions and Domains
Specifications and Limits
Billing
Billing Overview
Billing Mode
Billable Items
Free Tier
Payment Overdue
Viewing Bill Details
FAQs
Getting Started
Registering and Logging In
Bind Bucket
Uploading and Processing File
Downloading and Deleting Images
Unbinding Buckets
Using CI via COS
Features
Image Processing
Media Processing
Content Moderation
AI Content Recognition
File Processing
Smart Voice
File processing
User Guide
Overview
Bucket Management
Smart Toolbox
Job and Workflow
Data Monitoring
Usage statistics
Use Cases
Copyright Protection Solutions
Image Processing Practices
Working with API Authorization Policies
Workflow Practices
API Documentation
API Overview
Structure
Common Request Headers
Common Response Headers
Activate Vast Service
Image Processing
AI-Based Content Recognition
Smart Audio
Media Processing
Content Moderation
Document Processing
File Processing
Job and Workflow
Cloud Virus Detection
Error Codes
Request Signature
SDK Documentation
SDK Overview
Android SDK
iOS SDK
COS Android SDK
C SDK
C++ SDK
.NET(C#) SDK
Go SDK
COS iOS SDK
Java SDK
JavaScript SDK
Node.js SDK
PHP SDK
Python SDK
Mini Program SDK
Personal Information Protection Policy for SDK
Security and Compliance
Permission ‍Management
FAQs
Basic Settings
Document Processing
Media Processing
Content Recognition
Smart Audio
Agreements
Service Level Agreement
Contact Us
Glossary
ドキュメントCloud InfiniteAPI DocumentationImage ProcessingBasic Image ProcessingObtaining Basic Image Information

Obtaining Basic Image Information

PDF
フォーカスモード
フォントサイズ
最終更新日: 2025-07-16 18:01:54

Overview

CI uses the imageInfo API to query an image’s basic information such as its format, width, and height.

Use Limits

The input image cannot be larger than 32 MB.
The width and height of the input image cannot exceed 30,000 pixels and the total number of pixels cannot exceed 250 million. The width and height of the output image cannot exceed 9,999 pixels.
For an input animated image, the total number of pixels (Width x Height x Number of frames) cannot exceed 250 million pixels.

API Format

download_url?imageInfo

Parameters

Request parameters

Operation: imageInfo
Parameter
Description
download_url
URL of the input image, formatted as <BucketName-APPID>.cos.<Region>.myqcloud.com/<picture name>
Example: examplebucket-1250000000.cos.ap-shanghai.myqcloud.com/picture.jpeg

Response parameters

Parameter
Description
format
Image format such as png or gif
width
Width of the image, in pixels
height
Height of the image, in pixels
size
Image size, in bytes
md5
MD5 checksum of the image
frame_count
Number of frames. For static images, this value is 1.

Examples

Example 1: public-read

Request

http://examples-1251000004.cos.ap-shanghai.myqcloud.com/sample.jpeg?imageInfo

Response

{"format": "jpeg", "width": "960", "height": "540", "size": "158421", "md5": "77a16fa70e2eba652fb42e8a639c52f2", "photo_rgb": "0x736246"}

Example 2: private-read with a signature carried

This example obtains the average hue in the same way as in the example above except that a signature is carried. The signature is joined with other parameters using an ampersand (&):
http://examples-1251000004.cos.ap-shanghai.myqcloud.com/sample.jpeg?q-sign-algorithm=<signature>&imageInfo
Note:
You can obtain the value of <signature> by referring to Request Signature.

Notes

To prevent unauthorized users from accessing or downloading the input image by using a URL that does not contain any processing parameter, you can add the processing parameters to the request signature, making the processing parameters the key of the parameter with the value left empty. The following is a simple example for your reference (it might have expired or become inaccessible). For more information, please see Request Signature.
http://examples-1251000004.cos.ap-shanghai.myqcloud.com/sample.jpeg?q-sign-algorithm=sha1&q-ak=AKID********************&q-sign-time=1593342360;1593342720&q-key-time=1593342360;1593342720&q-header-list=&q-url-param-list=watermark%252f1%252fimage%252fahr0cdovl2v4yw1wbgvzlteyntewmdawmdqucgljc2gubxlxy2xvdwquy29tl3nodwl5aw4uanbn%252fgravity%252fsoutheast&q-signature=26a429871963375c88081ef60247c5746e834a98&watermark/1/image/aHR0cDovL2V4YW1wbGVzLTEyNTEwMDAwMDQucGljc2gubXlxY2xvdWQuY29tL3NodWl5aW4uanBn/gravity/southeast

前の記事へ: Grayscale Image次の記事へ: Obtaining Image EXIF

ヘルプとサポート

この記事はお役に立ちましたか？

フィードバック