Image Processing supports one-click activation of various self-adaptive processing features, such as automatic image quality slimming, adaptive format compression, and auto image correction. It also supports specifying width, height, and format conversion through parameter suffixes. The process of processing, caching and responding is taken place on EdgeOne servers. Your own origin only needs to store the original images, thus reducing image management costs on your side. EdgeOne can also compress images to improve page load speed without sacrificing visual impact.
Applicable Scenarios
The following table lists common use cases for Image Processing. Many scenarios are applicable, not limited to those listed.
Applicable Scenarios
Overview
E-commerce platform
Multiple image processing styles meet multi-terminal image display scenarios, making image editing more convenient.
Compress product images and image comments, reduce image quality to save traffic.
social app
Simple, flexible editing methods meet social image standards and image processing needs.
Support auto image rotation adjustment to enhance UGC scenario image content display.
Online Education
Simple, flexible editing methods meet standard image processing needs for courseware images in online education.
Based on different scenario needs, you can be used to balance compression benefit and visual experience.
Image slimming optimization, intelligent format compression, and automatic rotation adjustment features may cause a hit rate decline in a short time when enabled with one click. Not recommended to enable during peak business periods.
When image slimming optimization and intelligent format compression are enabled at the same time, the system will perform priority execution of intelligent format compression (convert images to the adapted format), then perform optimized processing for slimming based on the set parameters.
Image Slimming Optimizer
Suitable for most image distribution optimization scenarios. It supports automatic compression of file size when accessing images without changing resolution, dimension, or format, effectively improving loading speed with almost unaffected video quality and reduced distribution cost. Enable with one click—no modification required to business URL parameters. The automatic quality range is 1%-99%, with a default value of 75, representing 75% retention of original image quality.
Usage
1. Log in to the Tencent Cloud EdgeOne console, enter Service Overview in the left menu bar, and click the site to be configured under Website Security Acceleration.
2. On the site details page, click Multimedia Service > Image Processing to enter the image processing webpage.
3. Click Edit to modify the percentage of quality slim. If no modification is made, the feature enablement will compress with a default value of 75%.
4. Click the Image Slimming Optimizerswitch to get started.
Smart Format Compression
Advanced image volume compression feature. Once enabled, it automatically converts images to Webp or AVIF format based on configuration, thereby significantly improving image loading speed and reducing distribution cost. Supports one-click enable with no modification required to business URL parameters. If the same image format matches multiple enabled image adaptability features, they take effect in priority sequence from high to low: AVIF > Webp. Different compression features vary in compatibility with existing image formats and browser environments. See the table below:
Feature
Browsers and Systems Supporting Preview
Compatibility
Compression Effect
Supported Format
AVIF compression
It supports most browsers such as Firefox, Chrome, and Android.
It supports iOS 16 and later, and Android 12 and later.
Support WeChat mini program.
Strong
Extremely strong
Supports file formats including jpg, jpeg, bmp, gif, png, and webp.
WebP compression
Supports almost ALL mainstream browsers.
It supports iOS 14 and later, and Android 4.0 and later.
Support WeChat mini program.
Extremely strong
Medium
Usage
1. Log in to the Tencent Cloud EdgeOne console, enter Service Overview in the left menu bar, and click the site to be configured under Website Security Acceleration.
2. On the site details page, click Multimedia Service > Image Processing to enter the image processing webpage.
3. Click Edit to modify the output format range for format compression. Default value is Adaptive AVIF and Adaptive WebP.
4. Click the Smart Format Compressionswitch to get started.
Auto Rotation Correction
Suitable for UGC scenarios such as community forums and ecommerce platforms, where uploaded images may contain rotation parameters. When automatic rotation is enabled, EdgeOne Image Service parses the rotation information in EXIF metadata and automatically adjusts image orientation without requiring URL parameter modifications, ensuring correct display for end users.
Usage
1. Log in to the Tencent Cloud EdgeOne console, enter Service Overview in the left menu bar, and click the site to be configured under Website Security Acceleration.
2. On the site details page, click Multimedia Service > Image Processing to enter the image processing webpage.
3. Click the Auto Rotation Correctionswitch to get started.
Custom Parameter Processing
Suitable for scenarios requiring specifying image scaling dimensions and format conversion. Support through concatenating parameter suffix after the business URL for quick processing of specified scaling dimensions and format. Support parameters as follows:
Scaling Dimensions
Capability
Parameter Name
Parameter Value（type/pixel）
Description
Scaling dimensions
eo-img.resize
w/<Width>,for example：w/100
Specify width, height adaptive
h/<Height>,for example：h/100
Specify height, width adaptive
w/<Width>/h/<Height>,for example：w/100/h/100
Specify width and height
l/<Long>,for example：l/100
Specify long side, short side adaptive
s/<Short>,for example：s/100
Specify short side, long side adaptive
Format Conversion
Support converting the original image to the specified format by carrying the specified parameter
Static：jpg、png、bmp、jp2、jxr（take the first frame of gif animation as a single static image）
Dynamic：gif、webp、avif、heif
Usage
You can add image processing parameters to the client request URL to resize images.
1. Log in to the EdgeOne console, enter Service Overview in the left menu bar, and click the site to be configured under Website Security Acceleration.
2. On the site details page, click Multimedia Services > Image Processing to go to the image processing page.
3. Click Custom Parameter Processing > Switch to start using it.
4. After enabled, you only need to pass the image scaling demand by concatenating the eo-img related parameter to the Request URL in the Client requests. EdgeOne will automatically complete the image processing based on the image processing parameter in the Request URL. For example: https://www.example.com/foo.png?eo-img.resize=w/100。
Image Processing Example
In the following examples, the original image is 500 × 280 pixels in resolution and 500 KB in size.
1. Resize the image width to 200 pixels and scale the height automatically:
The original image size for processing should not exceed 32MB.
The width and height of the input original image should not exceed 30,000 pixels, and the total pixels should not exceed 250 million pixels; for dynamic images, the width x height x frame count of the original image should not exceed 250 million pixels.
The input gif format animation frame count should not exceed 300 frames.
The width and height settings of the output image should not exceed 9999 pixels.
Note：
Any of the following situations may cause the image processing to fail and return the original image:
1. If any parameter of the original image and the result image for image processing exceeds the above limits, we will not be able to process the image and can only respond with the original image.
2. If incorrect request parameters are entered, the image will not be processed and will be returned directly as the original image, such as the following situations:
Duplicate input parameters: eo-img.resize=w/100&eo-img.resize=w/200, which will be considered as illegal parameter passing;
pelling error: any format error or spelling error parameter, such as eo-img.resize=w=100, will be considered as illegal parameter passing;
Resize parameter error: the parameters w/ (width) and h/ (height) should not be mixed with s/ (short side) and l/ (long side). For example, w/300/s/200 is illegal parameter passing, and the image will remain unchanged.
3. If the image custom parameter processing function is turned off within the console, all eo-img related parameters will be treated as normal query strings and will not trigger the image processing function.
4. If other exceptions occur that prevent normal image processing, we will prioritize providing the original image, and in subsequent requests, we will automatically try to reprocess the image.
