- Product Introduction
- Purchase Guide
- Getting Started
- Console Guide
- Developer Manual
- API Documentation
- Bucket Configuration
- Image Processing
- Basic Image Processing
- Scaling
- Cropping
- Rotating
- Converting Format
- Quality Change
- Gaussian Blurring
- Adjusting Brightness
- Adjusting Contrast
- Sharpening
- Image Watermarking
- Text Watermarking
- Obtaining Basic Image Information
- Obtaining Image EXIF
- Obtaining Image’s Average Hue
- Removing Image Metadata
- Quick Thumbnail Template
- Pipeline Operators
- Limiting Output Image Size
- Supported Fonts
- Image Styles
- Persistent Image Processing
- Image Compression
- Basic Image Processing
- Error Codes
- FAQs
- Product Introduction
- Purchase Guide
- Getting Started
- Console Guide
- Developer Manual
- API Documentation
- Bucket Configuration
- Image Processing
- Basic Image Processing
- Scaling
- Cropping
- Rotating
- Converting Format
- Quality Change
- Gaussian Blurring
- Adjusting Brightness
- Adjusting Contrast
- Sharpening
- Image Watermarking
- Text Watermarking
- Obtaining Basic Image Information
- Obtaining Image EXIF
- Obtaining Image’s Average Hue
- Removing Image Metadata
- Quick Thumbnail Template
- Pipeline Operators
- Limiting Output Image Size
- Supported Fonts
- Image Styles
- Persistent Image Processing
- Image Compression
- Basic Image Processing
- Error Codes
- FAQs
Overview
CI uses the imageMogr2 API to adjust the quality of an image.
Note：This API applies only to images in JPG and WebP formats.
API Format
download_url?imageMogr2/quality/<Quality>
/rquality/<quality>
/lquality/<quality>
Parameters
Operation: quality
| Parameter | Description |
|---|---|
| download_url | URL of the input image, formatted as <bucketname-appid>.cos.<picture region="">.<domain>.com/<picture name="">Example: examplebucket-1250000000.cos.ap-shanghai.myqcloud.com/picture.jpeg |
| /quality/&dxlt;Quality> | Absolute quality of the image. Value range: 0−100. Default value: quality of the input image. The smaller value between the input image quality and the specified quality is used. If there is an exclamation mark (!) after &dxlt;Quality&dxgt; (for example, 90!), the specified quality is used. |
| /rquality/&dxlt;quality> | Relative quality of the image, relative to that of the input image. Value range: 0−100. For example, if the input image quality is 80 and rquality is set to 80, the quality of the output image is 64 (that is, 80 x 80%). |
| /lquality/&dxlt;quality> | The lowest quality of the output image. Value range: 0−100. lquality is set to 80, the quality of the output image is 85.lquality is set to 80, the quality of the output image will be improved to 80. |
| /ignore-error/1 | If this parameter is carried and the image failed to be processed because it is too large, the input image will be returned with no error reported. |
Examples
This example sets the absolute quality to 60:
http://examples-1251000004.picsh.myqcloud.com/sample.jpeg?imageMogr2/quality/60
Output image:
This example sets the relative quality to 60:
http://examples-1251000004.cos.ap-shanghai.myqcloud.com/sample.jpeg?imageMogr2/rquality/60
Output image:
Setting the relative quality to 60 with a signature carried
This example processes the image in the same way as in the example above except that a signature is carried. The signature is joined with other processing parameters using an ampersand (&):
http://examples-1251000004.cos.ap-shanghai.myqcloud.com/sample.jpeg?q-sign-algorithm=<signature>&imageMogr2/rquality/60
Note：You can obtain the value of
<signature>by referring to Request Signature.
Yes
No
Was this page helpful?