Intelligent Media Management (IMM) capabilities are integrated into Object Storage Service (OSS), allowing you to utilize various data processing and analysis features of IMM within OSS. This topic describes how to use the x-oss-process capability of OSS to access IMM features.
Prerequisites
IMM is available in the region where the OSS bucket is located. For more information about regions in which IMM is available, see Endpoints.
NoteYou can access features of the new version in all supported regions by using the API and SDKs. Access to features of the new version from the console is in phased testing and available only in Germany (Frankfurt) and China (Qingdao).
IMM is activated. For more information, see Activate IMM.
Billing
You are charged for using IMM. For more information, see Billing overview.
Procedure
Step 1: Create an IMM project
Log on to the IMM Console.
In the lower part of the left-side navigation pane, click Try New Version. If Switch to Old Version is displayed in the lower part of the navigation pane, skip this step.
In the left-side navigation pane, click Project List.
Click Create Project. For more information, see Create a project.
Step 2: Bind an OSS bucket
You can call the AttachOSSBucket operation to bind the project to an OSS bucket. In this example, the operation is called in OpenAPI Explorer to bind the project to an OSS bucket.
Log on to OpenAPI Explorer. In the upper-left corner of the page, select the IMM API version and region.
You can bind the project only to an OSS bucket in the same region.
On the Parameters tab, enter the name of the project in the ProjectName field and the name of the bucket in the OSSBucket field, and click Initiate Call.
View the response of the call on the Response tab on the right side of the page.
Step 3: Grant permissions
For more information about permissions, see Permissions.
Permission configurations are required only for a RAM user or RAM role. If you are using an Alibaba Cloud account, skip this step.
Step 4: Apply for a quota
Log on to the OSS console.
In the left-side navigation pane, click Self-service Tools.
Click More Tools.
From the drop-down list, select the OSS bucket.
Click Apply for Quota next to Use GET Method to Use Data Processing Capabilities of New IMM Version and Use POST Method to Use Data Processing Capabilities of New IMM Version.
Wait for approval.
Features supported by the x-oss-process capability
Anonymous access is not supported. For more information about how to generate signed URLs for access, see sign.
Media processing
For more information, see Media processing.
Feature | Parameter | Description |
video/convert | Convert a video object in OSS to the required format. | |
video/animation | Convert a video object in OSS to animated image formats, such as GIF and WebP. | |
video/sprite | Create a sprite in the specified format from frames of a video object in OSS. | |
video/snapshots | Capture frames from a video object in OSS and convert them to the specified format. | |
video/concat | Merge multiple video objects in OSS into a single video in the specified format. | |
audio/convert | Convert an audio object in OSS to the specified format. | |
audio/concat | Merge multiple audio objects in OSS into a single audio in the specified format. | |
audio/info | Extract the media format information and media stream information of an audio object in OSS. | |
video/info | Extract the media format information and media stream information of a video object in OSS. |
Document processing
For more information, see Document processing and Intelligent document processing.
Feature | Parameter | Description |
doc/preview | Preview a document in OSS online. | |
doc/edit | Collaboratively edit a document in OSS online. | |
doc/convert | Capture a snapshot of a document in OSS online. | |
doc/convert | Convert the format of a document in OSS online. | |
| Translate text into multiple languages, such as Chinese and English. | |
| Polish a document. | |
| Generate a brief summary of a document. | |
| Generate coherent and logically consistent follow-up content based on conditions such as the existing text, subject, and style. | |
| Optimize the comprehensive expression and style of existing documents. | |
| Adjust the tone of a document and improve the expressions. |
Image intelligence
For more information, see Image intelligence.
Feature | Parameter | Description |
image/faces | Detect multiple faces and analyze face information in an image. | |
image/bodies | Detect the positions of human bodies in an image. | |
image/cars | Detect the vehicle information and license plate information in an image. | |
image/codes | Detect the QR code information in an image. | |
image/labels | Detect image content, such as scenes, objects, and events. | |
image/score | Assess the visual quality of an image based on aesthetics, such as color and saturation of the image. | |
image/blindwatermark | Add blind watermarks to an image. | |
image/deblindwatermark | Parse blind watermarks in an image. |