Overview

BOS photo processing is an image application service based on the core storage business of BOS, which can provide flexible, diverse and real-time image processing services. You only need to upload the original photo to BOS, and by adding processing metrics to the original image request, you can get the processing result image in real time. BOS photo processing services include image thumbnail, cutting, format conversion, rotation, text/image watermarking, etc. The processed result image will be returned in real time.

You can process photos stored in BOS through BOS console and API. Each Bucket you create in BOS has photo processing capabilities by default, and no additional activation is required.

The process of photo processing service is shown in the figure below:

• If the user sends the request processing flow for the first time:

  1. The user sends an image processing request for the first time;
  2. If the CDN fails to be chosen for the first time, the request will be sent directly to the BOS source station for processing;
  3. Process the pictures in real time according to the processing parameters sent by users;
  4. The processed result graph will be cached on the CDN node;
  5. At the same time, the result graph will be returned to users.

• If it is not the first time a user has access to the image processing process:

  1. The user sends an image processing request for the first time;
  2. If CDN is chosen, skip to step 5 directly; and if CDN is not chosen, skip to step 3;
  3. The request will be sent back to BOS, and the image will be processed in real time according to the processing parameters sent by users;
  4. The processed result graph will be cached on the CDN node;
  5. Return the result image to the client.

In terms of access speed, the photo processing service integrates the feature of Baidu AI Cloud Content Delivery Network (CDN), which can use high-quality CDN nodes around the world to accelerate the delivery of image content and effectively reduce the pressure on the origin server.

Charging Mode

Basic image processing, HEIC image compression and WebP-M6 image compression services in advanced image processing will be officially charged as of 0:00 on June 1, 2020. Currently, you can log in to the console-Finance to view usage data.

Billing item	Billing instructions
Basic image processing costs	Basic image processing costs refer to the costs incurred when performing basic image processing operations such as scaling, cutting, rotation, format conversion, progressive display, quality conversion, and watermarking of photos stored in BOS. BOS will charge based on the size of the photo before processing. BOS gives each user a free 10 TB of basic image processing ratio per month. When you process more than 10 TB of photos in a month, the excess part will be billed. This cost will be billed hourly, and, for the specific price, please refer to BOS Product Pricing
HEIC image compression cost (below 800x600)	It is the cost incurred by advanced image processing services. If you call the HEIC image compression service of BOS and the original image size is under 800x600, this cost will be incurred. This cost will be billed hourly, and, for the specific price, please refer to BOS Product Pricing
HEIC image compression cost (800x600 and above)	It is the cost incurred by advanced image processing services. If you call BOS's HEIC image compression service, and the processed original image size is above 800x600, this cost will be incurred. This cost will be billed hourly, and, for the specific price, please refer to BOS Product Pricing
WebP-M6 image compression cost (below 800x600)	It is the cost incurred by advanced image processing services. If you call BOS's WebP-M6 image compression service, and the processed original image size is below 800x600, this cost will be incurred. This cost will be billed hourly, and, for the specific price, please refer to BOS Product Pricing
WebP-M6 image compression cost (800x600 and above)	It is the cost incurred by advanced image processing services. If you call BOS's WebP-M6 image compression service, and the processed original image size is 800x600 and above, this cost will be incurred. This cost will be billed hourly, and, for the specific price, please refer to BOS Product Pricing

Image Processing Protocol

BOS image processing currently supports two versions of image processing protocol, i.e. V1.0 and V2.0. Among them, V2.0 version supports more abundant image processing items, and its command call is different from V1.0, so it is recommended that you use the V2.0 version for processing. As an old version, V1.0 will stop service in the future, but the current two versions can be used, and the system will automatically recognize and be compatible with the two protocol versions.

After you log in to the BOS console, you can switch between the two versions in the image processing tab of Bucket.

Original Protection

In some scenarios, although BOS processes the image, the customer has not publicly released the processed original image, and does not want to release the original image in the future. For such usage scenarios, BOS supports enabling original image protection for the photos in the specified Bucket to improve the security of the photos. After the original photo protection is enabled, if the image acquirer does not verify the authorized signature, he can only access the processed images through "style method"; the direct access to the original image or the access through "command method" will be denied.

If you want to enable original image protection, the owner of the photo can turn on the "Original Image Protection" switch in the "Image Processing" console.

Note: The un-retrieved Object of archive type will not trigger image processing. The retrieved archive type can be processed normally.

Operation Steps

1. Log in to Baidu AI Cloud official website

Log in to Baidu AI Cloud official website.

• If you do not register an account, you must first Register an Account for operation.
• If you have registered an account, you can directly Login.

2. Enter the BOS console

In the navigation bar on the left side of the page, select "Storage and CDN > BOS" to enter the BOS console.

3. Select Bucket and enter the image processing page

Select the Bucket name in the Bucket list on the left and enter the image processing page. On this page, you can create a new image processing style, or you can view the created image processing style in the list.

4. Adding mode

Click the Add Style button to enter the Add Style page. Regarding the style setting method of the image processing protocol V2.0, you can check Image processing protocol 2.0 ; For the style setting method of the image processing protocol V1.0, you can check Image Processing Protocol 1.0.

In the console, you can edit styles through basic editing methods and advanced editing methods. The basic editing method is to edit the style through a graphical interface, while the advanced editing method requires you to enter the corresponding command statement to set.

In basic editing, you can set style name and thumbnail settings.

You can also perform output settings and watermark settings for the image.

In advanced editing, you can set directly through the command line. Please refer to Photo Processing Service 2.0 and Image Processing Protocol 1.0 for the specific operation of the command line of the image service.

5. Add list

After the style is added, it will be displayed in the style list of image processing. You can view the command corresponding to the style through the "View Command" in the operation column, preview the style, or edit and delete the style.

Note

• The styles generated by the image processing protocol 2.0 are only displayed in the list of the new version of the protocol; the styles generated by the image processing protocol 1.0 are only displayed in the list of the old version of the protocol. The styles under the two protocols will not be displayed together, please view by switching version at the top of the page.