@alicloud/aidge20260428 5.12.2 → 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 +153 -94
- package/dist/client.js +212 -94
- 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/model.d.ts +5 -0
- package/dist/models/model.js +15 -5
- package/dist/models/model.js.map +1 -1
- package/package.json +1 -1
- package/src/client.ts +228 -96
- 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/model.ts +5 -0
package/src/client.ts
CHANGED
|
@@ -86,38 +86,38 @@ export default class Client extends OpenApi {
|
|
|
86
86
|
}
|
|
87
87
|
|
|
88
88
|
/**
|
|
89
|
-
* Generates
|
|
89
|
+
* 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.
|
|
90
90
|
*
|
|
91
91
|
* @remarks
|
|
92
92
|
* ## Scenarios
|
|
93
93
|
* - **Virtual try-on for clothing:**
|
|
94
|
-
* Supports various clothing categories such as tops, bottoms, jumpsuits, and dresses. After
|
|
94
|
+
* 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.
|
|
95
95
|
* - **Virtual try-on for shoes and hats:**
|
|
96
|
-
* Supports virtual try-on for products such as shoes and hats.
|
|
96
|
+
* 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.
|
|
97
97
|
* - **E-commerce product display and marketing:**
|
|
98
|
-
* 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.
|
|
98
|
+
* 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.
|
|
99
99
|
* - **Online shopping experience optimization:**
|
|
100
|
-
*
|
|
100
|
+
* 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.
|
|
101
101
|
* ## Features
|
|
102
|
-
* - **First,
|
|
103
|
-
* - a. Model image:
|
|
104
|
-
* - b. Product image:
|
|
105
|
-
* - **Second,
|
|
106
|
-
* - a. Specify product type:
|
|
107
|
-
* - b. Automatic type recognition:
|
|
108
|
-
* - **Finally, the system
|
|
109
|
-
* - a. Preserve model details:
|
|
110
|
-
* - b. Maintain image consistency:
|
|
111
|
-
* - c. Generate try-on effect:
|
|
102
|
+
* - **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:**
|
|
103
|
+
* - a. Model image: the image of the person who needs to perform the virtual try-on.
|
|
104
|
+
* - b. Product image: the image of the clothing, shoes, or hat to be worn by the model.
|
|
105
|
+
* - **Second, users can select the corresponding product type based on the actual product. Supported types include tops, bottoms, jumpsuits, dresses, shoes, and hats:**
|
|
106
|
+
* - 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.
|
|
107
|
+
* - 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.
|
|
108
|
+
* - **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:**
|
|
109
|
+
* - 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.
|
|
110
|
+
* - 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.
|
|
111
|
+
* - 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.
|
|
112
112
|
* ## Examples
|
|
113
|
-
* | **Type** | **Model image** | **
|
|
113
|
+
* | **Type** | **Model image** | **Garment image** | **Try-on result image** |
|
|
114
114
|
* | --- | --- | --- | --- |
|
|
115
|
-
* |
|
|
116
|
-
* |
|
|
115
|
+
* | Top |  |  |  |
|
|
116
|
+
* | Bottom |  |  |  |
|
|
117
117
|
* | Shoes |  |  |  |
|
|
118
|
-
* |
|
|
119
|
-
* |
|
|
120
|
-
* |
|
|
118
|
+
* | Jumpsuit |  |  |  |
|
|
119
|
+
* | Dress |  |  |  |
|
|
120
|
+
* | Hat |  |  |  |
|
|
121
121
|
*
|
|
122
122
|
* @param request - AiTryOnRequest
|
|
123
123
|
* @param runtime - runtime options for this request RuntimeOptions
|
|
@@ -134,14 +134,34 @@ export default class Client extends OpenApi {
|
|
|
134
134
|
query["ClothType"] = request.clothType;
|
|
135
135
|
}
|
|
136
136
|
|
|
137
|
+
if (!$dara.isNull(request.mode)) {
|
|
138
|
+
query["Mode"] = request.mode;
|
|
139
|
+
}
|
|
140
|
+
|
|
137
141
|
if (!$dara.isNull(request.modelImageUrl)) {
|
|
138
142
|
query["ModelImageUrl"] = request.modelImageUrl;
|
|
139
143
|
}
|
|
140
144
|
|
|
145
|
+
if (!$dara.isNull(request.modelTemplateUrl)) {
|
|
146
|
+
query["ModelTemplateUrl"] = request.modelTemplateUrl;
|
|
147
|
+
}
|
|
148
|
+
|
|
149
|
+
if (!$dara.isNull(request.poseTemplateUrl)) {
|
|
150
|
+
query["PoseTemplateUrl"] = request.poseTemplateUrl;
|
|
151
|
+
}
|
|
152
|
+
|
|
153
|
+
if (!$dara.isNull(request.ratio)) {
|
|
154
|
+
query["Ratio"] = request.ratio;
|
|
155
|
+
}
|
|
156
|
+
|
|
141
157
|
if (!$dara.isNull(request.resolution)) {
|
|
142
158
|
query["Resolution"] = request.resolution;
|
|
143
159
|
}
|
|
144
160
|
|
|
161
|
+
if (!$dara.isNull(request.tryonType)) {
|
|
162
|
+
query["TryonType"] = request.tryonType;
|
|
163
|
+
}
|
|
164
|
+
|
|
145
165
|
let req = new $OpenApiUtil.OpenApiRequest({
|
|
146
166
|
query: OpenApiUtil.query(query),
|
|
147
167
|
});
|
|
@@ -160,38 +180,38 @@ export default class Client extends OpenApi {
|
|
|
160
180
|
}
|
|
161
181
|
|
|
162
182
|
/**
|
|
163
|
-
* Generates
|
|
183
|
+
* 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.
|
|
164
184
|
*
|
|
165
185
|
* @remarks
|
|
166
186
|
* ## Scenarios
|
|
167
187
|
* - **Virtual try-on for clothing:**
|
|
168
|
-
* Supports various clothing categories such as tops, bottoms, jumpsuits, and dresses. After
|
|
188
|
+
* 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.
|
|
169
189
|
* - **Virtual try-on for shoes and hats:**
|
|
170
|
-
* Supports virtual try-on for products such as shoes and hats.
|
|
190
|
+
* 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.
|
|
171
191
|
* - **E-commerce product display and marketing:**
|
|
172
|
-
* 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.
|
|
192
|
+
* 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.
|
|
173
193
|
* - **Online shopping experience optimization:**
|
|
174
|
-
*
|
|
194
|
+
* 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.
|
|
175
195
|
* ## Features
|
|
176
|
-
* - **First,
|
|
177
|
-
* - a. Model image:
|
|
178
|
-
* - b. Product image:
|
|
179
|
-
* - **Second,
|
|
180
|
-
* - a. Specify product type:
|
|
181
|
-
* - b. Automatic type recognition:
|
|
182
|
-
* - **Finally, the system
|
|
183
|
-
* - a. Preserve model details:
|
|
184
|
-
* - b. Maintain image consistency:
|
|
185
|
-
* - c. Generate try-on effect:
|
|
196
|
+
* - **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:**
|
|
197
|
+
* - a. Model image: the image of the person who needs to perform the virtual try-on.
|
|
198
|
+
* - b. Product image: the image of the clothing, shoes, or hat to be worn by the model.
|
|
199
|
+
* - **Second, users can select the corresponding product type based on the actual product. Supported types include tops, bottoms, jumpsuits, dresses, shoes, and hats:**
|
|
200
|
+
* - 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.
|
|
201
|
+
* - 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.
|
|
202
|
+
* - **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:**
|
|
203
|
+
* - 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.
|
|
204
|
+
* - 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.
|
|
205
|
+
* - 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.
|
|
186
206
|
* ## Examples
|
|
187
|
-
* | **Type** | **Model image** | **
|
|
207
|
+
* | **Type** | **Model image** | **Garment image** | **Try-on result image** |
|
|
188
208
|
* | --- | --- | --- | --- |
|
|
189
|
-
* |
|
|
190
|
-
* |
|
|
209
|
+
* | Top |  |  |  |
|
|
210
|
+
* | Bottom |  |  |  |
|
|
191
211
|
* | Shoes |  |  |  |
|
|
192
|
-
* |
|
|
193
|
-
* |
|
|
194
|
-
* |
|
|
212
|
+
* | Jumpsuit |  |  |  |
|
|
213
|
+
* | Dress |  |  |  |
|
|
214
|
+
* | Hat |  |  |  |
|
|
195
215
|
*
|
|
196
216
|
* @param request - AiTryOnRequest
|
|
197
217
|
* @returns AiTryOnResponse
|
|
@@ -886,22 +906,29 @@ export default class Client extends OpenApi {
|
|
|
886
906
|
}
|
|
887
907
|
|
|
888
908
|
/**
|
|
889
|
-
* Translates documents
|
|
909
|
+
* 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:
|
|
910
|
+
* - Content accuracy: translation accuracy, and accuracy of parameters and units.
|
|
911
|
+
* - Structural integrity: overall layout continuity, and restoration of page margins and layouts.
|
|
890
912
|
*
|
|
891
913
|
* @remarks
|
|
892
|
-
*
|
|
893
|
-
* Designed specifically for document translation, this
|
|
914
|
+
* # Product introduction
|
|
915
|
+
* 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.
|
|
894
916
|
* It excels in the following aspects:
|
|
895
|
-
*
|
|
896
|
-
*
|
|
897
|
-
*
|
|
898
|
-
*
|
|
899
|
-
*
|
|
900
|
-
*
|
|
901
|
-
*
|
|
902
|
-
*
|
|
903
|
-
*
|
|
904
|
-
*
|
|
917
|
+
* * Content accuracy: translation accuracy, and accuracy of parameters and units.
|
|
918
|
+
*
|
|
919
|
+
* * Structural integrity: overall layout continuity, and restoration of page margins and layouts.
|
|
920
|
+
* # Scenarios
|
|
921
|
+
* Cross-border e-commerce product manuals, contracts, agreements, business proposals, qualification documents, teaching materials, courseware, and various other scenarios.
|
|
922
|
+
* # Features
|
|
923
|
+
* * Supports PDF, Word, and Excel formats. Supports source documents that contain multiple languages. For the detailed language list, see Section 4.4.
|
|
924
|
+
*
|
|
925
|
+
* * Supports the translation of text within images in documents, as well as complex translation scenarios involving other charts and special symbols.
|
|
926
|
+
*
|
|
927
|
+
* * Supports highly accurate layout restoration after translation.
|
|
928
|
+
*
|
|
929
|
+
* * Supports the translation of a single PDF or Word document with up to **800 pages**.
|
|
930
|
+
*
|
|
931
|
+
* * 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)
|
|
905
932
|
*
|
|
906
933
|
* @param request - DocumentTranslateRequest
|
|
907
934
|
* @param runtime - runtime options for this request RuntimeOptions
|
|
@@ -944,22 +971,29 @@ export default class Client extends OpenApi {
|
|
|
944
971
|
}
|
|
945
972
|
|
|
946
973
|
/**
|
|
947
|
-
* Translates documents
|
|
974
|
+
* 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:
|
|
975
|
+
* - Content accuracy: translation accuracy, and accuracy of parameters and units.
|
|
976
|
+
* - Structural integrity: overall layout continuity, and restoration of page margins and layouts.
|
|
948
977
|
*
|
|
949
978
|
* @remarks
|
|
950
|
-
*
|
|
951
|
-
* Designed specifically for document translation, this
|
|
979
|
+
* # Product introduction
|
|
980
|
+
* 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.
|
|
952
981
|
* It excels in the following aspects:
|
|
953
|
-
*
|
|
954
|
-
*
|
|
955
|
-
*
|
|
956
|
-
*
|
|
957
|
-
*
|
|
958
|
-
*
|
|
959
|
-
*
|
|
960
|
-
*
|
|
961
|
-
*
|
|
962
|
-
*
|
|
982
|
+
* * Content accuracy: translation accuracy, and accuracy of parameters and units.
|
|
983
|
+
*
|
|
984
|
+
* * Structural integrity: overall layout continuity, and restoration of page margins and layouts.
|
|
985
|
+
* # Scenarios
|
|
986
|
+
* Cross-border e-commerce product manuals, contracts, agreements, business proposals, qualification documents, teaching materials, courseware, and various other scenarios.
|
|
987
|
+
* # Features
|
|
988
|
+
* * Supports PDF, Word, and Excel formats. Supports source documents that contain multiple languages. For the detailed language list, see Section 4.4.
|
|
989
|
+
*
|
|
990
|
+
* * Supports the translation of text within images in documents, as well as complex translation scenarios involving other charts and special symbols.
|
|
991
|
+
*
|
|
992
|
+
* * Supports highly accurate layout restoration after translation.
|
|
993
|
+
*
|
|
994
|
+
* * Supports the translation of a single PDF or Word document with up to **800 pages**.
|
|
995
|
+
*
|
|
996
|
+
* * 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)
|
|
963
997
|
*
|
|
964
998
|
* @param request - DocumentTranslateRequest
|
|
965
999
|
* @returns DocumentTranslateResponse
|
|
@@ -4433,6 +4467,104 @@ export default class Client extends OpenApi {
|
|
|
4433
4467
|
return await this.productHotspotDetectionWithOptions(request, runtime);
|
|
4434
4468
|
}
|
|
4435
4469
|
|
|
4470
|
+
/**
|
|
4471
|
+
* 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.
|
|
4472
|
+
*
|
|
4473
|
+
* @remarks
|
|
4474
|
+
* # Product introduction
|
|
4475
|
+
* 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.
|
|
4476
|
+
* # Scenarios
|
|
4477
|
+
* - New product material generation: Provide a product title and images to automatically plan storyboard content such as product debut, details, or usage demonstrations.
|
|
4478
|
+
* - 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.
|
|
4479
|
+
* - 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.
|
|
4480
|
+
* # Features
|
|
4481
|
+
* - 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.
|
|
4482
|
+
* - 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.
|
|
4483
|
+
* - 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).
|
|
4484
|
+
* - 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.
|
|
4485
|
+
* # Examples
|
|
4486
|
+
* [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)
|
|
4487
|
+
*
|
|
4488
|
+
* @param tmpReq - ProductVideoGenerationRequest
|
|
4489
|
+
* @param runtime - runtime options for this request RuntimeOptions
|
|
4490
|
+
* @returns ProductVideoGenerationResponse
|
|
4491
|
+
*/
|
|
4492
|
+
async productVideoGenerationWithOptions(tmpReq: $_model.ProductVideoGenerationRequest, runtime: $dara.RuntimeOptions): Promise<$_model.ProductVideoGenerationResponse> {
|
|
4493
|
+
tmpReq.validate();
|
|
4494
|
+
let request = new $_model.ProductVideoGenerationShrinkRequest({ });
|
|
4495
|
+
OpenApiUtil.convert(tmpReq, request);
|
|
4496
|
+
if (!$dara.isNull(tmpReq.productImages)) {
|
|
4497
|
+
request.productImagesShrink = OpenApiUtil.arrayToStringWithSpecifiedStyle(tmpReq.productImages, "product_images", "json");
|
|
4498
|
+
}
|
|
4499
|
+
|
|
4500
|
+
let query = { };
|
|
4501
|
+
if (!$dara.isNull(request.aspectRatio)) {
|
|
4502
|
+
query["aspect_ratio"] = request.aspectRatio;
|
|
4503
|
+
}
|
|
4504
|
+
|
|
4505
|
+
if (!$dara.isNull(request.duration)) {
|
|
4506
|
+
query["duration"] = request.duration;
|
|
4507
|
+
}
|
|
4508
|
+
|
|
4509
|
+
if (!$dara.isNull(request.productImagesShrink)) {
|
|
4510
|
+
query["product_images"] = request.productImagesShrink;
|
|
4511
|
+
}
|
|
4512
|
+
|
|
4513
|
+
if (!$dara.isNull(request.productTitle)) {
|
|
4514
|
+
query["product_title"] = request.productTitle;
|
|
4515
|
+
}
|
|
4516
|
+
|
|
4517
|
+
if (!$dara.isNull(request.resolution)) {
|
|
4518
|
+
query["resolution"] = request.resolution;
|
|
4519
|
+
}
|
|
4520
|
+
|
|
4521
|
+
if (!$dara.isNull(request.script)) {
|
|
4522
|
+
query["script"] = request.script;
|
|
4523
|
+
}
|
|
4524
|
+
|
|
4525
|
+
let req = new $OpenApiUtil.OpenApiRequest({
|
|
4526
|
+
query: OpenApiUtil.query(query),
|
|
4527
|
+
});
|
|
4528
|
+
let params = new $OpenApiUtil.Params({
|
|
4529
|
+
action: "ProductVideoGeneration",
|
|
4530
|
+
version: "2026-04-28",
|
|
4531
|
+
protocol: "HTTPS",
|
|
4532
|
+
pathname: "/",
|
|
4533
|
+
method: "POST",
|
|
4534
|
+
authType: "AK",
|
|
4535
|
+
style: "RPC",
|
|
4536
|
+
reqBodyType: "formData",
|
|
4537
|
+
bodyType: "json",
|
|
4538
|
+
});
|
|
4539
|
+
return $dara.cast<$_model.ProductVideoGenerationResponse>(await this.callApi(params, req, runtime), new $_model.ProductVideoGenerationResponse({}));
|
|
4540
|
+
}
|
|
4541
|
+
|
|
4542
|
+
/**
|
|
4543
|
+
* 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.
|
|
4544
|
+
*
|
|
4545
|
+
* @remarks
|
|
4546
|
+
* # Product introduction
|
|
4547
|
+
* 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.
|
|
4548
|
+
* # Scenarios
|
|
4549
|
+
* - New product material generation: Provide a product title and images to automatically plan storyboard content such as product debut, details, or usage demonstrations.
|
|
4550
|
+
* - 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.
|
|
4551
|
+
* - 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.
|
|
4552
|
+
* # Features
|
|
4553
|
+
* - 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.
|
|
4554
|
+
* - 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.
|
|
4555
|
+
* - 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).
|
|
4556
|
+
* - 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.
|
|
4557
|
+
* # Examples
|
|
4558
|
+
* [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)
|
|
4559
|
+
*
|
|
4560
|
+
* @param request - ProductVideoGenerationRequest
|
|
4561
|
+
* @returns ProductVideoGenerationResponse
|
|
4562
|
+
*/
|
|
4563
|
+
async productVideoGeneration(request: $_model.ProductVideoGenerationRequest): Promise<$_model.ProductVideoGenerationResponse> {
|
|
4564
|
+
let runtime = new $dara.RuntimeOptions({ });
|
|
4565
|
+
return await this.productVideoGenerationWithOptions(request, runtime);
|
|
4566
|
+
}
|
|
4567
|
+
|
|
4436
4568
|
/**
|
|
4437
4569
|
* Queries the result of an asynchronous task. The API name in the POP gateway is QueryAsyncTaskResult.
|
|
4438
4570
|
*
|
|
@@ -5962,26 +6094,26 @@ export default class Client extends OpenApi {
|
|
|
5962
6094
|
}
|
|
5963
6095
|
|
|
5964
6096
|
/**
|
|
5965
|
-
* Generates virtual try-on images by
|
|
6097
|
+
* 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.
|
|
5966
6098
|
*
|
|
5967
6099
|
* @remarks
|
|
5968
6100
|
* ## Scenarios
|
|
5969
6101
|
* - **Virtual try-on for clothing:**
|
|
5970
|
-
* Supports various clothing categories such as tops, bottoms, jumpsuits, and dresses. After
|
|
6102
|
+
* 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.
|
|
5971
6103
|
* - **Virtual try-on for shoes and hats:**
|
|
5972
|
-
* Supports virtual try-on for accessories such as shoes and hats. The system intelligently matches the position and proportion of the
|
|
6104
|
+
* 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.
|
|
5973
6105
|
* - **E-commerce product display and marketing:**
|
|
5974
|
-
*
|
|
6106
|
+
* 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.
|
|
5975
6107
|
* - **Online shopping experience optimization:**
|
|
5976
|
-
* 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
|
|
6108
|
+
* 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.
|
|
5977
6109
|
* ## Features
|
|
5978
|
-
* - **First,
|
|
5979
|
-
* - a. Model image: the image of the person
|
|
5980
|
-
* - b.
|
|
5981
|
-
* - **Second,
|
|
5982
|
-
* - a. Specify product type:
|
|
5983
|
-
* - b. Automatic type recognition: if
|
|
5984
|
-
* - **Finally, the system combines the model image,
|
|
6110
|
+
* - **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:**
|
|
6111
|
+
* - a. Model image: the image of the person for the virtual try-on.
|
|
6112
|
+
* - b. Garment image: the image of the clothing, shoes, or hat to be worn by the model.
|
|
6113
|
+
* - **Second, users can select the corresponding product type based on the actual product. Supported types include tops, bottoms, jumpsuits, dresses, shoes, and hats:**
|
|
6114
|
+
* - 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.
|
|
6115
|
+
* - 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.
|
|
6116
|
+
* - **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:**
|
|
5985
6117
|
* - 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.
|
|
5986
6118
|
* - 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.
|
|
5987
6119
|
* - 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.
|
|
@@ -5989,8 +6121,8 @@ export default class Client extends OpenApi {
|
|
|
5989
6121
|
* | **Type** | **Model image** | **Garment image** | **Try-on result** |
|
|
5990
6122
|
* | --- | --- | --- | --- |
|
|
5991
6123
|
* | Tops |  |  |  |
|
|
5992
|
-
* | Bottoms |  |  |  |  |  |
|
|
6125
|
+
* | Shoes |  |  |  |
|
|
5994
6126
|
* | Jumpsuits |  |  |  |
|
|
5995
6127
|
* | Dresses |  |  |  |
|
|
5996
6128
|
* | Hats |  |  |  |
|
|
@@ -6036,26 +6168,26 @@ export default class Client extends OpenApi {
|
|
|
6036
6168
|
}
|
|
6037
6169
|
|
|
6038
6170
|
/**
|
|
6039
|
-
* Generates virtual try-on images by
|
|
6171
|
+
* 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.
|
|
6040
6172
|
*
|
|
6041
6173
|
* @remarks
|
|
6042
6174
|
* ## Scenarios
|
|
6043
6175
|
* - **Virtual try-on for clothing:**
|
|
6044
|
-
* Supports various clothing categories such as tops, bottoms, jumpsuits, and dresses. After
|
|
6176
|
+
* 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.
|
|
6045
6177
|
* - **Virtual try-on for shoes and hats:**
|
|
6046
|
-
* Supports virtual try-on for accessories such as shoes and hats. The system intelligently matches the position and proportion of the
|
|
6178
|
+
* 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.
|
|
6047
6179
|
* - **E-commerce product display and marketing:**
|
|
6048
|
-
*
|
|
6180
|
+
* 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.
|
|
6049
6181
|
* - **Online shopping experience optimization:**
|
|
6050
|
-
* 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
|
|
6182
|
+
* 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.
|
|
6051
6183
|
* ## Features
|
|
6052
|
-
* - **First,
|
|
6053
|
-
* - a. Model image: the image of the person
|
|
6054
|
-
* - b.
|
|
6055
|
-
* - **Second,
|
|
6056
|
-
* - a. Specify product type:
|
|
6057
|
-
* - b. Automatic type recognition: if
|
|
6058
|
-
* - **Finally, the system combines the model image,
|
|
6184
|
+
* - **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:**
|
|
6185
|
+
* - a. Model image: the image of the person for the virtual try-on.
|
|
6186
|
+
* - b. Garment image: the image of the clothing, shoes, or hat to be worn by the model.
|
|
6187
|
+
* - **Second, users can select the corresponding product type based on the actual product. Supported types include tops, bottoms, jumpsuits, dresses, shoes, and hats:**
|
|
6188
|
+
* - 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.
|
|
6189
|
+
* - 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.
|
|
6190
|
+
* - **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:**
|
|
6059
6191
|
* - 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.
|
|
6060
6192
|
* - 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.
|
|
6061
6193
|
* - 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.
|
|
@@ -6063,8 +6195,8 @@ export default class Client extends OpenApi {
|
|
|
6063
6195
|
* | **Type** | **Model image** | **Garment image** | **Try-on result** |
|
|
6064
6196
|
* | --- | --- | --- | --- |
|
|
6065
6197
|
* | Tops |  |  |  |
|
|
6066
|
-
* | Bottoms |  |  |  |  |  |
|
|
6199
|
+
* | Shoes |  |  |  |
|
|
6068
6200
|
* | Jumpsuits |  |  |  |
|
|
6069
6201
|
* | Dresses |  |  |  |
|
|
6070
6202
|
* | Hats |  |  |  |
|