@alicloud/aidge20260428 5.12.1 → 5.13.0
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.
- package/dist/client.d.ts +211 -152
- package/dist/client.js +274 -152
- package/dist/client.js.map +1 -1
- package/dist/models/AiTryOnRequest.d.ts +43 -5
- package/dist/models/AiTryOnRequest.js +10 -0
- package/dist/models/AiTryOnRequest.js.map +1 -1
- package/dist/models/AiTryOnResponseBody.d.ts +4 -2
- package/dist/models/AiTryOnResponseBody.js.map +1 -1
- package/dist/models/DocumentTranslateRequest.d.ts +10 -7
- package/dist/models/DocumentTranslateRequest.js.map +1 -1
- package/dist/models/DocumentTranslateResponseBody.d.ts +3 -3
- package/dist/models/ProductVideoGenerationRequest.d.ts +62 -0
- package/dist/models/ProductVideoGenerationRequest.js +71 -0
- package/dist/models/ProductVideoGenerationRequest.js.map +1 -0
- package/dist/models/ProductVideoGenerationResponse.d.ts +19 -0
- package/dist/models/ProductVideoGenerationResponse.js +69 -0
- package/dist/models/ProductVideoGenerationResponse.js.map +1 -0
- package/dist/models/ProductVideoGenerationResponseBody.d.ts +86 -0
- package/dist/models/ProductVideoGenerationResponseBody.js +92 -0
- package/dist/models/ProductVideoGenerationResponseBody.js.map +1 -0
- package/dist/models/ProductVideoGenerationShrinkRequest.d.ts +62 -0
- package/dist/models/ProductVideoGenerationShrinkRequest.js +68 -0
- package/dist/models/ProductVideoGenerationShrinkRequest.js.map +1 -0
- package/dist/models/VirtualTryOnRequest.d.ts +2 -2
- package/dist/models/VirtualTryOnResponseBody.d.ts +8 -7
- package/dist/models/VirtualTryOnResponseBody.js.map +1 -1
- package/dist/models/VisionFlowRequest.d.ts +17 -17
- package/dist/models/VisionFlowResponseBody.d.ts +6 -6
- package/dist/models/VisionFlowShrinkRequest.d.ts +17 -17
- package/dist/models/model.d.ts +5 -0
- package/dist/models/model.js +15 -5
- package/dist/models/model.js.map +1 -1
- package/package.json +2 -1
- package/src/client.ts +290 -154
- package/src/models/AiTryOnRequest.ts +53 -5
- package/src/models/AiTryOnResponseBody.ts +4 -2
- package/src/models/DocumentTranslateRequest.ts +10 -7
- package/src/models/DocumentTranslateResponseBody.ts +3 -3
- package/src/models/ProductVideoGenerationRequest.ts +88 -0
- package/src/models/ProductVideoGenerationResponse.ts +40 -0
- package/src/models/ProductVideoGenerationResponseBody.ts +124 -0
- package/src/models/ProductVideoGenerationShrinkRequest.ts +85 -0
- package/src/models/VirtualTryOnRequest.ts +2 -2
- package/src/models/VirtualTryOnResponseBody.ts +8 -7
- package/src/models/VisionFlowRequest.ts +17 -17
- package/src/models/VisionFlowResponseBody.ts +6 -6
- package/src/models/VisionFlowShrinkRequest.ts +17 -17
- package/src/models/model.ts +5 -0
package/dist/client.js
CHANGED
|
@@ -41,6 +41,7 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
|
|
|
41
41
|
Object.defineProperty(exports, "__esModule", { value: true });
|
|
42
42
|
// This file is auto-generated, don't edit it
|
|
43
43
|
const $dara = __importStar(require("@darabonba/typescript"));
|
|
44
|
+
const gateway_pop_1 = __importDefault(require("@alicloud/gateway-pop"));
|
|
44
45
|
const openapi_core_1 = __importDefault(require("@alicloud/openapi-core"));
|
|
45
46
|
const openapi_core_2 = require("@alicloud/openapi-core");
|
|
46
47
|
const $_model = __importStar(require("./models/model"));
|
|
@@ -48,6 +49,9 @@ __exportStar(require("./models/model"), exports);
|
|
|
48
49
|
class Client extends openapi_core_1.default {
|
|
49
50
|
constructor(config) {
|
|
50
51
|
super(config);
|
|
52
|
+
this._productId = "Aidge";
|
|
53
|
+
let gatewayClient = new gateway_pop_1.default();
|
|
54
|
+
this._spi = gatewayClient;
|
|
51
55
|
this._endpointRule = "regional";
|
|
52
56
|
this.checkConfig(config);
|
|
53
57
|
this._endpoint = this.getEndpoint("aidge", this._regionId, this._endpointRule, this._network, this._suffix, this._endpointMap, this._endpoint);
|
|
@@ -109,38 +113,38 @@ class Client extends openapi_core_1.default {
|
|
|
109
113
|
return await this.addDisplayKnowledgeWithOptions(request, runtime);
|
|
110
114
|
}
|
|
111
115
|
/**
|
|
112
|
-
* Generates
|
|
116
|
+
* Generates virtual try-on images by applying specified garments to a model image based on AI algorithms. It preserves the model\\"s pose, facial features, and background details while ensuring a realistic fit. Users can obtain the processed images by providing the URLs of the original product and model images.
|
|
113
117
|
*
|
|
114
118
|
* @remarks
|
|
115
119
|
* ## Scenarios
|
|
116
120
|
* - **Virtual try-on for clothing:**
|
|
117
|
-
* Supports various clothing categories such as tops, bottoms, jumpsuits, and dresses. After
|
|
121
|
+
* Supports various clothing categories such as tops, bottoms, jumpsuits, and dresses. After users upload a model image and a product image, the system generates natural and realistic try-on effects to intuitively display how the clothing looks on the model.
|
|
118
122
|
* - **Virtual try-on for shoes and hats:**
|
|
119
|
-
* Supports virtual try-on for products such as shoes and hats.
|
|
123
|
+
* Supports virtual try-on for products such as shoes and hats. It intelligently matches the position and proportion of the product based on the model\\"s pose and body parts, presenting a coordinated and realistic wearing effect.
|
|
120
124
|
* - **E-commerce product display and marketing:**
|
|
121
125
|
* Helps merchants quickly generate model try-on images for different products, reducing the costs of traditional photography, outfit changes, and post-production, and improving the production efficiency of product images.
|
|
122
126
|
* - **Online shopping experience optimization:**
|
|
123
|
-
*
|
|
127
|
+
* Consumers can preview the wearing effect of products through virtual try-on, more intuitively understand the style, matching, and overall effect of the products, assist in purchase decisions, and enhance the shopping experience.
|
|
124
128
|
* ## Features
|
|
125
|
-
* - **First,
|
|
126
|
-
* - a. Model image:
|
|
127
|
-
* - b. Product image:
|
|
128
|
-
* - **Second,
|
|
129
|
-
* - a. Specify product type:
|
|
130
|
-
* - b. Automatic type recognition:
|
|
131
|
-
* - **Finally, the system
|
|
132
|
-
* - a. Preserve model details:
|
|
133
|
-
* - b. Maintain image consistency:
|
|
134
|
-
* - c. Generate try-on effect:
|
|
129
|
+
* - **First, users need to input a model image and a product image. The system uses the model image as the try-on subject and applies the garment from the product image to the model:**
|
|
130
|
+
* - a. Model image: the image of the person who needs to perform the virtual try-on.
|
|
131
|
+
* - b. Product image: the image of the clothing, shoes, or hat to be worn by the model.
|
|
132
|
+
* - **Second, users can select the corresponding product type based on the actual product. Supported types include tops, bottoms, jumpsuits, dresses, shoes, and hats:**
|
|
133
|
+
* - a. Specify product type: users can directly input the type of the current product, and the system will process it according to the specified type.
|
|
134
|
+
* - b. Automatic type recognition: if the user does not input the product type, the system will automatically recognize the product category in the product image and perform the virtual try-on based on the recognition result.
|
|
135
|
+
* - **Finally, the system combines the model image, product image, and product type to generate a virtual try-on image, displaying the wearing effect of the product on the model:**
|
|
136
|
+
* - a. Preserve model details: the generation process does not adjust the appearance, hairstyle, pose, body shape, and other details of the person in the original model image.
|
|
137
|
+
* - b. Maintain image consistency: the background, composition, lighting, and overall visual effect of the original model image remain unchanged, and only the wearing area corresponding to the product is processed.
|
|
138
|
+
* - c. Generate try-on effect: naturally apply the product to the model, making it fit the person\\"s pose and body structure, and generate a coordinated and realistic virtual try-on image.
|
|
135
139
|
* ## Examples
|
|
136
|
-
* | **Type** | **Model image** | **
|
|
140
|
+
* | **Type** | **Model image** | **Garment image** | **Try-on result image** |
|
|
137
141
|
* | --- | --- | --- | --- |
|
|
138
|
-
* |
|
|
139
|
-
* |
|
|
142
|
+
* | Top |  |  |  |
|
|
143
|
+
* | Bottom |  |  |  |
|
|
140
144
|
* | Shoes |  |  |  |
|
|
141
|
-
* |
|
|
142
|
-
* |
|
|
143
|
-
* |
|
|
145
|
+
* | Jumpsuit |  |  |  |
|
|
146
|
+
* | Dress |  |  |  |
|
|
147
|
+
* | Hat |  |  |  |
|
|
144
148
|
*
|
|
145
149
|
* @param request - AiTryOnRequest
|
|
146
150
|
* @param runtime - runtime options for this request RuntimeOptions
|
|
@@ -155,12 +159,27 @@ class Client extends openapi_core_1.default {
|
|
|
155
159
|
if (!$dara.isNull(request.clothType)) {
|
|
156
160
|
query["ClothType"] = request.clothType;
|
|
157
161
|
}
|
|
162
|
+
if (!$dara.isNull(request.mode)) {
|
|
163
|
+
query["Mode"] = request.mode;
|
|
164
|
+
}
|
|
158
165
|
if (!$dara.isNull(request.modelImageUrl)) {
|
|
159
166
|
query["ModelImageUrl"] = request.modelImageUrl;
|
|
160
167
|
}
|
|
168
|
+
if (!$dara.isNull(request.modelTemplateUrl)) {
|
|
169
|
+
query["ModelTemplateUrl"] = request.modelTemplateUrl;
|
|
170
|
+
}
|
|
171
|
+
if (!$dara.isNull(request.poseTemplateUrl)) {
|
|
172
|
+
query["PoseTemplateUrl"] = request.poseTemplateUrl;
|
|
173
|
+
}
|
|
174
|
+
if (!$dara.isNull(request.ratio)) {
|
|
175
|
+
query["Ratio"] = request.ratio;
|
|
176
|
+
}
|
|
161
177
|
if (!$dara.isNull(request.resolution)) {
|
|
162
178
|
query["Resolution"] = request.resolution;
|
|
163
179
|
}
|
|
180
|
+
if (!$dara.isNull(request.tryonType)) {
|
|
181
|
+
query["TryonType"] = request.tryonType;
|
|
182
|
+
}
|
|
164
183
|
let req = new openapi_core_2.$OpenApiUtil.OpenApiRequest({
|
|
165
184
|
query: openapi_core_2.OpenApiUtil.query(query),
|
|
166
185
|
});
|
|
@@ -178,38 +197,38 @@ class Client extends openapi_core_1.default {
|
|
|
178
197
|
return $dara.cast(await this.callApi(params, req, runtime), new $_model.AiTryOnResponse({}));
|
|
179
198
|
}
|
|
180
199
|
/**
|
|
181
|
-
* Generates
|
|
200
|
+
* Generates virtual try-on images by applying specified garments to a model image based on AI algorithms. It preserves the model\\"s pose, facial features, and background details while ensuring a realistic fit. Users can obtain the processed images by providing the URLs of the original product and model images.
|
|
182
201
|
*
|
|
183
202
|
* @remarks
|
|
184
203
|
* ## Scenarios
|
|
185
204
|
* - **Virtual try-on for clothing:**
|
|
186
|
-
* Supports various clothing categories such as tops, bottoms, jumpsuits, and dresses. After
|
|
205
|
+
* Supports various clothing categories such as tops, bottoms, jumpsuits, and dresses. After users upload a model image and a product image, the system generates natural and realistic try-on effects to intuitively display how the clothing looks on the model.
|
|
187
206
|
* - **Virtual try-on for shoes and hats:**
|
|
188
|
-
* Supports virtual try-on for products such as shoes and hats.
|
|
207
|
+
* Supports virtual try-on for products such as shoes and hats. It intelligently matches the position and proportion of the product based on the model\\"s pose and body parts, presenting a coordinated and realistic wearing effect.
|
|
189
208
|
* - **E-commerce product display and marketing:**
|
|
190
209
|
* Helps merchants quickly generate model try-on images for different products, reducing the costs of traditional photography, outfit changes, and post-production, and improving the production efficiency of product images.
|
|
191
210
|
* - **Online shopping experience optimization:**
|
|
192
|
-
*
|
|
211
|
+
* Consumers can preview the wearing effect of products through virtual try-on, more intuitively understand the style, matching, and overall effect of the products, assist in purchase decisions, and enhance the shopping experience.
|
|
193
212
|
* ## Features
|
|
194
|
-
* - **First,
|
|
195
|
-
* - a. Model image:
|
|
196
|
-
* - b. Product image:
|
|
197
|
-
* - **Second,
|
|
198
|
-
* - a. Specify product type:
|
|
199
|
-
* - b. Automatic type recognition:
|
|
200
|
-
* - **Finally, the system
|
|
201
|
-
* - a. Preserve model details:
|
|
202
|
-
* - b. Maintain image consistency:
|
|
203
|
-
* - c. Generate try-on effect:
|
|
213
|
+
* - **First, users need to input a model image and a product image. The system uses the model image as the try-on subject and applies the garment from the product image to the model:**
|
|
214
|
+
* - a. Model image: the image of the person who needs to perform the virtual try-on.
|
|
215
|
+
* - b. Product image: the image of the clothing, shoes, or hat to be worn by the model.
|
|
216
|
+
* - **Second, users can select the corresponding product type based on the actual product. Supported types include tops, bottoms, jumpsuits, dresses, shoes, and hats:**
|
|
217
|
+
* - a. Specify product type: users can directly input the type of the current product, and the system will process it according to the specified type.
|
|
218
|
+
* - b. Automatic type recognition: if the user does not input the product type, the system will automatically recognize the product category in the product image and perform the virtual try-on based on the recognition result.
|
|
219
|
+
* - **Finally, the system combines the model image, product image, and product type to generate a virtual try-on image, displaying the wearing effect of the product on the model:**
|
|
220
|
+
* - a. Preserve model details: the generation process does not adjust the appearance, hairstyle, pose, body shape, and other details of the person in the original model image.
|
|
221
|
+
* - b. Maintain image consistency: the background, composition, lighting, and overall visual effect of the original model image remain unchanged, and only the wearing area corresponding to the product is processed.
|
|
222
|
+
* - c. Generate try-on effect: naturally apply the product to the model, making it fit the person\\"s pose and body structure, and generate a coordinated and realistic virtual try-on image.
|
|
204
223
|
* ## Examples
|
|
205
|
-
* | **Type** | **Model image** | **
|
|
224
|
+
* | **Type** | **Model image** | **Garment image** | **Try-on result image** |
|
|
206
225
|
* | --- | --- | --- | --- |
|
|
207
|
-
* |
|
|
208
|
-
* |
|
|
226
|
+
* | Top |  |  |  |
|
|
227
|
+
* | Bottom |  |  |  |
|
|
209
228
|
* | Shoes |  |  |  |
|
|
210
|
-
* |
|
|
211
|
-
* |
|
|
212
|
-
* |
|
|
229
|
+
* | Jumpsuit |  |  |  |
|
|
230
|
+
* | Dress |  |  |  |
|
|
231
|
+
* | Hat |  |  |  |
|
|
213
232
|
*
|
|
214
233
|
* @param request - AiTryOnRequest
|
|
215
234
|
* @returns AiTryOnResponse
|
|
@@ -841,22 +860,29 @@ class Client extends openapi_core_1.default {
|
|
|
841
860
|
return await this.diduiAreaDeductionProWithOptions(request, runtime);
|
|
842
861
|
}
|
|
843
862
|
/**
|
|
844
|
-
* Translates documents
|
|
863
|
+
* Translates documents with a solution designed specifically for document translation. It supports over 150 languages and provides pivot translation capabilities with thousands of pivot combinations. It handles multi-scenario, multi-page, and highly complex document translation, but does not currently support scanned documents. It excels in the following aspects:
|
|
864
|
+
* - Content accuracy: translation accuracy, and accuracy of parameters and units.
|
|
865
|
+
* - Structural integrity: overall layout continuity, and restoration of page margins and layouts.
|
|
845
866
|
*
|
|
846
867
|
* @remarks
|
|
847
|
-
*
|
|
848
|
-
* Designed specifically for document translation, this
|
|
868
|
+
* # Product introduction
|
|
869
|
+
* Designed specifically for document translation, this service supports more than 150 languages and provides bridging translation capabilities with thousands of language combinations. It handles multi-scenario, multi-page, and highly complex document translations, but does not currently support scanned documents.
|
|
849
870
|
* It excels in the following aspects:
|
|
850
|
-
*
|
|
851
|
-
*
|
|
852
|
-
*
|
|
853
|
-
*
|
|
854
|
-
*
|
|
855
|
-
*
|
|
856
|
-
*
|
|
857
|
-
*
|
|
858
|
-
*
|
|
859
|
-
*
|
|
871
|
+
* * Content accuracy: translation accuracy, and accuracy of parameters and units.
|
|
872
|
+
*
|
|
873
|
+
* * Structural integrity: overall layout continuity, and restoration of page margins and layouts.
|
|
874
|
+
* # Scenarios
|
|
875
|
+
* Cross-border e-commerce product manuals, contracts, agreements, business proposals, qualification documents, teaching materials, courseware, and various other scenarios.
|
|
876
|
+
* # Features
|
|
877
|
+
* * Supports PDF, Word, and Excel formats. Supports source documents that contain multiple languages. For the detailed language list, see Section 4.4.
|
|
878
|
+
*
|
|
879
|
+
* * Supports the translation of text within images in documents, as well as complex translation scenarios involving other charts and special symbols.
|
|
880
|
+
*
|
|
881
|
+
* * Supports highly accurate layout restoration after translation.
|
|
882
|
+
*
|
|
883
|
+
* * Supports the translation of a single PDF or Word document with up to **800 pages**.
|
|
884
|
+
*
|
|
885
|
+
* * Supports custom translation results, including do-not-translate (ABC-ABC), specified translation (ABC-DEF), and translation omission (ABC-null value). This is commonly used in scenarios such as brand word protection. You can implement this by passing the corresponding intervention glossary ID when calling the API to meet your translation needs in different scenarios. Generally, you can upload up to 100,000 intervention terms. If you need more, contact the platform for assistance. For detailed instructions on translation intervention, see [Full-modal translation - Translation intervention instruction manual](https://www.alibabacloud.com/help/en/aidge/full-modal-translation-translation-intervention-instruction-manual)
|
|
860
886
|
*
|
|
861
887
|
* @param request - DocumentTranslateRequest
|
|
862
888
|
* @param runtime - runtime options for this request RuntimeOptions
|
|
@@ -894,22 +920,29 @@ class Client extends openapi_core_1.default {
|
|
|
894
920
|
return $dara.cast(await this.callApi(params, req, runtime), new $_model.DocumentTranslateResponse({}));
|
|
895
921
|
}
|
|
896
922
|
/**
|
|
897
|
-
* Translates documents
|
|
923
|
+
* Translates documents with a solution designed specifically for document translation. It supports over 150 languages and provides pivot translation capabilities with thousands of pivot combinations. It handles multi-scenario, multi-page, and highly complex document translation, but does not currently support scanned documents. It excels in the following aspects:
|
|
924
|
+
* - Content accuracy: translation accuracy, and accuracy of parameters and units.
|
|
925
|
+
* - Structural integrity: overall layout continuity, and restoration of page margins and layouts.
|
|
898
926
|
*
|
|
899
927
|
* @remarks
|
|
900
|
-
*
|
|
901
|
-
* Designed specifically for document translation, this
|
|
928
|
+
* # Product introduction
|
|
929
|
+
* Designed specifically for document translation, this service supports more than 150 languages and provides bridging translation capabilities with thousands of language combinations. It handles multi-scenario, multi-page, and highly complex document translations, but does not currently support scanned documents.
|
|
902
930
|
* It excels in the following aspects:
|
|
903
|
-
*
|
|
904
|
-
*
|
|
905
|
-
*
|
|
906
|
-
*
|
|
907
|
-
*
|
|
908
|
-
*
|
|
909
|
-
*
|
|
910
|
-
*
|
|
911
|
-
*
|
|
912
|
-
*
|
|
931
|
+
* * Content accuracy: translation accuracy, and accuracy of parameters and units.
|
|
932
|
+
*
|
|
933
|
+
* * Structural integrity: overall layout continuity, and restoration of page margins and layouts.
|
|
934
|
+
* # Scenarios
|
|
935
|
+
* Cross-border e-commerce product manuals, contracts, agreements, business proposals, qualification documents, teaching materials, courseware, and various other scenarios.
|
|
936
|
+
* # Features
|
|
937
|
+
* * Supports PDF, Word, and Excel formats. Supports source documents that contain multiple languages. For the detailed language list, see Section 4.4.
|
|
938
|
+
*
|
|
939
|
+
* * Supports the translation of text within images in documents, as well as complex translation scenarios involving other charts and special symbols.
|
|
940
|
+
*
|
|
941
|
+
* * Supports highly accurate layout restoration after translation.
|
|
942
|
+
*
|
|
943
|
+
* * Supports the translation of a single PDF or Word document with up to **800 pages**.
|
|
944
|
+
*
|
|
945
|
+
* * Supports custom translation results, including do-not-translate (ABC-ABC), specified translation (ABC-DEF), and translation omission (ABC-null value). This is commonly used in scenarios such as brand word protection. You can implement this by passing the corresponding intervention glossary ID when calling the API to meet your translation needs in different scenarios. Generally, you can upload up to 100,000 intervention terms. If you need more, contact the platform for assistance. For detailed instructions on translation intervention, see [Full-modal translation - Translation intervention instruction manual](https://www.alibabacloud.com/help/en/aidge/full-modal-translation-translation-intervention-instruction-manual)
|
|
913
946
|
*
|
|
914
947
|
* @param request - DocumentTranslateRequest
|
|
915
948
|
* @returns DocumentTranslateResponse
|
|
@@ -4153,6 +4186,95 @@ class Client extends openapi_core_1.default {
|
|
|
4153
4186
|
let runtime = new $dara.RuntimeOptions({});
|
|
4154
4187
|
return await this.productHotspotDetectionWithOptions(request, runtime);
|
|
4155
4188
|
}
|
|
4189
|
+
/**
|
|
4190
|
+
* Generates a single-product showcase video for e-commerce merchants and platforms based on a product title and multiple images of the same product. This API optionally accepts a storyboard script, automatically selects reference images, plans a three-shot storyboard, and generates the video. It uses asynchronous tasks, supports 720P and 1080P resolutions and four aspect ratios, and applies to product content production for non-apparel categories. For apparel categories, use the e-commerce enhanced edition.
|
|
4191
|
+
*
|
|
4192
|
+
* @remarks
|
|
4193
|
+
* # Product introduction
|
|
4194
|
+
* The basic e-commerce video edition is designed for e-commerce merchants and platforms. It generates a single-product showcase video based on a product title and multiple images of the same product. You can optionally provide a storyboard script. The system automatically selects reference images, plans a three-shot storyboard, and generates the video. This API uses asynchronous tasks, supports 720P and 1080P resolutions and four aspect ratios, and applies to product content production for non-apparel categories. For apparel categories, use the e-commerce enhanced edition.
|
|
4195
|
+
* # Scenarios
|
|
4196
|
+
* - New product material generation: Provide a product title and images to automatically plan storyboard content such as product debut, details, or usage demonstrations.
|
|
4197
|
+
* - Video production with existing scripts: Provide a storyboard script or creative description. The system optimizes the storyboard script based on the product images and retains shot intentions that are supported by the images.
|
|
4198
|
+
* - Adaptation to different video placements: Use the aspect ratio parameter to adapt to vertical short videos, main product images, detail pages, and horizontal displays. For batch production, each request corresponds to one product and one video.
|
|
4199
|
+
* # Features
|
|
4200
|
+
* - Automatic image selection and storyboard planning: When no script is provided, the system generates a storyboard based on the product title and images. When a script is provided, the system still performs image selection and planning, eliminating the need for callers to organize video prompts.
|
|
4201
|
+
* - Product appearance consistency constraint: The system uses the selected complete product image as the appearance baseline. It checks the color scheme, structure, proportion, texture, version, and specifications of other images, and selects only reference images that can be confirmed to belong to the same SKU.
|
|
4202
|
+
* - Flexible video specifications: Without a script, the duration is 5 to 15 seconds. With a script, the duration is 5 to 30 seconds. The system supports four aspect ratios (16:9, 1:1, 3:4, and 9:16) and two resolutions (720P and 1080P).
|
|
4203
|
+
* - Asynchronous generation and task query: After a task is created, a task ID is returned. Callers use the query API to obtain the result. The final video includes background music, no voiceover, and no additional subtitles or marketing text.
|
|
4204
|
+
* # Examples
|
|
4205
|
+
* [View the attachment Digital_040_WiFi6_Gigabit_Router.mp4 in the DingTalk document.](https://alidocs.dingtalk.com/i/nodes/gwva2dxOW4vRkd9DUn1g1p6kJbkz3BRL?cid=6760411388:7016395022&corpId=dingd8e1123006514592&iframeQuery=anchorId%3DX02mvsyycduj3nepwoeush&utm_medium=im_card&utm_scene=person_space&utm_source=im)
|
|
4206
|
+
*
|
|
4207
|
+
* @param tmpReq - ProductVideoGenerationRequest
|
|
4208
|
+
* @param runtime - runtime options for this request RuntimeOptions
|
|
4209
|
+
* @returns ProductVideoGenerationResponse
|
|
4210
|
+
*/
|
|
4211
|
+
async productVideoGenerationWithOptions(tmpReq, runtime) {
|
|
4212
|
+
tmpReq.validate();
|
|
4213
|
+
let request = new $_model.ProductVideoGenerationShrinkRequest({});
|
|
4214
|
+
openapi_core_2.OpenApiUtil.convert(tmpReq, request);
|
|
4215
|
+
if (!$dara.isNull(tmpReq.productImages)) {
|
|
4216
|
+
request.productImagesShrink = openapi_core_2.OpenApiUtil.arrayToStringWithSpecifiedStyle(tmpReq.productImages, "product_images", "json");
|
|
4217
|
+
}
|
|
4218
|
+
let query = {};
|
|
4219
|
+
if (!$dara.isNull(request.aspectRatio)) {
|
|
4220
|
+
query["aspect_ratio"] = request.aspectRatio;
|
|
4221
|
+
}
|
|
4222
|
+
if (!$dara.isNull(request.duration)) {
|
|
4223
|
+
query["duration"] = request.duration;
|
|
4224
|
+
}
|
|
4225
|
+
if (!$dara.isNull(request.productImagesShrink)) {
|
|
4226
|
+
query["product_images"] = request.productImagesShrink;
|
|
4227
|
+
}
|
|
4228
|
+
if (!$dara.isNull(request.productTitle)) {
|
|
4229
|
+
query["product_title"] = request.productTitle;
|
|
4230
|
+
}
|
|
4231
|
+
if (!$dara.isNull(request.resolution)) {
|
|
4232
|
+
query["resolution"] = request.resolution;
|
|
4233
|
+
}
|
|
4234
|
+
if (!$dara.isNull(request.script)) {
|
|
4235
|
+
query["script"] = request.script;
|
|
4236
|
+
}
|
|
4237
|
+
let req = new openapi_core_2.$OpenApiUtil.OpenApiRequest({
|
|
4238
|
+
query: openapi_core_2.OpenApiUtil.query(query),
|
|
4239
|
+
});
|
|
4240
|
+
let params = new openapi_core_2.$OpenApiUtil.Params({
|
|
4241
|
+
action: "ProductVideoGeneration",
|
|
4242
|
+
version: "2026-04-28",
|
|
4243
|
+
protocol: "HTTPS",
|
|
4244
|
+
pathname: "/",
|
|
4245
|
+
method: "POST",
|
|
4246
|
+
authType: "AK",
|
|
4247
|
+
style: "RPC",
|
|
4248
|
+
reqBodyType: "formData",
|
|
4249
|
+
bodyType: "json",
|
|
4250
|
+
});
|
|
4251
|
+
return $dara.cast(await this.callApi(params, req, runtime), new $_model.ProductVideoGenerationResponse({}));
|
|
4252
|
+
}
|
|
4253
|
+
/**
|
|
4254
|
+
* Generates a single-product showcase video for e-commerce merchants and platforms based on a product title and multiple images of the same product. This API optionally accepts a storyboard script, automatically selects reference images, plans a three-shot storyboard, and generates the video. It uses asynchronous tasks, supports 720P and 1080P resolutions and four aspect ratios, and applies to product content production for non-apparel categories. For apparel categories, use the e-commerce enhanced edition.
|
|
4255
|
+
*
|
|
4256
|
+
* @remarks
|
|
4257
|
+
* # Product introduction
|
|
4258
|
+
* The basic e-commerce video edition is designed for e-commerce merchants and platforms. It generates a single-product showcase video based on a product title and multiple images of the same product. You can optionally provide a storyboard script. The system automatically selects reference images, plans a three-shot storyboard, and generates the video. This API uses asynchronous tasks, supports 720P and 1080P resolutions and four aspect ratios, and applies to product content production for non-apparel categories. For apparel categories, use the e-commerce enhanced edition.
|
|
4259
|
+
* # Scenarios
|
|
4260
|
+
* - New product material generation: Provide a product title and images to automatically plan storyboard content such as product debut, details, or usage demonstrations.
|
|
4261
|
+
* - Video production with existing scripts: Provide a storyboard script or creative description. The system optimizes the storyboard script based on the product images and retains shot intentions that are supported by the images.
|
|
4262
|
+
* - Adaptation to different video placements: Use the aspect ratio parameter to adapt to vertical short videos, main product images, detail pages, and horizontal displays. For batch production, each request corresponds to one product and one video.
|
|
4263
|
+
* # Features
|
|
4264
|
+
* - Automatic image selection and storyboard planning: When no script is provided, the system generates a storyboard based on the product title and images. When a script is provided, the system still performs image selection and planning, eliminating the need for callers to organize video prompts.
|
|
4265
|
+
* - Product appearance consistency constraint: The system uses the selected complete product image as the appearance baseline. It checks the color scheme, structure, proportion, texture, version, and specifications of other images, and selects only reference images that can be confirmed to belong to the same SKU.
|
|
4266
|
+
* - Flexible video specifications: Without a script, the duration is 5 to 15 seconds. With a script, the duration is 5 to 30 seconds. The system supports four aspect ratios (16:9, 1:1, 3:4, and 9:16) and two resolutions (720P and 1080P).
|
|
4267
|
+
* - Asynchronous generation and task query: After a task is created, a task ID is returned. Callers use the query API to obtain the result. The final video includes background music, no voiceover, and no additional subtitles or marketing text.
|
|
4268
|
+
* # Examples
|
|
4269
|
+
* [View the attachment Digital_040_WiFi6_Gigabit_Router.mp4 in the DingTalk document.](https://alidocs.dingtalk.com/i/nodes/gwva2dxOW4vRkd9DUn1g1p6kJbkz3BRL?cid=6760411388:7016395022&corpId=dingd8e1123006514592&iframeQuery=anchorId%3DX02mvsyycduj3nepwoeush&utm_medium=im_card&utm_scene=person_space&utm_source=im)
|
|
4270
|
+
*
|
|
4271
|
+
* @param request - ProductVideoGenerationRequest
|
|
4272
|
+
* @returns ProductVideoGenerationResponse
|
|
4273
|
+
*/
|
|
4274
|
+
async productVideoGeneration(request) {
|
|
4275
|
+
let runtime = new $dara.RuntimeOptions({});
|
|
4276
|
+
return await this.productVideoGenerationWithOptions(request, runtime);
|
|
4277
|
+
}
|
|
4156
4278
|
/**
|
|
4157
4279
|
* Queries the result of an asynchronous task. The API name in the POP gateway is QueryAsyncTaskResult.
|
|
4158
4280
|
*
|
|
@@ -5592,26 +5714,26 @@ class Client extends openapi_core_1.default {
|
|
|
5592
5714
|
return await this.videoTranslationWithOptions(request, runtime);
|
|
5593
5715
|
}
|
|
5594
5716
|
/**
|
|
5595
|
-
* Generates virtual try-on images by
|
|
5717
|
+
* Generates virtual try-on images by applying a specified garment to a model image based on AI algorithms. It preserves the model\\"s pose, facial features, and background details while ensuring a realistic fit. Users only need to provide the URLs of the original model and garment images to obtain the processed image.
|
|
5596
5718
|
*
|
|
5597
5719
|
* @remarks
|
|
5598
5720
|
* ## Scenarios
|
|
5599
5721
|
* - **Virtual try-on for clothing:**
|
|
5600
|
-
* Supports various clothing categories such as tops, bottoms, jumpsuits, and dresses. After
|
|
5722
|
+
* Supports various clothing categories such as tops, bottoms, jumpsuits, and dresses. After users upload a model image and a garment image, the system generates natural and realistic try-on effects to intuitively display how the garment looks on the model.
|
|
5601
5723
|
* - **Virtual try-on for shoes and hats:**
|
|
5602
|
-
* Supports virtual try-on for accessories such as shoes and hats. The system intelligently matches the position and proportion of the
|
|
5724
|
+
* Supports virtual try-on for accessories such as shoes and hats. The system intelligently matches the position and proportion of the product based on the model\\"s pose and body parts, presenting a coordinated and realistic wearing effect.
|
|
5603
5725
|
* - **E-commerce product display and marketing:**
|
|
5604
|
-
*
|
|
5726
|
+
* Helps merchants quickly generate model try-on images for different products, reducing the costs of traditional photography, outfit changes, and post-production, and improving the production efficiency of product images.
|
|
5605
5727
|
* - **Online shopping experience optimization:**
|
|
5606
|
-
* Allows consumers to preview the wearing effect of products through virtual try-on, providing a more intuitive understanding of the style, matching, and overall effect of the
|
|
5728
|
+
* Allows consumers to preview the wearing effect of products through virtual try-on, providing a more intuitive understanding of the style, matching, and overall effect of the product, which assists in purchase decisions and enhances the shopping experience.
|
|
5607
5729
|
* ## Features
|
|
5608
|
-
* - **First,
|
|
5609
|
-
* - a. Model image: the image of the person
|
|
5610
|
-
* - b.
|
|
5611
|
-
* - **Second,
|
|
5612
|
-
* - a. Specify product type:
|
|
5613
|
-
* - b. Automatic type recognition: if
|
|
5614
|
-
* - **Finally, the system combines the model image,
|
|
5730
|
+
* - **First, users need to input a model image and a garment image. The system uses the model image as the try-on subject and applies the garment from the garment image to the model:**
|
|
5731
|
+
* - a. Model image: the image of the person for the virtual try-on.
|
|
5732
|
+
* - b. Garment image: the image of the clothing, shoes, or hat to be worn by the model.
|
|
5733
|
+
* - **Second, users can select the corresponding product type based on the actual product. Supported types include tops, bottoms, jumpsuits, dresses, shoes, and hats:**
|
|
5734
|
+
* - a. Specify product type: users can directly input the type of the current product, and the system will process it according to the specified type.
|
|
5735
|
+
* - b. Automatic type recognition: if the user does not input the product type, the system will automatically recognize the product category in the garment image and perform the virtual try-on based on the recognition result.
|
|
5736
|
+
* - **Finally, the system combines the model image, garment image, and product type to generate a virtual try-on image, displaying the wearing effect of the product on the model:**
|
|
5615
5737
|
* - a. Preserve model details: the generation process does not adjust the appearance, hairstyle, pose, body shape, or other details of the person in the original model image.
|
|
5616
5738
|
* - b. Maintain image consistency: the background, composition, lighting, and overall visual effect of the original model image remain unchanged. Only the wearing area corresponding to the product is processed.
|
|
5617
5739
|
* - c. Generate try-on effect: the product is naturally applied to the model, fitting the person\\"s pose and body structure to generate a coordinated and realistic virtual try-on image.
|
|
@@ -5619,8 +5741,8 @@ class Client extends openapi_core_1.default {
|
|
|
5619
5741
|
* | **Type** | **Model image** | **Garment image** | **Try-on result** |
|
|
5620
5742
|
* | --- | --- | --- | --- |
|
|
5621
5743
|
* | Tops |  |  |  |
|
|
5622
|
-
* | Bottoms |  |  |  |  |  |
|
|
5745
|
+
* | Shoes |  |  |  |
|
|
5624
5746
|
* | Jumpsuits |  |  |  |
|
|
5625
5747
|
* | Dresses |  |  |  |
|
|
5626
5748
|
* | Hats |  |  |  |
|
|
@@ -5661,26 +5783,26 @@ class Client extends openapi_core_1.default {
|
|
|
5661
5783
|
return $dara.cast(await this.callApi(params, req, runtime), new $_model.VirtualTryOnResponse({}));
|
|
5662
5784
|
}
|
|
5663
5785
|
/**
|
|
5664
|
-
* Generates virtual try-on images by
|
|
5786
|
+
* Generates virtual try-on images by applying a specified garment to a model image based on AI algorithms. It preserves the model\\"s pose, facial features, and background details while ensuring a realistic fit. Users only need to provide the URLs of the original model and garment images to obtain the processed image.
|
|
5665
5787
|
*
|
|
5666
5788
|
* @remarks
|
|
5667
5789
|
* ## Scenarios
|
|
5668
5790
|
* - **Virtual try-on for clothing:**
|
|
5669
|
-
* Supports various clothing categories such as tops, bottoms, jumpsuits, and dresses. After
|
|
5791
|
+
* Supports various clothing categories such as tops, bottoms, jumpsuits, and dresses. After users upload a model image and a garment image, the system generates natural and realistic try-on effects to intuitively display how the garment looks on the model.
|
|
5670
5792
|
* - **Virtual try-on for shoes and hats:**
|
|
5671
|
-
* Supports virtual try-on for accessories such as shoes and hats. The system intelligently matches the position and proportion of the
|
|
5793
|
+
* Supports virtual try-on for accessories such as shoes and hats. The system intelligently matches the position and proportion of the product based on the model\\"s pose and body parts, presenting a coordinated and realistic wearing effect.
|
|
5672
5794
|
* - **E-commerce product display and marketing:**
|
|
5673
|
-
*
|
|
5795
|
+
* Helps merchants quickly generate model try-on images for different products, reducing the costs of traditional photography, outfit changes, and post-production, and improving the production efficiency of product images.
|
|
5674
5796
|
* - **Online shopping experience optimization:**
|
|
5675
|
-
* Allows consumers to preview the wearing effect of products through virtual try-on, providing a more intuitive understanding of the style, matching, and overall effect of the
|
|
5797
|
+
* Allows consumers to preview the wearing effect of products through virtual try-on, providing a more intuitive understanding of the style, matching, and overall effect of the product, which assists in purchase decisions and enhances the shopping experience.
|
|
5676
5798
|
* ## Features
|
|
5677
|
-
* - **First,
|
|
5678
|
-
* - a. Model image: the image of the person
|
|
5679
|
-
* - b.
|
|
5680
|
-
* - **Second,
|
|
5681
|
-
* - a. Specify product type:
|
|
5682
|
-
* - b. Automatic type recognition: if
|
|
5683
|
-
* - **Finally, the system combines the model image,
|
|
5799
|
+
* - **First, users need to input a model image and a garment image. The system uses the model image as the try-on subject and applies the garment from the garment image to the model:**
|
|
5800
|
+
* - a. Model image: the image of the person for the virtual try-on.
|
|
5801
|
+
* - b. Garment image: the image of the clothing, shoes, or hat to be worn by the model.
|
|
5802
|
+
* - **Second, users can select the corresponding product type based on the actual product. Supported types include tops, bottoms, jumpsuits, dresses, shoes, and hats:**
|
|
5803
|
+
* - a. Specify product type: users can directly input the type of the current product, and the system will process it according to the specified type.
|
|
5804
|
+
* - b. Automatic type recognition: if the user does not input the product type, the system will automatically recognize the product category in the garment image and perform the virtual try-on based on the recognition result.
|
|
5805
|
+
* - **Finally, the system combines the model image, garment image, and product type to generate a virtual try-on image, displaying the wearing effect of the product on the model:**
|
|
5684
5806
|
* - a. Preserve model details: the generation process does not adjust the appearance, hairstyle, pose, body shape, or other details of the person in the original model image.
|
|
5685
5807
|
* - b. Maintain image consistency: the background, composition, lighting, and overall visual effect of the original model image remain unchanged. Only the wearing area corresponding to the product is processed.
|
|
5686
5808
|
* - c. Generate try-on effect: the product is naturally applied to the model, fitting the person\\"s pose and body structure to generate a coordinated and realistic virtual try-on image.
|
|
@@ -5688,8 +5810,8 @@ class Client extends openapi_core_1.default {
|
|
|
5688
5810
|
* | **Type** | **Model image** | **Garment image** | **Try-on result** |
|
|
5689
5811
|
* | --- | --- | --- | --- |
|
|
5690
5812
|
* | Tops |  |  |  |
|
|
5691
|
-
* | Bottoms |  |  |  |  |  |
|
|
5814
|
+
* | Shoes |  |  |  |
|
|
5693
5815
|
* | Jumpsuits |  |  |  |
|
|
5694
5816
|
* | Dresses |  |  |  |
|
|
5695
5817
|
* | Hats |  |  |  |
|
|
@@ -5702,61 +5824,61 @@ class Client extends openapi_core_1.default {
|
|
|
5702
5824
|
return await this.virtualTryOnWithOptions(request, runtime);
|
|
5703
5825
|
}
|
|
5704
5826
|
/**
|
|
5705
|
-
* Provides a one-stop AI
|
|
5827
|
+
* 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)
|
|
5706
5828
|
*
|
|
5707
5829
|
* @remarks
|
|
5708
|
-
* # 1. Product
|
|
5709
|
-
*
|
|
5710
|
-
* # 2.
|
|
5711
|
-
* 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.
|
|
5712
|
-
* *
|
|
5830
|
+
* # 1. Product introduction
|
|
5831
|
+
* 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)
|
|
5832
|
+
* # 2. Scenarios
|
|
5833
|
+
* 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:
|
|
5834
|
+
* * Identifies low-quality images with text, watermarks, logos, or cluttered text, and allows users to filter the images to be processed.
|
|
5713
5835
|
*
|
|
5714
|
-
* *
|
|
5836
|
+
* * Removes non-compliant elements such as watermarks, logos, cluttered text, and Chinese text from the original image.
|
|
5715
5837
|
*
|
|
5716
|
-
* *
|
|
5838
|
+
* * Removes the background around the main product subject.
|
|
5717
5839
|
*
|
|
5718
|
-
* *
|
|
5840
|
+
* * Translates text in the image into other languages.
|
|
5719
5841
|
*
|
|
5720
|
-
* *
|
|
5842
|
+
* * Expands the image to other sizes (by ratio or dimensions) and automatically fills the background.
|
|
5721
5843
|
*
|
|
5722
|
-
* *
|
|
5844
|
+
* * Crops the image to a specified size.
|
|
5723
5845
|
*
|
|
5724
|
-
* *
|
|
5846
|
+
* * Upscales the image pixels by a specified factor.
|
|
5725
5847
|
* # 3. Features
|
|
5726
|
-
*
|
|
5848
|
+
* 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.
|
|
5727
5849
|
* 
|
|
5728
|
-
*
|
|
5729
|
-
* 1.
|
|
5850
|
+
* The following section describes each AI capability:
|
|
5851
|
+
* **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.
|
|
5730
5852
|
*
|
|
5731
|
-
* 2.
|
|
5853
|
+
* **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.
|
|
5732
5854
|
*
|
|
5733
|
-
* 3.
|
|
5855
|
+
* **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.
|
|
5734
5856
|
*
|
|
5735
|
-
* 4.
|
|
5857
|
+
* **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.
|
|
5736
5858
|
*
|
|
5737
|
-
* 5.
|
|
5859
|
+
* **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.
|
|
5738
5860
|
*
|
|
5739
|
-
* 6.
|
|
5861
|
+
* **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.
|
|
5740
5862
|
*
|
|
5741
|
-
* 7.
|
|
5742
|
-
* # 4.
|
|
5863
|
+
* **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.
|
|
5864
|
+
* # 4. Effect comparison
|
|
5743
5865
|
* | **Original image** | **Capabilities used** | **Output image** |
|
|
5744
5866
|
* | --- | --- | --- |
|
|
5745
|
-
* |  | * Intelligent
|
|
5867
|
+
* |  | * Intelligent recognition
|
|
5746
5868
|
*
|
|
5747
|
-
* * Image
|
|
5869
|
+
* * Image translation Pro
|
|
5748
5870
|
*
|
|
5749
5871
|
* * Intelligent cropping |  |
|
|
5750
|
-
* |  | * Intelligent
|
|
5872
|
+
* |  | * Intelligent cutout
|
|
5751
5873
|
*
|
|
5752
|
-
* * Intelligent
|
|
5874
|
+
* * Intelligent erasure
|
|
5753
5875
|
*
|
|
5754
5876
|
* * Intelligent cropping |  |
|
|
5755
|
-
* |  | * Intelligent
|
|
5877
|
+
* |  | * Intelligent recognition
|
|
5756
5878
|
*
|
|
5757
|
-
* * Intelligent
|
|
5879
|
+
* * Intelligent erasure
|
|
5758
5880
|
*
|
|
5759
|
-
* *
|
|
5881
|
+
* * High-definition upscaling |  |
|
|
5760
5882
|
*
|
|
5761
5883
|
* @param tmpReq - VisionFlowRequest
|
|
5762
5884
|
* @param runtime - runtime options for this request RuntimeOptions
|
|
@@ -5850,61 +5972,61 @@ class Client extends openapi_core_1.default {
|
|
|
5850
5972
|
return $dara.cast(await this.callApi(params, req, runtime), new $_model.VisionFlowResponse({}));
|
|
5851
5973
|
}
|
|
5852
5974
|
/**
|
|
5853
|
-
* Provides a one-stop AI
|
|
5975
|
+
* 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)
|
|
5854
5976
|
*
|
|
5855
5977
|
* @remarks
|
|
5856
|
-
* # 1. Product
|
|
5857
|
-
*
|
|
5858
|
-
* # 2.
|
|
5859
|
-
* 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.
|
|
5860
|
-
* *
|
|
5978
|
+
* # 1. Product introduction
|
|
5979
|
+
* 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)
|
|
5980
|
+
* # 2. Scenarios
|
|
5981
|
+
* 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:
|
|
5982
|
+
* * Identifies low-quality images with text, watermarks, logos, or cluttered text, and allows users to filter the images to be processed.
|
|
5861
5983
|
*
|
|
5862
|
-
* *
|
|
5984
|
+
* * Removes non-compliant elements such as watermarks, logos, cluttered text, and Chinese text from the original image.
|
|
5863
5985
|
*
|
|
5864
|
-
* *
|
|
5986
|
+
* * Removes the background around the main product subject.
|
|
5865
5987
|
*
|
|
5866
|
-
* *
|
|
5988
|
+
* * Translates text in the image into other languages.
|
|
5867
5989
|
*
|
|
5868
|
-
* *
|
|
5990
|
+
* * Expands the image to other sizes (by ratio or dimensions) and automatically fills the background.
|
|
5869
5991
|
*
|
|
5870
|
-
* *
|
|
5992
|
+
* * Crops the image to a specified size.
|
|
5871
5993
|
*
|
|
5872
|
-
* *
|
|
5994
|
+
* * Upscales the image pixels by a specified factor.
|
|
5873
5995
|
* # 3. Features
|
|
5874
|
-
*
|
|
5996
|
+
* 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.
|
|
5875
5997
|
* 
|
|
5876
|
-
*
|
|
5877
|
-
* 1.
|
|
5998
|
+
* The following section describes each AI capability:
|
|
5999
|
+
* **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.
|
|
5878
6000
|
*
|
|
5879
|
-
* 2.
|
|
6001
|
+
* **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.
|
|
5880
6002
|
*
|
|
5881
|
-
* 3.
|
|
6003
|
+
* **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.
|
|
5882
6004
|
*
|
|
5883
|
-
* 4.
|
|
6005
|
+
* **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.
|
|
5884
6006
|
*
|
|
5885
|
-
* 5.
|
|
6007
|
+
* **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.
|
|
5886
6008
|
*
|
|
5887
|
-
* 6.
|
|
6009
|
+
* **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.
|
|
5888
6010
|
*
|
|
5889
|
-
* 7.
|
|
5890
|
-
* # 4.
|
|
6011
|
+
* **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.
|
|
6012
|
+
* # 4. Effect comparison
|
|
5891
6013
|
* | **Original image** | **Capabilities used** | **Output image** |
|
|
5892
6014
|
* | --- | --- | --- |
|
|
5893
|
-
* |  | * Intelligent
|
|
6015
|
+
* |  | * Intelligent recognition
|
|
5894
6016
|
*
|
|
5895
|
-
* * Image
|
|
6017
|
+
* * Image translation Pro
|
|
5896
6018
|
*
|
|
5897
6019
|
* * Intelligent cropping |  |
|
|
5898
|
-
* |  | * Intelligent
|
|
6020
|
+
* |  | * Intelligent cutout
|
|
5899
6021
|
*
|
|
5900
|
-
* * Intelligent
|
|
6022
|
+
* * Intelligent erasure
|
|
5901
6023
|
*
|
|
5902
6024
|
* * Intelligent cropping |  |
|
|
5903
|
-
* |  | * Intelligent
|
|
6025
|
+
* |  | * Intelligent recognition
|
|
5904
6026
|
*
|
|
5905
|
-
* * Intelligent
|
|
6027
|
+
* * Intelligent erasure
|
|
5906
6028
|
*
|
|
5907
|
-
* *
|
|
6029
|
+
* * High-definition upscaling |  |
|
|
5908
6030
|
*
|
|
5909
6031
|
* @param request - VisionFlowRequest
|
|
5910
6032
|
* @returns VisionFlowResponse
|