@alicloud/aidge20260428 5.12.1 → 5.12.2

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -2,7 +2,7 @@ import * as $dara from '@darabonba/typescript';
2
2
  export declare class VisionFlowResponseBodyData extends $dara.Model {
3
3
  /**
4
4
  * @remarks
5
- * The asynchronous task ID, used to query processing results later through QueryAsyncTaskResult.
5
+ * The ID of the asynchronous task, which is used to query the processing result by calling QueryAsyncTaskResult.
6
6
  *
7
7
  * @example
8
8
  * e4c48e88-3c34-91e3-ab8a-08484dc4d402
@@ -22,7 +22,7 @@ export declare class VisionFlowResponseBodyData extends $dara.Model {
22
22
  export declare class VisionFlowResponseBody extends $dara.Model {
23
23
  /**
24
24
  * @remarks
25
- * The status code. The value "success" is returned for a successful call.
25
+ * The status code. If the call is successful, "success" is returned.
26
26
  *
27
27
  * @example
28
28
  * success
@@ -30,12 +30,12 @@ export declare class VisionFlowResponseBody extends $dara.Model {
30
30
  code?: string;
31
31
  /**
32
32
  * @remarks
33
- * The asynchronous task submit status data, which contains the asynchronous task ID.
33
+ * The submission result data of the asynchronous task, which includes the asynchronous task ID.
34
34
  */
35
35
  data?: VisionFlowResponseBodyData;
36
36
  /**
37
37
  * @remarks
38
- * The error message. The value "Success" is returned for a successful call.
38
+ * The error message. If the call is successful, "Success" is returned.
39
39
  *
40
40
  * @example
41
41
  * Success
@@ -43,7 +43,7 @@ export declare class VisionFlowResponseBody extends $dara.Model {
43
43
  message?: string;
44
44
  /**
45
45
  * @remarks
46
- * The request ID, used to uniquely identify a single request.
46
+ * The request ID, which is used to identify a unique request.
47
47
  *
48
48
  * @example
49
49
  * F3E65785-0180-1227-91B0-2F5F52F679FB
@@ -51,7 +51,7 @@ export declare class VisionFlowResponseBody extends $dara.Model {
51
51
  requestId?: string;
52
52
  /**
53
53
  * @remarks
54
- * Indicates whether the call is successful. A value of true indicates success. A value of false indicates failure.
54
+ * Indicates whether the call is successful. A value of true indicates success, and a value of false indicates failure.
55
55
  *
56
56
  * @example
57
57
  * true
@@ -2,7 +2,7 @@ import * as $dara from '@darabonba/typescript';
2
2
  export declare class VisionFlowShrinkRequest extends $dara.Model {
3
3
  /**
4
4
  * @remarks
5
- * The AI capabilities to apply (1 = Intelligent Element Detection, 2 = Intelligent Matting, 3 = Intelligent Removal, 4 = Image Translation Pro, 5 = Intelligent Cropping, 6 = HD Upscaling). Multiple selections allowed.
5
+ * The AI capabilities to be processed. Multiple values are supported. Valid values: 1 (Intelligent element recognition), 2 (Intelligent cutout), 3 (Intelligent erasure), 4 (Image translation Pro), 5 (Intelligent cropping), and 6 (High-definition upscaling).
6
6
  *
7
7
  * This parameter is required.
8
8
  *
@@ -12,7 +12,7 @@ export declare class VisionFlowShrinkRequest extends $dara.Model {
12
12
  abilityShrink?: string;
13
13
  /**
14
14
  * @remarks
15
- * The background type of the output image. Valid values: WHITE_BACKGROUND (white background) and TRANSPARENT (transparent background). This parameter is required when the Intelligent Matting capability is selected.
15
+ * The background type of the returned image. Valid values: WHITE_BACKGROUND (White background image) and TRANSPARENT (Transparent background image). Required when the intelligent cutout capability is selected.
16
16
  *
17
17
  * @example
18
18
  * WHITE_BACKGROUND
@@ -20,7 +20,7 @@ export declare class VisionFlowShrinkRequest extends $dara.Model {
20
20
  backGroundType?: string;
21
21
  /**
22
22
  * @remarks
23
- * The glossary ID. Optional. Create a glossary separately in the console and provide its ID. If left empty, translation results are not modified.
23
+ * The ID of the intervention glossary. Optional. You must create the glossary in the console and provide its ID. If this parameter is left empty, the translation results are not modified.
24
24
  *
25
25
  * @example
26
26
  * glossary_1
@@ -28,7 +28,7 @@ export declare class VisionFlowShrinkRequest extends $dara.Model {
28
28
  glossary?: string;
29
29
  /**
30
30
  * @remarks
31
- * The URL of the image to process. This parameter is required. Resolution must be greater than 256 × 256, long side no greater than 1920 pixels, short side no greater than 1080 pixels. Maximum size: 5 MB. Supported formats: png, jpeg, jpg, bmp, and webp.
31
+ * The URL of the image to be processed. Required. The resolution must be greater than 256×256, the long side must not exceed 1920 pixels, and the short side must not exceed 1080 pixels. The size must not exceed 5 MB. Supported formats include PNG, JPEG, JPG, BMP, and WEBP.
32
32
  *
33
33
  * This parameter is required.
34
34
  *
@@ -38,7 +38,7 @@ export declare class VisionFlowShrinkRequest extends $dara.Model {
38
38
  imageUrl?: string;
39
39
  /**
40
40
  * @remarks
41
- * Specifies whether to translate text on the image subject. Optional. Default value: false. Helps protect embedded information such as product names from being translated.
41
+ * Specifies whether to translate text on the image subject. Optional. Default value: false. This parameter helps protect embedded information such as product names from being translated.
42
42
  *
43
43
  * @example
44
44
  * false
@@ -46,7 +46,7 @@ export declare class VisionFlowShrinkRequest extends $dara.Model {
46
46
  includingProductArea?: boolean;
47
47
  /**
48
48
  * @remarks
49
- * Specifies whether images with the detected elements proceed to subsequent processing. A value of true indicates that images containing the elements proceed to subsequent processing. A value of false indicates that they do not. This parameter is required when the Intelligent Element Detection capability is selected.
49
+ * Specifies whether to include images with the specified elements in subsequent processing. A value of true indicates that images with the elements are included in subsequent processing. A value of false indicates that images with the elements are not included. Required when the intelligent element recognition capability is selected.
50
50
  *
51
51
  * @example
52
52
  * true
@@ -54,7 +54,7 @@ export declare class VisionFlowShrinkRequest extends $dara.Model {
54
54
  isFilter?: boolean;
55
55
  /**
56
56
  * @remarks
57
- * The specific removal region in RLE format. Optional. If provided, this parameter takes priority and the ObjectRemoveElements and NonobjectRemoveElements parameters are ignored.
57
+ * The specific erasure area in Run-Length Encoding (RLE) format. Optional. If this parameter is specified, it takes precedence and the ObjectRemoveElements and NonobjectRemoveElements parameters are ignored.
58
58
  *
59
59
  * @example
60
60
  * 474556 160 475356 160
@@ -62,7 +62,7 @@ export declare class VisionFlowShrinkRequest extends $dara.Model {
62
62
  mask?: string;
63
63
  /**
64
64
  * @remarks
65
- * The elements to detect on the non-subject area of the image (1 = Watermark, 2 = Logo, 3 = Text, 4 = Text-bearing color block). Multiple selections allowed. When the Intelligent Element Detection capability is selected, at least one of NonobjectDetectElements or ObjectDetectElements is required.
65
+ * The elements to detect on the non-subject area of the image. Multiple values are supported. Valid values: 1 (Watermark), 2 (Logo), 3 (Text), and 4 (Text block). When the intelligent element recognition capability is selected, at least one of this parameter and ObjectDetectElements must be specified.
66
66
  *
67
67
  * @example
68
68
  * [1,2,3]
@@ -70,7 +70,7 @@ export declare class VisionFlowShrinkRequest extends $dara.Model {
70
70
  nonobjectDetectElementsShrink?: string;
71
71
  /**
72
72
  * @remarks
73
- * The elements to remove from the non-subject area of the image (1 = Transparent text block, 2 = Specific name, 3 = Text, 4 = Overlay patch). Multiple selections allowed. When the Intelligent Removal capability is selected, at least one of NonobjectRemoveElements or ObjectRemoveElements is required.
73
+ * The elements to remove from the non-subject area of the image. Multiple values are supported. Valid values: 1 (Transparent text block), 2 (Specific name), 3 (Text), and 4 (Cluttered text). When the intelligent erasure capability is selected, at least one of this parameter and ObjectRemoveElements must be specified.
74
74
  *
75
75
  * @example
76
76
  * [1,2,4]
@@ -78,7 +78,7 @@ export declare class VisionFlowShrinkRequest extends $dara.Model {
78
78
  nonobjectRemoveElementsShrink?: string;
79
79
  /**
80
80
  * @remarks
81
- * The elements to detect on the image subject (1 = Watermark, 2 = Logo, 3 = Text, 4 = Text-bearing color block). Multiple selections allowed. When the Intelligent Element Detection capability is selected, at least one of ObjectDetectElements or NonobjectDetectElements is required.
81
+ * The elements to detect on the image subject. Multiple values are supported. Valid values: 1 (Watermark), 2 (Logo), 3 (Text), and 4 (Text block). When the intelligent element recognition capability is selected, at least one of this parameter and NonobjectDetectElements must be specified.
82
82
  *
83
83
  * @example
84
84
  * [1,2,3,4]
@@ -86,7 +86,7 @@ export declare class VisionFlowShrinkRequest extends $dara.Model {
86
86
  objectDetectElementsShrink?: string;
87
87
  /**
88
88
  * @remarks
89
- * The elements to remove from the image subject (1 = Transparent text block, 2 = Specific name, 3 = Text, 4 = Overlay patch). Multiple selections allowed. When the Intelligent Removal capability is selected, at least one of ObjectRemoveElements or NonobjectRemoveElements is required.
89
+ * The elements to remove from the image subject. Multiple values are supported. Valid values: 1 (Transparent text block), 2 (Specific name), 3 (Text), and 4 (Cluttered text). When the intelligent erasure capability is selected, at least one of this parameter and NonobjectRemoveElements must be specified.
90
90
  *
91
91
  * @example
92
92
  * [1,2,4]
@@ -94,7 +94,7 @@ export declare class VisionFlowShrinkRequest extends $dara.Model {
94
94
  objectRemoveElementsShrink?: string;
95
95
  /**
96
96
  * @remarks
97
- * The source language code. Optional. For supported language pairs, refer to the supported translation language pairs list.
97
+ * The source language code. Optional. For supported language pairs, see the list of supported translation languages.
98
98
  *
99
99
  * @example
100
100
  * zh
@@ -102,7 +102,7 @@ export declare class VisionFlowShrinkRequest extends $dara.Model {
102
102
  sourceLanguage?: string;
103
103
  /**
104
104
  * @remarks
105
- * The desired height of the cropped image, in pixels. Valid values: 100 to 5000. This parameter is required when the Intelligent Cropping capability is selected.
105
+ * The expected height of the cropped image, in pixels. Valid values: 100 to 5000. Required when the intelligent cropping capability is selected.
106
106
  *
107
107
  * @example
108
108
  * 800
@@ -110,7 +110,7 @@ export declare class VisionFlowShrinkRequest extends $dara.Model {
110
110
  targetHeight?: number;
111
111
  /**
112
112
  * @remarks
113
- * The target language code. Optional. For supported language pairs, refer to the supported translation language pairs list.
113
+ * The target language code. Optional. For supported language pairs, see the list of supported translation languages.
114
114
  *
115
115
  * @example
116
116
  * en
@@ -118,7 +118,7 @@ export declare class VisionFlowShrinkRequest extends $dara.Model {
118
118
  targetLanguage?: string;
119
119
  /**
120
120
  * @remarks
121
- * The desired width of the cropped image, in pixels. Valid values: 100 to 5000. This parameter is required when the Intelligent Cropping capability is selected.
121
+ * The expected width of the cropped image, in pixels. Valid values: 100 to 5000. Required when the intelligent cropping capability is selected.
122
122
  *
123
123
  * @example
124
124
  * 800
@@ -126,7 +126,7 @@ export declare class VisionFlowShrinkRequest extends $dara.Model {
126
126
  targetWidth?: number;
127
127
  /**
128
128
  * @remarks
129
- * Specifies whether to translate brand names in the image. Optional. Default value: false. Helps protect brand name information from being translated.
129
+ * Specifies whether to translate brand names in the image. Optional. Default value: false. This parameter helps protect brand name information from being translated.
130
130
  *
131
131
  * @example
132
132
  * false
@@ -134,7 +134,7 @@ export declare class VisionFlowShrinkRequest extends $dara.Model {
134
134
  translatingBrandInTheProduct?: boolean;
135
135
  /**
136
136
  * @remarks
137
- * The image upscaling factor. Optional. Default value: 2. Valid values: 2 to 4. This parameter is required when the HD Upscaling capability is selected.
137
+ * The image upscaling factor. Optional. Default value: 2. Valid values: 2 to 4. Required when the high-definition upscaling capability is selected.
138
138
  *
139
139
  * @example
140
140
  * 2
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@alicloud/aidge20260428",
3
- "version": "5.12.1",
3
+ "version": "5.12.2",
4
4
  "description": "",
5
5
  "main": "dist/client.js",
6
6
  "scripts": {
@@ -20,6 +20,7 @@
20
20
  },
21
21
  "dependencies": {
22
22
  "@darabonba/typescript": "^1.0.0",
23
+ "@alicloud/gateway-pop": "^0.0.8",
23
24
  "@alicloud/openapi-core": "^1.0.8"
24
25
  },
25
26
  "files": [
package/src/client.ts CHANGED
@@ -1,5 +1,6 @@
1
1
  // This file is auto-generated, don't edit it
2
2
  import * as $dara from '@darabonba/typescript';
3
+ import GatewayClient from '@alicloud/gateway-pop';
3
4
  import OpenApi from '@alicloud/openapi-core';
4
5
  import { OpenApiUtil, $OpenApiUtil }from '@alicloud/openapi-core';
5
6
 
@@ -11,6 +12,9 @@ export default class Client extends OpenApi {
11
12
 
12
13
  constructor(config: $OpenApiUtil.Config) {
13
14
  super(config);
15
+ this._productId = "Aidge";
16
+ let gatewayClient = new GatewayClient();
17
+ this._spi = gatewayClient;
14
18
  this._endpointRule = "regional";
15
19
  this.checkConfig(config);
16
20
  this._endpoint = this.getEndpoint("aidge", this._regionId, this._endpointRule, this._network, this._suffix, this._endpointMap, this._endpoint);
@@ -6074,61 +6078,61 @@ export default class Client extends OpenApi {
6074
6078
  }
6075
6079
 
6076
6080
  /**
6077
- * Provides a one-stop AI-powered image processing service for e-commerce sellers. Orchestrates seven atomic capabilities — element detection, intelligent matting, intelligent removal, Image Translation Pro, image expansion, intelligent cropping, and HD upscaling — into an image processing workflow. Upload an image once, select the desired capabilities, and complete multiple image optimizations sequentially in a single call to produce product images that meet listing platform requirements. (Asynchronous)
6081
+ * Provides a one-stop AI image processing service for e-commerce sellers. Orchestrates six atomic capabilities—element recognition, intelligent cutout, intelligent erasure, image translation Pro, intelligent cropping, and high-definition upscaling—into an image processing workflow. Users can upload an image once, select the required capabilities, and complete multiple image optimizations in sequence to output product images that meet the requirements of e-commerce platforms. (Asynchronous)
6078
6082
  *
6079
6083
  * @remarks
6080
- * # 1. Product Introduction
6081
- * A one-stop AI-powered image processing service for e-commerce sellers. Orchestrates seven atomic capabilities — element detection, intelligent matting, intelligent removal, Image Translation Pro, image expansion, intelligent cropping, and HD upscaling — into an image processing workflow. Upload an image once, select the desired capabilities, and complete multiple image optimizations sequentially in a single call to produce product images that meet listing platform requirements. (Asynchronous)
6082
- * # 2. Common scenarios
6083
- * Applicable to batch optimization of product images in cross-platform listing scenarios. Adapts source product images into main images, SKU images, and detail images required by listing platforms. Supported capabilities include:
6084
- * * Detecting low-quality images that contain text, watermarks, logos, or overlay patches, allowing users to filter images that need processing
6084
+ * # 1. Product introduction
6085
+ * Provides a one-stop AI image processing service for e-commerce sellers. Orchestrates six atomic capabilities—element recognition, intelligent cutout, intelligent erasure, image translation Pro, intelligent cropping, and high-definition upscaling—into an image processing workflow. Users can upload an image once, select the required capabilities, and complete multiple image optimizations in sequence to output product images that meet the requirements of e-commerce platforms. (Asynchronous)
6086
+ * # 2. Scenarios
6087
+ * Applicable to batch optimization of product images in cross-platform listing scenarios. Adapts source product images into main images, SKU images, and detail images required by listing platforms. Supports the following operations:
6088
+ * * Identifies low-quality images with text, watermarks, logos, or cluttered text, and allows users to filter the images to be processed.
6085
6089
  *
6086
- * * Removing non-compliant elements such as watermarks, logos, overlay patches, and Chinese text from original images
6090
+ * * Removes non-compliant elements such as watermarks, logos, cluttered text, and Chinese text from the original image.
6087
6091
  *
6088
- * * Removing the background around the product subject edges
6092
+ * * Removes the background around the main product subject.
6089
6093
  *
6090
- * * Translating text within images into other languages
6094
+ * * Translates text in the image into other languages.
6091
6095
  *
6092
- * * Expanding images to other dimensions (by ratio, size, etc.) with automatic background fill
6096
+ * * Expands the image to other sizes (by ratio or dimensions) and automatically fills the background.
6093
6097
  *
6094
- * * Cropping images to specified dimensions
6098
+ * * Crops the image to a specified size.
6095
6099
  *
6096
- * * Upscaling image resolution by a specified factor
6100
+ * * Upscales the image pixels by a specified factor.
6097
6101
  * # 3. Features
6098
- * Provide a product image URL and use the Ability parameter to select the desired combination of AI capabilities (1 = Intelligent Element Detection, 2 = Intelligent Matting, 3 = Intelligent Removal, 4 = Image Translation Pro, 5 = Image Expansion, 6 = Intelligent Cropping, 7 = HD Upscaling). The system executes the selected capabilities sequentially in a preset order. Because Intelligent Element Detection helps determine whether an image contains certain specified elements, and the presence of those elements affects the selection of subsequent AI capabilities, an additional input is provided that allows users to choose whether to filter images out of or retain images in the subsequent AI processing pipeline.
6102
+ * Users input the URL of a product image and select the required AI capabilities through the Ability parameter (1=Intelligent element recognition, 2=Intelligent cutout, 3=Intelligent erasure, 4=Image translation Pro, 5=Image expansion, 6=Intelligent cropping, 7=High-definition upscaling). The system executes the selected capabilities in a preset sequence. Because intelligent element recognition helps users determine whether an image contains specific elements, and the presence of these elements affects the selection of subsequent AI capabilities, an additional input option is provided. This option allows users to choose whether to filter out images from subsequent AI processing or retain them without further processing.
6099
6103
  * ![ai-pipeline-flowchart.svg](https://alidocs.oss-cn-zhangjiakou.aliyuncs.com/res/NpQlK5jRe9w5jqDv/img/bddb522a-0795-4b5c-b25d-10e933426367.svg)
6100
- * Each AI capability is described as follows:
6101
- * 1. **Intelligent Element Detection:** An element detection capability designed specifically for e-commerce images. Detects elements such as text, logos, watermarks, and text-bearing color blocks in both the image subject and background, and returns Boolean detection results. Supports filtering images based on detection results (for example, processing only images that contain watermarks). Works in conjunction with subsequent capabilities — first identifies the types of elements that need optimization, then precisely executes removal and other operations.
6104
+ * The following section describes each AI capability:
6105
+ * **1. Intelligent element recognition**: An element detection capability designed specifically for e-commerce images. It identifies elements such as text, logos, watermarks, and text blocks in the subject and background of an image, and returns Boolean detection results. Users can filter images based on the recognition results (for example, processing only images with watermarks) and link this capability with subsequent ones—first identifying the types of elements to be optimized, and then precisely executing operations such as erasure.
6102
6106
  *
6103
- * 2. **Intelligent Matting:** Automatically identifies the product subject in an image and precisely separates the subject from the background. Based on deep learning models, supports accurate segmentation of complex edges such as hair strands and transparent objects. Outputs images with a transparent or white background, supports custom background colors and target size cropping, and directly generates product display images that comply with e-commerce platform specifications.
6107
+ * **2. Intelligent cutout**: Automatically identifies the main product subject in an image and precisely separates it from the background. Based on deep learning models, it supports precise segmentation of complex edges such as hair and transparent objects. It can output images with transparent or white backgrounds, supports custom background colors and target size cropping, and directly generates product display images that comply with e-commerce platform specifications.
6104
6108
  *
6105
- * 3. **Intelligent Removal:** Automatically detects and removes non-compliant elements from e-commerce images, including text, specific names (brand/store names), transparent text blocks, and overlay patches. Supports specifying removal of elements in the subject area or non-subject area separately. Also supports specifying exact removal regions through the Mask parameter for efficient compliance cleanup of large batches of images.
6109
+ * **3. Intelligent erasure**: Automatically identifies and removes non-compliant elements in e-commerce images, such as text, specific names (brand or store names), transparent text blocks, and cluttered text. It supports specifying the removal of elements in the subject area or non-subject area separately. It also supports precisely specifying the removal area through the Mask parameter to achieve efficient and compliant cleanup of large batches of images.
6106
6110
  *
6107
- * 4. **Image Translation Pro:** Leverages multimodal foundation model technology to translate text in images into a target language and render it directly at the corresponding position in the original image. Supports more than 100 language pairs. Provides product subject text protection, brand name protection, and translation intervention glossaries to prevent mistranslation of embedded product information. After translation, returns layout information such as text position, font, and color to support secondary editing.
6111
+ * **4. Image translation Pro**: Integrates multimodal large model technology to translate text in an image into a target language and directly renders it in the corresponding position of the original image. It supports over 100 language pairs. It provides features such as product subject text protection, brand name protection, and translation intervention glossaries to avoid mistranslating embedded product information. After translation, it can return layout information such as text position, font, and color to support secondary editing.
6108
6112
  *
6109
- * 5. **Intelligent Image Expansion:** Expands the image canvas using AI generation technology to broaden the image view without cropping the subject. Supports multiple expansion methods: by aspect ratio (1:1, 3:4, 4:3, 9:16, 16:9), by horizontal/vertical scaling ratio (1.0× to 3.0×), or by pixel offset in the up, down, left, and right directions. AI automatically fills in naturally transitioning background content.
6113
+ * **5. Intelligent image expansion**: Expands the image canvas based on AI generation technology to broaden the image field of view without cropping the subject. It supports multiple expansion methods: expanding by aspect ratio (1:1, 3:4, 4:3, 9:16, 16:9), scaling by horizontal or vertical proportion (1.0 to 3.0 times), and shifting pixels in the up, down, left, or right directions. The AI automatically fills and generates naturally transitioning background content.
6110
6114
  *
6111
- * 6. **Intelligent Cropping:** Intelligently crops images to specified dimensions, automatically identifies the subject area, and precisely preserves core content. Supports custom output width and height (100–5000 pixels) to meet the image dimension requirements of different e-commerce platforms and ad placements, ensuring the subject remains prominent and the composition stays balanced after cropping.
6115
+ * **6. Intelligent cropping**: Intelligently crops images to specified sizes, automatically identifies the main subject area of the image, and precisely retains the core content. It supports custom output width and height (100 to 5000 pixels) and adapts to the image size requirements of different e-commerce platforms and ad slots, ensuring that the subject stands out and the picture is balanced after cropping.
6112
6116
  *
6113
- * 7. **HD Upscaling:** Enhances details and reduces noise while upscaling images. Supports 2× to 4× upscaling. Suitable for improving the clarity of low-resolution product images and optimizing visual presentation. Supports output in PNG, JPG, BMP, and other formats.
6114
- * # 4. Before and after comparison
6117
+ * **7. High-definition upscaling**: Enhances details and reduces noise while upscaling the image. It supports 2x to 4x upscaling. It is applicable to improving the clarity of low-resolution product images and optimizing visual presentation. It supports output in formats such as PNG, JPG, and BMP.
6118
+ * # 4. Effect comparison
6115
6119
  * | **Original image** | **Capabilities used** | **Output image** |
6116
6120
  * | --- | --- | --- |
6117
- * | ![image.png](https://alidocs.oss-cn-zhangjiakou.aliyuncs.com/res/NpQlK5jRe9w5jqDv/img/3c1af966-8a5a-491d-9bfa-aefc321c9bed.png) | * Intelligent detection
6121
+ * | ![image.png](https://alidocs.oss-cn-zhangjiakou.aliyuncs.com/res/NpQlK5jRe9w5jqDv/img/3c1af966-8a5a-491d-9bfa-aefc321c9bed.png) | * Intelligent recognition
6118
6122
  *
6119
- * * Image Translation Pro
6123
+ * * Image translation Pro
6120
6124
  *
6121
6125
  * * Intelligent cropping | ![R1.png](https://alidocs.oss-cn-zhangjiakou.aliyuncs.com/res/NpQlK5jRe9w5jqDv/img/c2579e3e-389e-4717-84e3-834e60fea6b0.png) |
6122
- * | ![image.png](https://alidocs.oss-cn-zhangjiakou.aliyuncs.com/res/NpQlK5jRe9w5jqDv/img/a92d14a9-ecf4-4e77-ad96-a2fcdd95dd1d.png) | * Intelligent matting
6126
+ * | ![image.png](https://alidocs.oss-cn-zhangjiakou.aliyuncs.com/res/NpQlK5jRe9w5jqDv/img/a92d14a9-ecf4-4e77-ad96-a2fcdd95dd1d.png) | * Intelligent cutout
6123
6127
  *
6124
- * * Intelligent removal
6128
+ * * Intelligent erasure
6125
6129
  *
6126
6130
  * * Intelligent cropping | ![R1.png](https://alidocs.oss-cn-zhangjiakou.aliyuncs.com/res/NpQlK5jRe9w5jqDv/img/f631f578-3496-4aa1-b5ef-cd1ea603e049.png) |
6127
- * | ![C2.png](https://alidocs.oss-cn-zhangjiakou.aliyuncs.com/res/NpQlK5jRe9w5jqDv/img/12965cf8-cfdf-4a85-95fe-fdfcefcaa4ae.png) | * Intelligent detection
6131
+ * | ![C2.png](https://alidocs.oss-cn-zhangjiakou.aliyuncs.com/res/NpQlK5jRe9w5jqDv/img/12965cf8-cfdf-4a85-95fe-fdfcefcaa4ae.png) | * Intelligent recognition
6128
6132
  *
6129
- * * Intelligent removal
6133
+ * * Intelligent erasure
6130
6134
  *
6131
- * * HD upscaling | ![R2.jpeg](https://alidocs.oss-cn-zhangjiakou.aliyuncs.com/res/NpQlK5jRe9w5jqDv/img/95d29e79-8622-45fb-b284-cd580fe40ea0.jpeg) |
6135
+ * * High-definition upscaling | ![R2.jpeg](https://alidocs.oss-cn-zhangjiakou.aliyuncs.com/res/NpQlK5jRe9w5jqDv/img/95d29e79-8622-45fb-b284-cd580fe40ea0.jpeg) |
6132
6136
  *
6133
6137
  * @param tmpReq - VisionFlowRequest
6134
6138
  * @param runtime - runtime options for this request RuntimeOptions
@@ -6245,61 +6249,61 @@ export default class Client extends OpenApi {
6245
6249
  }
6246
6250
 
6247
6251
  /**
6248
- * Provides a one-stop AI-powered image processing service for e-commerce sellers. Orchestrates seven atomic capabilities — element detection, intelligent matting, intelligent removal, Image Translation Pro, image expansion, intelligent cropping, and HD upscaling — into an image processing workflow. Upload an image once, select the desired capabilities, and complete multiple image optimizations sequentially in a single call to produce product images that meet listing platform requirements. (Asynchronous)
6252
+ * Provides a one-stop AI image processing service for e-commerce sellers. Orchestrates six atomic capabilities—element recognition, intelligent cutout, intelligent erasure, image translation Pro, intelligent cropping, and high-definition upscaling—into an image processing workflow. Users can upload an image once, select the required capabilities, and complete multiple image optimizations in sequence to output product images that meet the requirements of e-commerce platforms. (Asynchronous)
6249
6253
  *
6250
6254
  * @remarks
6251
- * # 1. Product Introduction
6252
- * A one-stop AI-powered image processing service for e-commerce sellers. Orchestrates seven atomic capabilities — element detection, intelligent matting, intelligent removal, Image Translation Pro, image expansion, intelligent cropping, and HD upscaling — into an image processing workflow. Upload an image once, select the desired capabilities, and complete multiple image optimizations sequentially in a single call to produce product images that meet listing platform requirements. (Asynchronous)
6253
- * # 2. Common scenarios
6254
- * Applicable to batch optimization of product images in cross-platform listing scenarios. Adapts source product images into main images, SKU images, and detail images required by listing platforms. Supported capabilities include:
6255
- * * Detecting low-quality images that contain text, watermarks, logos, or overlay patches, allowing users to filter images that need processing
6255
+ * # 1. Product introduction
6256
+ * Provides a one-stop AI image processing service for e-commerce sellers. Orchestrates six atomic capabilities—element recognition, intelligent cutout, intelligent erasure, image translation Pro, intelligent cropping, and high-definition upscaling—into an image processing workflow. Users can upload an image once, select the required capabilities, and complete multiple image optimizations in sequence to output product images that meet the requirements of e-commerce platforms. (Asynchronous)
6257
+ * # 2. Scenarios
6258
+ * Applicable to batch optimization of product images in cross-platform listing scenarios. Adapts source product images into main images, SKU images, and detail images required by listing platforms. Supports the following operations:
6259
+ * * Identifies low-quality images with text, watermarks, logos, or cluttered text, and allows users to filter the images to be processed.
6256
6260
  *
6257
- * * Removing non-compliant elements such as watermarks, logos, overlay patches, and Chinese text from original images
6261
+ * * Removes non-compliant elements such as watermarks, logos, cluttered text, and Chinese text from the original image.
6258
6262
  *
6259
- * * Removing the background around the product subject edges
6263
+ * * Removes the background around the main product subject.
6260
6264
  *
6261
- * * Translating text within images into other languages
6265
+ * * Translates text in the image into other languages.
6262
6266
  *
6263
- * * Expanding images to other dimensions (by ratio, size, etc.) with automatic background fill
6267
+ * * Expands the image to other sizes (by ratio or dimensions) and automatically fills the background.
6264
6268
  *
6265
- * * Cropping images to specified dimensions
6269
+ * * Crops the image to a specified size.
6266
6270
  *
6267
- * * Upscaling image resolution by a specified factor
6271
+ * * Upscales the image pixels by a specified factor.
6268
6272
  * # 3. Features
6269
- * Provide a product image URL and use the Ability parameter to select the desired combination of AI capabilities (1 = Intelligent Element Detection, 2 = Intelligent Matting, 3 = Intelligent Removal, 4 = Image Translation Pro, 5 = Image Expansion, 6 = Intelligent Cropping, 7 = HD Upscaling). The system executes the selected capabilities sequentially in a preset order. Because Intelligent Element Detection helps determine whether an image contains certain specified elements, and the presence of those elements affects the selection of subsequent AI capabilities, an additional input is provided that allows users to choose whether to filter images out of or retain images in the subsequent AI processing pipeline.
6273
+ * Users input the URL of a product image and select the required AI capabilities through the Ability parameter (1=Intelligent element recognition, 2=Intelligent cutout, 3=Intelligent erasure, 4=Image translation Pro, 5=Image expansion, 6=Intelligent cropping, 7=High-definition upscaling). The system executes the selected capabilities in a preset sequence. Because intelligent element recognition helps users determine whether an image contains specific elements, and the presence of these elements affects the selection of subsequent AI capabilities, an additional input option is provided. This option allows users to choose whether to filter out images from subsequent AI processing or retain them without further processing.
6270
6274
  * ![ai-pipeline-flowchart.svg](https://alidocs.oss-cn-zhangjiakou.aliyuncs.com/res/NpQlK5jRe9w5jqDv/img/bddb522a-0795-4b5c-b25d-10e933426367.svg)
6271
- * Each AI capability is described as follows:
6272
- * 1. **Intelligent Element Detection:** An element detection capability designed specifically for e-commerce images. Detects elements such as text, logos, watermarks, and text-bearing color blocks in both the image subject and background, and returns Boolean detection results. Supports filtering images based on detection results (for example, processing only images that contain watermarks). Works in conjunction with subsequent capabilities — first identifies the types of elements that need optimization, then precisely executes removal and other operations.
6275
+ * The following section describes each AI capability:
6276
+ * **1. Intelligent element recognition**: An element detection capability designed specifically for e-commerce images. It identifies elements such as text, logos, watermarks, and text blocks in the subject and background of an image, and returns Boolean detection results. Users can filter images based on the recognition results (for example, processing only images with watermarks) and link this capability with subsequent ones—first identifying the types of elements to be optimized, and then precisely executing operations such as erasure.
6273
6277
  *
6274
- * 2. **Intelligent Matting:** Automatically identifies the product subject in an image and precisely separates the subject from the background. Based on deep learning models, supports accurate segmentation of complex edges such as hair strands and transparent objects. Outputs images with a transparent or white background, supports custom background colors and target size cropping, and directly generates product display images that comply with e-commerce platform specifications.
6278
+ * **2. Intelligent cutout**: Automatically identifies the main product subject in an image and precisely separates it from the background. Based on deep learning models, it supports precise segmentation of complex edges such as hair and transparent objects. It can output images with transparent or white backgrounds, supports custom background colors and target size cropping, and directly generates product display images that comply with e-commerce platform specifications.
6275
6279
  *
6276
- * 3. **Intelligent Removal:** Automatically detects and removes non-compliant elements from e-commerce images, including text, specific names (brand/store names), transparent text blocks, and overlay patches. Supports specifying removal of elements in the subject area or non-subject area separately. Also supports specifying exact removal regions through the Mask parameter for efficient compliance cleanup of large batches of images.
6280
+ * **3. Intelligent erasure**: Automatically identifies and removes non-compliant elements in e-commerce images, such as text, specific names (brand or store names), transparent text blocks, and cluttered text. It supports specifying the removal of elements in the subject area or non-subject area separately. It also supports precisely specifying the removal area through the Mask parameter to achieve efficient and compliant cleanup of large batches of images.
6277
6281
  *
6278
- * 4. **Image Translation Pro:** Leverages multimodal foundation model technology to translate text in images into a target language and render it directly at the corresponding position in the original image. Supports more than 100 language pairs. Provides product subject text protection, brand name protection, and translation intervention glossaries to prevent mistranslation of embedded product information. After translation, returns layout information such as text position, font, and color to support secondary editing.
6282
+ * **4. Image translation Pro**: Integrates multimodal large model technology to translate text in an image into a target language and directly renders it in the corresponding position of the original image. It supports over 100 language pairs. It provides features such as product subject text protection, brand name protection, and translation intervention glossaries to avoid mistranslating embedded product information. After translation, it can return layout information such as text position, font, and color to support secondary editing.
6279
6283
  *
6280
- * 5. **Intelligent Image Expansion:** Expands the image canvas using AI generation technology to broaden the image view without cropping the subject. Supports multiple expansion methods: by aspect ratio (1:1, 3:4, 4:3, 9:16, 16:9), by horizontal/vertical scaling ratio (1.0× to 3.0×), or by pixel offset in the up, down, left, and right directions. AI automatically fills in naturally transitioning background content.
6284
+ * **5. Intelligent image expansion**: Expands the image canvas based on AI generation technology to broaden the image field of view without cropping the subject. It supports multiple expansion methods: expanding by aspect ratio (1:1, 3:4, 4:3, 9:16, 16:9), scaling by horizontal or vertical proportion (1.0 to 3.0 times), and shifting pixels in the up, down, left, or right directions. The AI automatically fills and generates naturally transitioning background content.
6281
6285
  *
6282
- * 6. **Intelligent Cropping:** Intelligently crops images to specified dimensions, automatically identifies the subject area, and precisely preserves core content. Supports custom output width and height (100–5000 pixels) to meet the image dimension requirements of different e-commerce platforms and ad placements, ensuring the subject remains prominent and the composition stays balanced after cropping.
6286
+ * **6. Intelligent cropping**: Intelligently crops images to specified sizes, automatically identifies the main subject area of the image, and precisely retains the core content. It supports custom output width and height (100 to 5000 pixels) and adapts to the image size requirements of different e-commerce platforms and ad slots, ensuring that the subject stands out and the picture is balanced after cropping.
6283
6287
  *
6284
- * 7. **HD Upscaling:** Enhances details and reduces noise while upscaling images. Supports 2× to 4× upscaling. Suitable for improving the clarity of low-resolution product images and optimizing visual presentation. Supports output in PNG, JPG, BMP, and other formats.
6285
- * # 4. Before and after comparison
6288
+ * **7. High-definition upscaling**: Enhances details and reduces noise while upscaling the image. It supports 2x to 4x upscaling. It is applicable to improving the clarity of low-resolution product images and optimizing visual presentation. It supports output in formats such as PNG, JPG, and BMP.
6289
+ * # 4. Effect comparison
6286
6290
  * | **Original image** | **Capabilities used** | **Output image** |
6287
6291
  * | --- | --- | --- |
6288
- * | ![image.png](https://alidocs.oss-cn-zhangjiakou.aliyuncs.com/res/NpQlK5jRe9w5jqDv/img/3c1af966-8a5a-491d-9bfa-aefc321c9bed.png) | * Intelligent detection
6292
+ * | ![image.png](https://alidocs.oss-cn-zhangjiakou.aliyuncs.com/res/NpQlK5jRe9w5jqDv/img/3c1af966-8a5a-491d-9bfa-aefc321c9bed.png) | * Intelligent recognition
6289
6293
  *
6290
- * * Image Translation Pro
6294
+ * * Image translation Pro
6291
6295
  *
6292
6296
  * * Intelligent cropping | ![R1.png](https://alidocs.oss-cn-zhangjiakou.aliyuncs.com/res/NpQlK5jRe9w5jqDv/img/c2579e3e-389e-4717-84e3-834e60fea6b0.png) |
6293
- * | ![image.png](https://alidocs.oss-cn-zhangjiakou.aliyuncs.com/res/NpQlK5jRe9w5jqDv/img/a92d14a9-ecf4-4e77-ad96-a2fcdd95dd1d.png) | * Intelligent matting
6297
+ * | ![image.png](https://alidocs.oss-cn-zhangjiakou.aliyuncs.com/res/NpQlK5jRe9w5jqDv/img/a92d14a9-ecf4-4e77-ad96-a2fcdd95dd1d.png) | * Intelligent cutout
6294
6298
  *
6295
- * * Intelligent removal
6299
+ * * Intelligent erasure
6296
6300
  *
6297
6301
  * * Intelligent cropping | ![R1.png](https://alidocs.oss-cn-zhangjiakou.aliyuncs.com/res/NpQlK5jRe9w5jqDv/img/f631f578-3496-4aa1-b5ef-cd1ea603e049.png) |
6298
- * | ![C2.png](https://alidocs.oss-cn-zhangjiakou.aliyuncs.com/res/NpQlK5jRe9w5jqDv/img/12965cf8-cfdf-4a85-95fe-fdfcefcaa4ae.png) | * Intelligent detection
6302
+ * | ![C2.png](https://alidocs.oss-cn-zhangjiakou.aliyuncs.com/res/NpQlK5jRe9w5jqDv/img/12965cf8-cfdf-4a85-95fe-fdfcefcaa4ae.png) | * Intelligent recognition
6299
6303
  *
6300
- * * Intelligent removal
6304
+ * * Intelligent erasure
6301
6305
  *
6302
- * * HD upscaling | ![R2.jpeg](https://alidocs.oss-cn-zhangjiakou.aliyuncs.com/res/NpQlK5jRe9w5jqDv/img/95d29e79-8622-45fb-b284-cd580fe40ea0.jpeg) |
6306
+ * * High-definition upscaling | ![R2.jpeg](https://alidocs.oss-cn-zhangjiakou.aliyuncs.com/res/NpQlK5jRe9w5jqDv/img/95d29e79-8622-45fb-b284-cd580fe40ea0.jpeg) |
6303
6307
  *
6304
6308
  * @param request - VisionFlowRequest
6305
6309
  * @returns VisionFlowResponse