@alicloud/aidge20260428 5.2.0 → 5.3.1

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.
Files changed (55) hide show
  1. package/dist/client.d.ts +98 -26
  2. package/dist/client.js +186 -26
  3. package/dist/client.js.map +1 -1
  4. package/dist/models/DiduiAreaDeductionRequest.d.ts +127 -0
  5. package/dist/models/DiduiAreaDeductionRequest.js +116 -0
  6. package/dist/models/DiduiAreaDeductionRequest.js.map +1 -0
  7. package/dist/models/DiduiAreaDeductionResponse.d.ts +19 -0
  8. package/dist/models/DiduiAreaDeductionResponse.js +69 -0
  9. package/dist/models/DiduiAreaDeductionResponse.js.map +1 -0
  10. package/dist/models/DiduiAreaDeductionResponseBody.d.ts +202 -0
  11. package/dist/models/DiduiAreaDeductionResponseBody.js +159 -0
  12. package/dist/models/DiduiAreaDeductionResponseBody.js.map +1 -0
  13. package/dist/models/DiduiAreaDeductionShrinkRequest.d.ts +46 -0
  14. package/dist/models/DiduiAreaDeductionShrinkRequest.js +64 -0
  15. package/dist/models/DiduiAreaDeductionShrinkRequest.js.map +1 -0
  16. package/dist/models/ImageRemoveRequest.d.ts +15 -0
  17. package/dist/models/ImageRemoveRequest.js +12 -0
  18. package/dist/models/ImageRemoveRequest.js.map +1 -1
  19. package/dist/models/ImageRemoveShrinkRequest.d.ts +15 -0
  20. package/dist/models/ImageRemoveShrinkRequest.js +6 -0
  21. package/dist/models/ImageRemoveShrinkRequest.js.map +1 -1
  22. package/dist/models/ProductHotspotDetectionRequest.d.ts +38 -0
  23. package/dist/models/ProductHotspotDetectionRequest.js +65 -0
  24. package/dist/models/ProductHotspotDetectionRequest.js.map +1 -0
  25. package/dist/models/ProductHotspotDetectionResponse.d.ts +19 -0
  26. package/dist/models/ProductHotspotDetectionResponse.js +69 -0
  27. package/dist/models/ProductHotspotDetectionResponse.js.map +1 -0
  28. package/dist/models/ProductHotspotDetectionResponseBody.d.ts +154 -0
  29. package/dist/models/ProductHotspotDetectionResponseBody.js +147 -0
  30. package/dist/models/ProductHotspotDetectionResponseBody.js.map +1 -0
  31. package/dist/models/ProductHotspotDetectionShrinkRequest.d.ts +38 -0
  32. package/dist/models/ProductHotspotDetectionShrinkRequest.js +62 -0
  33. package/dist/models/ProductHotspotDetectionShrinkRequest.js.map +1 -0
  34. package/dist/models/VideoGenerationRequest.d.ts +42 -0
  35. package/dist/models/VideoGenerationRequest.js +31 -1
  36. package/dist/models/VideoGenerationRequest.js.map +1 -1
  37. package/dist/models/VideoGenerationResponseBody.d.ts +3 -3
  38. package/dist/models/model.d.ts +17 -0
  39. package/dist/models/model.js +43 -8
  40. package/dist/models/model.js.map +1 -1
  41. package/package.json +1 -1
  42. package/src/client.ts +204 -26
  43. package/src/models/DiduiAreaDeductionRequest.ts +180 -0
  44. package/src/models/DiduiAreaDeductionResponse.ts +40 -0
  45. package/src/models/DiduiAreaDeductionResponseBody.ts +287 -0
  46. package/src/models/DiduiAreaDeductionShrinkRequest.ts +65 -0
  47. package/src/models/ImageRemoveRequest.ts +27 -0
  48. package/src/models/ImageRemoveShrinkRequest.ts +21 -0
  49. package/src/models/ProductHotspotDetectionRequest.ts +58 -0
  50. package/src/models/ProductHotspotDetectionResponse.ts +40 -0
  51. package/src/models/ProductHotspotDetectionResponseBody.ts +227 -0
  52. package/src/models/ProductHotspotDetectionShrinkRequest.ts +55 -0
  53. package/src/models/VideoGenerationRequest.ts +63 -0
  54. package/src/models/VideoGenerationResponseBody.ts +3 -3
  55. package/src/models/model.ts +17 -0
package/dist/client.d.ts CHANGED
@@ -242,6 +242,41 @@ export default class Client extends OpenApi {
242
242
  * @returns CategoryMatchResponse
243
243
  */
244
244
  categoryMatch(request: $_model.CategoryMatchRequest): Promise<$_model.CategoryMatchResponse>;
245
+ /**
246
+ * Calculates the edge lengths and floor area of a floor display based on the display image and product detection boxes.
247
+ *
248
+ * @remarks
249
+ * ## Description
250
+ * **Before using this operation, make sure that you fully understand the billing method and [pricing](https://www.aliyun.com/price/product#/ecs/detail) of the floor display area inference service.**
251
+ * - This operation infers the actual dimensions (lengths of two edges) and floor area of a floor display based on the provided overall display image, SKU knowledge base, and product location information in the image.
252
+ * - Make sure that the knowledge base corresponding to the specified `RagId` belongs to the caller and is in the available (`AVAILABLE`) state.
253
+ * - The `Products` array must contain at least one product item, and each product item must have at least one bounding box defined in `Boxes`.
254
+ * - All coordinate values are represented in a normalized coordinate system ranging from 0 to 1000. Make sure that the input satisfies the relationships `Left < Right` and `Top < Bottom`.
255
+ * - Set a reasonable timeout period when calling this operation (recommended not to exceed 300 seconds) to avoid failures caused by network latency or high processing complexity.
256
+ * - For calls in production environments, use the POP Action method. The internal REST address is primarily used for joint debugging during the development and testing phase.
257
+ *
258
+ * @param tmpReq - DiduiAreaDeductionRequest
259
+ * @param runtime - runtime options for this request RuntimeOptions
260
+ * @returns DiduiAreaDeductionResponse
261
+ */
262
+ diduiAreaDeductionWithOptions(tmpReq: $_model.DiduiAreaDeductionRequest, runtime: $dara.RuntimeOptions): Promise<$_model.DiduiAreaDeductionResponse>;
263
+ /**
264
+ * Calculates the edge lengths and floor area of a floor display based on the display image and product detection boxes.
265
+ *
266
+ * @remarks
267
+ * ## Description
268
+ * **Before using this operation, make sure that you fully understand the billing method and [pricing](https://www.aliyun.com/price/product#/ecs/detail) of the floor display area inference service.**
269
+ * - This operation infers the actual dimensions (lengths of two edges) and floor area of a floor display based on the provided overall display image, SKU knowledge base, and product location information in the image.
270
+ * - Make sure that the knowledge base corresponding to the specified `RagId` belongs to the caller and is in the available (`AVAILABLE`) state.
271
+ * - The `Products` array must contain at least one product item, and each product item must have at least one bounding box defined in `Boxes`.
272
+ * - All coordinate values are represented in a normalized coordinate system ranging from 0 to 1000. Make sure that the input satisfies the relationships `Left < Right` and `Top < Bottom`.
273
+ * - Set a reasonable timeout period when calling this operation (recommended not to exceed 300 seconds) to avoid failures caused by network latency or high processing complexity.
274
+ * - For calls in production environments, use the POP Action method. The internal REST address is primarily used for joint debugging during the development and testing phase.
275
+ *
276
+ * @param request - DiduiAreaDeductionRequest
277
+ * @returns DiduiAreaDeductionResponse
278
+ */
279
+ diduiAreaDeduction(request: $_model.DiduiAreaDeductionRequest): Promise<$_model.DiduiAreaDeductionResponse>;
245
280
  /**
246
281
  * Translates documents between more than 100 language pairs (including bridged pairs), supporting multi-scenario, multi-page, and highly complex document translation. Scanned documents are not currently supported. Excels in the following areas: - Content accuracy: translation accuracy, parameter and unit accuracy - Structural integrity: overall layout continuity, page margin and layout preservation.
247
282
  *
@@ -1140,6 +1175,43 @@ export default class Client extends OpenApi {
1140
1175
  * @returns PrepaidTextTranslateResponse
1141
1176
  */
1142
1177
  prepaidTextTranslate(request: $_model.PrepaidTextTranslateRequest): Promise<$_model.PrepaidTextTranslateResponse>;
1178
+ /**
1179
+ * Automatically identifies and locates specified products in an image based on a multimodal foundation model.
1180
+ *
1181
+ * @remarks
1182
+ * ## Request description
1183
+ * **Before using this operation, make sure that you fully understand the billing method and [pricing](https://www.aliyun.com/price/product#/ecs/detail) of the product hotzone recognition service.**
1184
+ * This API automatically identifies and locates specified products in a target scene image based on the provided target scene image and product reference images, and outputs the product name and normalized bounding box. Each request takes one target scene image and a set of product reference images. If the same case has multiple target images, call the operation separately for each target image.
1185
+ * ### Precautions
1186
+ * - Image URLs must use HTTPS and be accessible by the server.
1187
+ * - Common image formats such as JPEG, PNG, and WebP are supported.
1188
+ * - Each image should not exceed 2 MB.
1189
+ * - When using signed URLs, set the validity period to at least 30 minutes.
1190
+ * - If the same case has multiple target scene images, call the operation separately for each target image. The reference image list can be reused.
1191
+ *
1192
+ * @param tmpReq - ProductHotspotDetectionRequest
1193
+ * @param runtime - runtime options for this request RuntimeOptions
1194
+ * @returns ProductHotspotDetectionResponse
1195
+ */
1196
+ productHotspotDetectionWithOptions(tmpReq: $_model.ProductHotspotDetectionRequest, runtime: $dara.RuntimeOptions): Promise<$_model.ProductHotspotDetectionResponse>;
1197
+ /**
1198
+ * Automatically identifies and locates specified products in an image based on a multimodal foundation model.
1199
+ *
1200
+ * @remarks
1201
+ * ## Request description
1202
+ * **Before using this operation, make sure that you fully understand the billing method and [pricing](https://www.aliyun.com/price/product#/ecs/detail) of the product hotzone recognition service.**
1203
+ * This API automatically identifies and locates specified products in a target scene image based on the provided target scene image and product reference images, and outputs the product name and normalized bounding box. Each request takes one target scene image and a set of product reference images. If the same case has multiple target images, call the operation separately for each target image.
1204
+ * ### Precautions
1205
+ * - Image URLs must use HTTPS and be accessible by the server.
1206
+ * - Common image formats such as JPEG, PNG, and WebP are supported.
1207
+ * - Each image should not exceed 2 MB.
1208
+ * - When using signed URLs, set the validity period to at least 30 minutes.
1209
+ * - If the same case has multiple target scene images, call the operation separately for each target image. The reference image list can be reused.
1210
+ *
1211
+ * @param request - ProductHotspotDetectionRequest
1212
+ * @returns ProductHotspotDetectionResponse
1213
+ */
1214
+ productHotspotDetection(request: $_model.ProductHotspotDetectionRequest): Promise<$_model.ProductHotspotDetectionResponse>;
1143
1215
  /**
1144
1216
  * Queries the result of an asynchronous task. The API name on the POP gateway is QueryAsyncTaskResult.
1145
1217
  *
@@ -1572,25 +1644,25 @@ export default class Client extends OpenApi {
1572
1644
  */
1573
1645
  textTranslate(request: $_model.TextTranslateRequest): Promise<$_model.TextTranslateResponse>;
1574
1646
  /**
1575
- * The E-commerce AI Video Generation Agent is designed for e-commerce merchants and platforms. Based on product main images, titles, selling points, and other information, it automatically generates 5–30 second product showcase short videos, helping customers efficiently produce and distribute e-commerce content. The product supports multiple resolution outputs such as 720P and 1080P, supports both single-product quick calls and multi-product batch generation, catering to both daily operations and large-scale product content production needs. Currently, it covers all apparel categories (tops, pants, skirts, suits, underwear, swimwear, etc.) and is gradually expanding to skincare, cosmetics, food and beverages, home appliances, and other core e-commerce categories.
1647
+ * Invokes the e-commerce AI video generation agent for e-commerce merchants and platforms. Based on product main images, titles, selling points, and other information, it automatically generates 5–30 second product showcase short videos, helping customers efficiently produce and distribute e-commerce content. The service supports multiple resolution outputs such as 720P and 1080P, single-product quick invocation and multi-product batch generation, catering to both daily operations and large-scale product content production needs. Currently overwrites all apparel categories (tops, pants, skirts, suits, underwear, swimwear, etc.), and is gradually expanding to skincare, cosmetics, food and beverages, home appliances, and other core e-commerce categories.
1576
1648
  *
1577
1649
  * @remarks
1578
1650
  * # Scenarios
1579
- * - Sellers/platforms batch-generate product short videos: Supports multiple video aspect ratios and sizes (3:4, 9:16), suitable for product detail page video slots, product homepage displays, information feed placements, short video content marketing, campaign material, and other scenarios.
1580
- * - New product launches with rapid initial video material generation: When merchants have a large number of new products to list, they only need to upload product images and titles to quickly generate product showcase videos, model try-on videos, voiceover explanation videos, and other content, helping merchants rapidly complete material deployment during the launch phase.
1651
+ * - Batch generation of product short videos for sellers/platforms: Supports multiple video aspect ratios and sizes (3:4, 9:16), suitable for product detail page video slots, product homepage display, information feed placement, short video content marketing, campaign material, and other scenarios.
1652
+ * - Quick generation of initial video assets for new product launches: When merchants have a large number of new products to list, they only need to upload product images and titles to quickly generate product showcase videos, model try-on videos, voiceover explanation videos, and other content, helping merchants rapidly complete asset creation during the launch phase.
1581
1653
  * - High-fidelity apparel display: Generates model showcase videos that closely resemble real commercial photography based on product main images, with optimized capabilities for silhouette reproduction, fabric texture preservation, accurate color rendering, and consistent detail stability. Supports common e-commerce display methods such as garment try-on, turning, walking, close-up shots, and multi-angle switching.
1582
- * - High-quality commercial photography models: Includes 20+ built-in target audience model libraries covering plus-size women, plus-size men, swimwear, youthful style, smart casual commuter, young casual, business menswear, sports and fitness, and other body types, skin tones, and ethnicities. Supports standing poses, side views, walking displays, partial close-ups, and other commercial photography expressions.
1583
- * - Standard product explanations and other high-frequency e-commerce scenarios: Suitable for standardized product categories such as skincare, cosmetics, personal care small appliances, food and beverages, household cleaning products, and 3C digital products. Can quickly generate product explanation videos based on product main images, titles, selling point information, and explanation scripts.
1584
- * - Multi-product, multi-selling-point testing to improve placement efficiency: For information feed advertising, short video placement, and content marketing scenarios, quickly generates multiple versions of video materials, enabling enterprises to validate conversion effects of different selling points and presentation formats at low cost, improving placement ROI.
1654
+ * - High-quality commercial photography models: Includes 20+ built-in target audience model libraries covering plus-size women, plus-size men, swimwear, youthful style, smart casual commute, young casual, business menswear, sports and fitness, and other body types, skin tones, and ethnicities. Supports standing poses, side views, walking displays, partial close-ups, and other commercial photography expressions.
1655
+ * - Standard product explanation and other high-frequency e-commerce scenarios: Applicable to standardized product categories such as skincare, cosmetics, personal care small appliances, food and beverages, household cleaning products, and 3C digital products. Quickly generates product explanation videos based on product main images, titles, selling points, and explanation scripts.
1656
+ * - Multi-product and multi-selling-point testing to improve placement efficiency: For information feed advertising, short video placement, and content marketing scenarios, quickly generates multiple versions of video assets, enabling enterprises to validate conversion effects of different selling points and presentation formats at low cost, improving placement ROI.
1585
1657
  * # Features
1586
- * - Fully automated end-to-end batch generation with zero Prompt threshold: Callers only need to provide product image URLs and titles. The system automatically completes the entire process from product understanding, storyboard planning to video generation, without manual Prompt writing, template selection, or repeated parameter tuning. Built-in multi-Agent capabilities including product understanding, visual quality inspection, script planning, and cinematography direction significantly lower the usage barrier.
1587
- * - Highly stable generation with low discard rate: Uses a deterministic generation pipeline and multi-layer quality control mechanisms to output usable materials with fewer retries, reducing invalid generation and resource waste, making overall production costs more controllable.
1588
- * - E-commerce-specific product fidelity capability: Built-in multi-round quality inspection Agent locks product state throughout video generation (e.g., zippers won\\"t be unzipped, sleeves won\\"t be lowered, prints won\\"t disappear), ensuring product consistency through multi-layer defense of "script rewriting + explicit constraint injection + failure-aware retry."
1589
- * - Reference image priority + 6-axis consistency verification: Uses a Reference-Image-First generation paradigm with the original product image as the sole visual truth source. Automatically performs 6-dimensional VL diagnostics (color drift, pattern loss, contour deviation, structural addition/removal, model matching, stain detection), fundamentally preventing generated images from deviating from the product.
1590
- * - Flexible storyboard arrangement and duration control: Supports adjustable video duration of 5–30 seconds. The Agent autonomously plans independent storyboards to showcase product effects in different scenarios. Also supports fixed scene mode for in-depth product presentation under a unified visual style.
1658
+ * - Fully automated end-to-end batch generation with zero prompt threshold: Callers only need to provide product image URLs and titles. The system automatically completes the entire process from product understanding, storyboard planning, to video generation without manual prompt writing, template selection, or repeated parameter tuning. Built-in multi-agent capabilities including product understanding, visual quality inspection, script planning, and cinematography direction significantly lower the usage barrier.
1659
+ * - Highly stable generation with low waste rate: Uses a deterministic generation pipeline and multi-layer quality control mechanism to output usable assets with fewer retries, reducing invalid generation and resource waste, making overall production costs more controllable.
1660
+ * - E-commerce-specific product fidelity: Built-in multi-round quality inspection agents lock product state throughout video generation (e.g., zippers won\\"t be unzipped, sleeves won\\"t be lowered, prints won\\"t disappear), ensuring product consistency through multi-layer defense of "script rewriting + explicit constraint injection + failure-aware retry."
1661
+ * - Reference image priority + 6-axis consistency verification: Adopts a Reference-Image-First generation paradigm using the original product image as the sole visual truth source, automatically performing 6-dimensional VL diagnostics (color drift, pattern loss, contour deviation, structural addition/removal, model matching, stain detection), fundamentally eliminating the problem of generated images not resembling the product.
1662
+ * - Flexible storyboard arrangement and duration control: Supports adjustable video duration of 5–30 seconds. The agent autonomously plans independent storyboards to showcase product effects in different scenarios. Also supports fixed scene mode for in-depth product presentation under a unified visual style.
1591
1663
  * - Cinematic camera movement capabilities: Built-in advanced camera modes including bullet time, Grammy-style slow motion, 360° orbital rotation, and full-body model rotation display, achieving deterministic output through segmented precise control.
1592
- * - Model library and customization services: Built-in multi-type model resource library. Supports merchants specifying fixed models, customizing exclusive model personas, and long-term brand visual identity binding to ensure brand visual consistency.
1593
- * - Adapted for high-frequency e-commerce content scenarios: Supports multiple resolutions such as 720P and 1080P, and multiple aspect ratios such as 3:4 and 9:16. Suitable for product detail page video slots, product homepage video displays, waterfall/information feed placements, campaign materials, and new product and promotional video generation.
1664
+ * - Model library and customization services: Built-in multi-type model resource library supporting merchants in specifying fixed models, customizing exclusive model personas, and long-term brand visual identity binding to ensure brand visual consistency.
1665
+ * - Adapted to high-frequency e-commerce content scenarios: Supports multiple resolutions such as 720P and 1080P, and multiple aspect ratios such as 3:4 and 9:16, suitable for product detail page video slots, product homepage video display, waterfall/information feed placement, campaign material, and new product and promotional video generation.
1594
1666
  *
1595
1667
  * @param tmpReq - VideoGenerationRequest
1596
1668
  * @param runtime - runtime options for this request RuntimeOptions
@@ -1598,25 +1670,25 @@ export default class Client extends OpenApi {
1598
1670
  */
1599
1671
  videoGenerationWithOptions(tmpReq: $_model.VideoGenerationRequest, runtime: $dara.RuntimeOptions): Promise<$_model.VideoGenerationResponse>;
1600
1672
  /**
1601
- * The E-commerce AI Video Generation Agent is designed for e-commerce merchants and platforms. Based on product main images, titles, selling points, and other information, it automatically generates 5–30 second product showcase short videos, helping customers efficiently produce and distribute e-commerce content. The product supports multiple resolution outputs such as 720P and 1080P, supports both single-product quick calls and multi-product batch generation, catering to both daily operations and large-scale product content production needs. Currently, it covers all apparel categories (tops, pants, skirts, suits, underwear, swimwear, etc.) and is gradually expanding to skincare, cosmetics, food and beverages, home appliances, and other core e-commerce categories.
1673
+ * Invokes the e-commerce AI video generation agent for e-commerce merchants and platforms. Based on product main images, titles, selling points, and other information, it automatically generates 5–30 second product showcase short videos, helping customers efficiently produce and distribute e-commerce content. The service supports multiple resolution outputs such as 720P and 1080P, single-product quick invocation and multi-product batch generation, catering to both daily operations and large-scale product content production needs. Currently overwrites all apparel categories (tops, pants, skirts, suits, underwear, swimwear, etc.), and is gradually expanding to skincare, cosmetics, food and beverages, home appliances, and other core e-commerce categories.
1602
1674
  *
1603
1675
  * @remarks
1604
1676
  * # Scenarios
1605
- * - Sellers/platforms batch-generate product short videos: Supports multiple video aspect ratios and sizes (3:4, 9:16), suitable for product detail page video slots, product homepage displays, information feed placements, short video content marketing, campaign material, and other scenarios.
1606
- * - New product launches with rapid initial video material generation: When merchants have a large number of new products to list, they only need to upload product images and titles to quickly generate product showcase videos, model try-on videos, voiceover explanation videos, and other content, helping merchants rapidly complete material deployment during the launch phase.
1677
+ * - Batch generation of product short videos for sellers/platforms: Supports multiple video aspect ratios and sizes (3:4, 9:16), suitable for product detail page video slots, product homepage display, information feed placement, short video content marketing, campaign material, and other scenarios.
1678
+ * - Quick generation of initial video assets for new product launches: When merchants have a large number of new products to list, they only need to upload product images and titles to quickly generate product showcase videos, model try-on videos, voiceover explanation videos, and other content, helping merchants rapidly complete asset creation during the launch phase.
1607
1679
  * - High-fidelity apparel display: Generates model showcase videos that closely resemble real commercial photography based on product main images, with optimized capabilities for silhouette reproduction, fabric texture preservation, accurate color rendering, and consistent detail stability. Supports common e-commerce display methods such as garment try-on, turning, walking, close-up shots, and multi-angle switching.
1608
- * - High-quality commercial photography models: Includes 20+ built-in target audience model libraries covering plus-size women, plus-size men, swimwear, youthful style, smart casual commuter, young casual, business menswear, sports and fitness, and other body types, skin tones, and ethnicities. Supports standing poses, side views, walking displays, partial close-ups, and other commercial photography expressions.
1609
- * - Standard product explanations and other high-frequency e-commerce scenarios: Suitable for standardized product categories such as skincare, cosmetics, personal care small appliances, food and beverages, household cleaning products, and 3C digital products. Can quickly generate product explanation videos based on product main images, titles, selling point information, and explanation scripts.
1610
- * - Multi-product, multi-selling-point testing to improve placement efficiency: For information feed advertising, short video placement, and content marketing scenarios, quickly generates multiple versions of video materials, enabling enterprises to validate conversion effects of different selling points and presentation formats at low cost, improving placement ROI.
1680
+ * - High-quality commercial photography models: Includes 20+ built-in target audience model libraries covering plus-size women, plus-size men, swimwear, youthful style, smart casual commute, young casual, business menswear, sports and fitness, and other body types, skin tones, and ethnicities. Supports standing poses, side views, walking displays, partial close-ups, and other commercial photography expressions.
1681
+ * - Standard product explanation and other high-frequency e-commerce scenarios: Applicable to standardized product categories such as skincare, cosmetics, personal care small appliances, food and beverages, household cleaning products, and 3C digital products. Quickly generates product explanation videos based on product main images, titles, selling points, and explanation scripts.
1682
+ * - Multi-product and multi-selling-point testing to improve placement efficiency: For information feed advertising, short video placement, and content marketing scenarios, quickly generates multiple versions of video assets, enabling enterprises to validate conversion effects of different selling points and presentation formats at low cost, improving placement ROI.
1611
1683
  * # Features
1612
- * - Fully automated end-to-end batch generation with zero Prompt threshold: Callers only need to provide product image URLs and titles. The system automatically completes the entire process from product understanding, storyboard planning to video generation, without manual Prompt writing, template selection, or repeated parameter tuning. Built-in multi-Agent capabilities including product understanding, visual quality inspection, script planning, and cinematography direction significantly lower the usage barrier.
1613
- * - Highly stable generation with low discard rate: Uses a deterministic generation pipeline and multi-layer quality control mechanisms to output usable materials with fewer retries, reducing invalid generation and resource waste, making overall production costs more controllable.
1614
- * - E-commerce-specific product fidelity capability: Built-in multi-round quality inspection Agent locks product state throughout video generation (e.g., zippers won\\"t be unzipped, sleeves won\\"t be lowered, prints won\\"t disappear), ensuring product consistency through multi-layer defense of "script rewriting + explicit constraint injection + failure-aware retry."
1615
- * - Reference image priority + 6-axis consistency verification: Uses a Reference-Image-First generation paradigm with the original product image as the sole visual truth source. Automatically performs 6-dimensional VL diagnostics (color drift, pattern loss, contour deviation, structural addition/removal, model matching, stain detection), fundamentally preventing generated images from deviating from the product.
1616
- * - Flexible storyboard arrangement and duration control: Supports adjustable video duration of 5–30 seconds. The Agent autonomously plans independent storyboards to showcase product effects in different scenarios. Also supports fixed scene mode for in-depth product presentation under a unified visual style.
1684
+ * - Fully automated end-to-end batch generation with zero prompt threshold: Callers only need to provide product image URLs and titles. The system automatically completes the entire process from product understanding, storyboard planning, to video generation without manual prompt writing, template selection, or repeated parameter tuning. Built-in multi-agent capabilities including product understanding, visual quality inspection, script planning, and cinematography direction significantly lower the usage barrier.
1685
+ * - Highly stable generation with low waste rate: Uses a deterministic generation pipeline and multi-layer quality control mechanism to output usable assets with fewer retries, reducing invalid generation and resource waste, making overall production costs more controllable.
1686
+ * - E-commerce-specific product fidelity: Built-in multi-round quality inspection agents lock product state throughout video generation (e.g., zippers won\\"t be unzipped, sleeves won\\"t be lowered, prints won\\"t disappear), ensuring product consistency through multi-layer defense of "script rewriting + explicit constraint injection + failure-aware retry."
1687
+ * - Reference image priority + 6-axis consistency verification: Adopts a Reference-Image-First generation paradigm using the original product image as the sole visual truth source, automatically performing 6-dimensional VL diagnostics (color drift, pattern loss, contour deviation, structural addition/removal, model matching, stain detection), fundamentally eliminating the problem of generated images not resembling the product.
1688
+ * - Flexible storyboard arrangement and duration control: Supports adjustable video duration of 5–30 seconds. The agent autonomously plans independent storyboards to showcase product effects in different scenarios. Also supports fixed scene mode for in-depth product presentation under a unified visual style.
1617
1689
  * - Cinematic camera movement capabilities: Built-in advanced camera modes including bullet time, Grammy-style slow motion, 360° orbital rotation, and full-body model rotation display, achieving deterministic output through segmented precise control.
1618
- * - Model library and customization services: Built-in multi-type model resource library. Supports merchants specifying fixed models, customizing exclusive model personas, and long-term brand visual identity binding to ensure brand visual consistency.
1619
- * - Adapted for high-frequency e-commerce content scenarios: Supports multiple resolutions such as 720P and 1080P, and multiple aspect ratios such as 3:4 and 9:16. Suitable for product detail page video slots, product homepage video displays, waterfall/information feed placements, campaign materials, and new product and promotional video generation.
1690
+ * - Model library and customization services: Built-in multi-type model resource library supporting merchants in specifying fixed models, customizing exclusive model personas, and long-term brand visual identity binding to ensure brand visual consistency.
1691
+ * - Adapted to high-frequency e-commerce content scenarios: Supports multiple resolutions such as 720P and 1080P, and multiple aspect ratios such as 3:4 and 9:16, suitable for product detail page video slots, product homepage video display, waterfall/information feed placement, campaign material, and new product and promotional video generation.
1620
1692
  *
1621
1693
  * @param request - VideoGenerationRequest
1622
1694
  * @returns VideoGenerationResponse
package/dist/client.js CHANGED
@@ -500,6 +500,79 @@ class Client extends openapi_core_1.default {
500
500
  let runtime = new $dara.RuntimeOptions({});
501
501
  return await this.categoryMatchWithOptions(request, runtime);
502
502
  }
503
+ /**
504
+ * Calculates the edge lengths and floor area of a floor display based on the display image and product detection boxes.
505
+ *
506
+ * @remarks
507
+ * ## Description
508
+ * **Before using this operation, make sure that you fully understand the billing method and [pricing](https://www.aliyun.com/price/product#/ecs/detail) of the floor display area inference service.**
509
+ * - This operation infers the actual dimensions (lengths of two edges) and floor area of a floor display based on the provided overall display image, SKU knowledge base, and product location information in the image.
510
+ * - Make sure that the knowledge base corresponding to the specified `RagId` belongs to the caller and is in the available (`AVAILABLE`) state.
511
+ * - The `Products` array must contain at least one product item, and each product item must have at least one bounding box defined in `Boxes`.
512
+ * - All coordinate values are represented in a normalized coordinate system ranging from 0 to 1000. Make sure that the input satisfies the relationships `Left < Right` and `Top < Bottom`.
513
+ * - Set a reasonable timeout period when calling this operation (recommended not to exceed 300 seconds) to avoid failures caused by network latency or high processing complexity.
514
+ * - For calls in production environments, use the POP Action method. The internal REST address is primarily used for joint debugging during the development and testing phase.
515
+ *
516
+ * @param tmpReq - DiduiAreaDeductionRequest
517
+ * @param runtime - runtime options for this request RuntimeOptions
518
+ * @returns DiduiAreaDeductionResponse
519
+ */
520
+ async diduiAreaDeductionWithOptions(tmpReq, runtime) {
521
+ tmpReq.validate();
522
+ let request = new $_model.DiduiAreaDeductionShrinkRequest({});
523
+ openapi_core_2.OpenApiUtil.convert(tmpReq, request);
524
+ if (!$dara.isNull(tmpReq.products)) {
525
+ request.productsShrink = openapi_core_2.OpenApiUtil.arrayToStringWithSpecifiedStyle(tmpReq.products, "Products", "json");
526
+ }
527
+ let query = {};
528
+ if (!$dara.isNull(request.productsShrink)) {
529
+ query["Products"] = request.productsShrink;
530
+ }
531
+ if (!$dara.isNull(request.ragId)) {
532
+ query["RagId"] = request.ragId;
533
+ }
534
+ if (!$dara.isNull(request.reqId)) {
535
+ query["ReqId"] = request.reqId;
536
+ }
537
+ if (!$dara.isNull(request.targetImageUrl)) {
538
+ query["TargetImageUrl"] = request.targetImageUrl;
539
+ }
540
+ let req = new openapi_core_2.$OpenApiUtil.OpenApiRequest({
541
+ query: openapi_core_2.OpenApiUtil.query(query),
542
+ });
543
+ let params = new openapi_core_2.$OpenApiUtil.Params({
544
+ action: "DiduiAreaDeduction",
545
+ version: "2026-04-28",
546
+ protocol: "HTTPS",
547
+ pathname: "/",
548
+ method: "POST",
549
+ authType: "AK",
550
+ style: "RPC",
551
+ reqBodyType: "formData",
552
+ bodyType: "json",
553
+ });
554
+ return $dara.cast(await this.callApi(params, req, runtime), new $_model.DiduiAreaDeductionResponse({}));
555
+ }
556
+ /**
557
+ * Calculates the edge lengths and floor area of a floor display based on the display image and product detection boxes.
558
+ *
559
+ * @remarks
560
+ * ## Description
561
+ * **Before using this operation, make sure that you fully understand the billing method and [pricing](https://www.aliyun.com/price/product#/ecs/detail) of the floor display area inference service.**
562
+ * - This operation infers the actual dimensions (lengths of two edges) and floor area of a floor display based on the provided overall display image, SKU knowledge base, and product location information in the image.
563
+ * - Make sure that the knowledge base corresponding to the specified `RagId` belongs to the caller and is in the available (`AVAILABLE`) state.
564
+ * - The `Products` array must contain at least one product item, and each product item must have at least one bounding box defined in `Boxes`.
565
+ * - All coordinate values are represented in a normalized coordinate system ranging from 0 to 1000. Make sure that the input satisfies the relationships `Left < Right` and `Top < Bottom`.
566
+ * - Set a reasonable timeout period when calling this operation (recommended not to exceed 300 seconds) to avoid failures caused by network latency or high processing complexity.
567
+ * - For calls in production environments, use the POP Action method. The internal REST address is primarily used for joint debugging during the development and testing phase.
568
+ *
569
+ * @param request - DiduiAreaDeductionRequest
570
+ * @returns DiduiAreaDeductionResponse
571
+ */
572
+ async diduiAreaDeduction(request) {
573
+ let runtime = new $dara.RuntimeOptions({});
574
+ return await this.diduiAreaDeductionWithOptions(request, runtime);
575
+ }
503
576
  /**
504
577
  * Translates documents between more than 100 language pairs (including bridged pairs), supporting multi-scenario, multi-page, and highly complex document translation. Scanned documents are not currently supported. Excels in the following areas: - Content accuracy: translation accuracy, parameter and unit accuracy - Structural integrity: overall layout continuity, page margin and layout preservation.
505
578
  *
@@ -1149,6 +1222,12 @@ class Client extends openapi_core_1.default {
1149
1222
  if (!$dara.isNull(tmpReq.objectRemoveElements)) {
1150
1223
  request.objectRemoveElementsShrink = openapi_core_2.OpenApiUtil.arrayToStringWithSpecifiedStyle(tmpReq.objectRemoveElements, "ObjectRemoveElements", "json");
1151
1224
  }
1225
+ if (!$dara.isNull(tmpReq.userImage)) {
1226
+ request.userImageShrink = openapi_core_2.OpenApiUtil.arrayToStringWithSpecifiedStyle(tmpReq.userImage, "UserImage", "json");
1227
+ }
1228
+ if (!$dara.isNull(tmpReq.userText)) {
1229
+ request.userTextShrink = openapi_core_2.OpenApiUtil.arrayToStringWithSpecifiedStyle(tmpReq.userText, "UserText", "json");
1230
+ }
1152
1231
  let query = {};
1153
1232
  if (!$dara.isNull(request.imageUrl)) {
1154
1233
  query["ImageUrl"] = request.imageUrl;
@@ -1162,6 +1241,15 @@ class Client extends openapi_core_1.default {
1162
1241
  if (!$dara.isNull(request.objectRemoveElementsShrink)) {
1163
1242
  query["ObjectRemoveElements"] = request.objectRemoveElementsShrink;
1164
1243
  }
1244
+ if (!$dara.isNull(request.position)) {
1245
+ query["Position"] = request.position;
1246
+ }
1247
+ if (!$dara.isNull(request.userImageShrink)) {
1248
+ query["UserImage"] = request.userImageShrink;
1249
+ }
1250
+ if (!$dara.isNull(request.userTextShrink)) {
1251
+ query["UserText"] = request.userTextShrink;
1252
+ }
1165
1253
  let req = new openapi_core_2.$OpenApiUtil.OpenApiRequest({
1166
1254
  query: openapi_core_2.OpenApiUtil.query(query),
1167
1255
  });
@@ -1914,6 +2002,78 @@ class Client extends openapi_core_1.default {
1914
2002
  let runtime = new $dara.RuntimeOptions({});
1915
2003
  return await this.prepaidTextTranslateWithOptions(request, runtime);
1916
2004
  }
2005
+ /**
2006
+ * Automatically identifies and locates specified products in an image based on a multimodal foundation model.
2007
+ *
2008
+ * @remarks
2009
+ * ## Request description
2010
+ * **Before using this operation, make sure that you fully understand the billing method and [pricing](https://www.aliyun.com/price/product#/ecs/detail) of the product hotzone recognition service.**
2011
+ * This API automatically identifies and locates specified products in a target scene image based on the provided target scene image and product reference images, and outputs the product name and normalized bounding box. Each request takes one target scene image and a set of product reference images. If the same case has multiple target images, call the operation separately for each target image.
2012
+ * ### Precautions
2013
+ * - Image URLs must use HTTPS and be accessible by the server.
2014
+ * - Common image formats such as JPEG, PNG, and WebP are supported.
2015
+ * - Each image should not exceed 2 MB.
2016
+ * - When using signed URLs, set the validity period to at least 30 minutes.
2017
+ * - If the same case has multiple target scene images, call the operation separately for each target image. The reference image list can be reused.
2018
+ *
2019
+ * @param tmpReq - ProductHotspotDetectionRequest
2020
+ * @param runtime - runtime options for this request RuntimeOptions
2021
+ * @returns ProductHotspotDetectionResponse
2022
+ */
2023
+ async productHotspotDetectionWithOptions(tmpReq, runtime) {
2024
+ tmpReq.validate();
2025
+ let request = new $_model.ProductHotspotDetectionShrinkRequest({});
2026
+ openapi_core_2.OpenApiUtil.convert(tmpReq, request);
2027
+ if (!$dara.isNull(tmpReq.referenceImageUrls)) {
2028
+ request.referenceImageUrlsShrink = openapi_core_2.OpenApiUtil.arrayToStringWithSpecifiedStyle(tmpReq.referenceImageUrls, "ReferenceImageUrls", "json");
2029
+ }
2030
+ let query = {};
2031
+ if (!$dara.isNull(request.referenceImageUrlsShrink)) {
2032
+ query["ReferenceImageUrls"] = request.referenceImageUrlsShrink;
2033
+ }
2034
+ if (!$dara.isNull(request.reqId)) {
2035
+ query["ReqId"] = request.reqId;
2036
+ }
2037
+ if (!$dara.isNull(request.targetImageUrl)) {
2038
+ query["TargetImageUrl"] = request.targetImageUrl;
2039
+ }
2040
+ let req = new openapi_core_2.$OpenApiUtil.OpenApiRequest({
2041
+ query: openapi_core_2.OpenApiUtil.query(query),
2042
+ });
2043
+ let params = new openapi_core_2.$OpenApiUtil.Params({
2044
+ action: "ProductHotspotDetection",
2045
+ version: "2026-04-28",
2046
+ protocol: "HTTPS",
2047
+ pathname: "/",
2048
+ method: "POST",
2049
+ authType: "AK",
2050
+ style: "RPC",
2051
+ reqBodyType: "formData",
2052
+ bodyType: "json",
2053
+ });
2054
+ return $dara.cast(await this.callApi(params, req, runtime), new $_model.ProductHotspotDetectionResponse({}));
2055
+ }
2056
+ /**
2057
+ * Automatically identifies and locates specified products in an image based on a multimodal foundation model.
2058
+ *
2059
+ * @remarks
2060
+ * ## Request description
2061
+ * **Before using this operation, make sure that you fully understand the billing method and [pricing](https://www.aliyun.com/price/product#/ecs/detail) of the product hotzone recognition service.**
2062
+ * This API automatically identifies and locates specified products in a target scene image based on the provided target scene image and product reference images, and outputs the product name and normalized bounding box. Each request takes one target scene image and a set of product reference images. If the same case has multiple target images, call the operation separately for each target image.
2063
+ * ### Precautions
2064
+ * - Image URLs must use HTTPS and be accessible by the server.
2065
+ * - Common image formats such as JPEG, PNG, and WebP are supported.
2066
+ * - Each image should not exceed 2 MB.
2067
+ * - When using signed URLs, set the validity period to at least 30 minutes.
2068
+ * - If the same case has multiple target scene images, call the operation separately for each target image. The reference image list can be reused.
2069
+ *
2070
+ * @param request - ProductHotspotDetectionRequest
2071
+ * @returns ProductHotspotDetectionResponse
2072
+ */
2073
+ async productHotspotDetection(request) {
2074
+ let runtime = new $dara.RuntimeOptions({});
2075
+ return await this.productHotspotDetectionWithOptions(request, runtime);
2076
+ }
1917
2077
  /**
1918
2078
  * Queries the result of an asynchronous task. The API name on the POP gateway is QueryAsyncTaskResult.
1919
2079
  *
@@ -2506,25 +2666,25 @@ class Client extends openapi_core_1.default {
2506
2666
  return await this.textTranslateWithOptions(request, runtime);
2507
2667
  }
2508
2668
  /**
2509
- * The E-commerce AI Video Generation Agent is designed for e-commerce merchants and platforms. Based on product main images, titles, selling points, and other information, it automatically generates 5–30 second product showcase short videos, helping customers efficiently produce and distribute e-commerce content. The product supports multiple resolution outputs such as 720P and 1080P, supports both single-product quick calls and multi-product batch generation, catering to both daily operations and large-scale product content production needs. Currently, it covers all apparel categories (tops, pants, skirts, suits, underwear, swimwear, etc.) and is gradually expanding to skincare, cosmetics, food and beverages, home appliances, and other core e-commerce categories.
2669
+ * Invokes the e-commerce AI video generation agent for e-commerce merchants and platforms. Based on product main images, titles, selling points, and other information, it automatically generates 5–30 second product showcase short videos, helping customers efficiently produce and distribute e-commerce content. The service supports multiple resolution outputs such as 720P and 1080P, single-product quick invocation and multi-product batch generation, catering to both daily operations and large-scale product content production needs. Currently overwrites all apparel categories (tops, pants, skirts, suits, underwear, swimwear, etc.), and is gradually expanding to skincare, cosmetics, food and beverages, home appliances, and other core e-commerce categories.
2510
2670
  *
2511
2671
  * @remarks
2512
2672
  * # Scenarios
2513
- * - Sellers/platforms batch-generate product short videos: Supports multiple video aspect ratios and sizes (3:4, 9:16), suitable for product detail page video slots, product homepage displays, information feed placements, short video content marketing, campaign material, and other scenarios.
2514
- * - New product launches with rapid initial video material generation: When merchants have a large number of new products to list, they only need to upload product images and titles to quickly generate product showcase videos, model try-on videos, voiceover explanation videos, and other content, helping merchants rapidly complete material deployment during the launch phase.
2673
+ * - Batch generation of product short videos for sellers/platforms: Supports multiple video aspect ratios and sizes (3:4, 9:16), suitable for product detail page video slots, product homepage display, information feed placement, short video content marketing, campaign material, and other scenarios.
2674
+ * - Quick generation of initial video assets for new product launches: When merchants have a large number of new products to list, they only need to upload product images and titles to quickly generate product showcase videos, model try-on videos, voiceover explanation videos, and other content, helping merchants rapidly complete asset creation during the launch phase.
2515
2675
  * - High-fidelity apparel display: Generates model showcase videos that closely resemble real commercial photography based on product main images, with optimized capabilities for silhouette reproduction, fabric texture preservation, accurate color rendering, and consistent detail stability. Supports common e-commerce display methods such as garment try-on, turning, walking, close-up shots, and multi-angle switching.
2516
- * - High-quality commercial photography models: Includes 20+ built-in target audience model libraries covering plus-size women, plus-size men, swimwear, youthful style, smart casual commuter, young casual, business menswear, sports and fitness, and other body types, skin tones, and ethnicities. Supports standing poses, side views, walking displays, partial close-ups, and other commercial photography expressions.
2517
- * - Standard product explanations and other high-frequency e-commerce scenarios: Suitable for standardized product categories such as skincare, cosmetics, personal care small appliances, food and beverages, household cleaning products, and 3C digital products. Can quickly generate product explanation videos based on product main images, titles, selling point information, and explanation scripts.
2518
- * - Multi-product, multi-selling-point testing to improve placement efficiency: For information feed advertising, short video placement, and content marketing scenarios, quickly generates multiple versions of video materials, enabling enterprises to validate conversion effects of different selling points and presentation formats at low cost, improving placement ROI.
2676
+ * - High-quality commercial photography models: Includes 20+ built-in target audience model libraries covering plus-size women, plus-size men, swimwear, youthful style, smart casual commute, young casual, business menswear, sports and fitness, and other body types, skin tones, and ethnicities. Supports standing poses, side views, walking displays, partial close-ups, and other commercial photography expressions.
2677
+ * - Standard product explanation and other high-frequency e-commerce scenarios: Applicable to standardized product categories such as skincare, cosmetics, personal care small appliances, food and beverages, household cleaning products, and 3C digital products. Quickly generates product explanation videos based on product main images, titles, selling points, and explanation scripts.
2678
+ * - Multi-product and multi-selling-point testing to improve placement efficiency: For information feed advertising, short video placement, and content marketing scenarios, quickly generates multiple versions of video assets, enabling enterprises to validate conversion effects of different selling points and presentation formats at low cost, improving placement ROI.
2519
2679
  * # Features
2520
- * - Fully automated end-to-end batch generation with zero Prompt threshold: Callers only need to provide product image URLs and titles. The system automatically completes the entire process from product understanding, storyboard planning to video generation, without manual Prompt writing, template selection, or repeated parameter tuning. Built-in multi-Agent capabilities including product understanding, visual quality inspection, script planning, and cinematography direction significantly lower the usage barrier.
2521
- * - Highly stable generation with low discard rate: Uses a deterministic generation pipeline and multi-layer quality control mechanisms to output usable materials with fewer retries, reducing invalid generation and resource waste, making overall production costs more controllable.
2522
- * - E-commerce-specific product fidelity capability: Built-in multi-round quality inspection Agent locks product state throughout video generation (e.g., zippers won\\"t be unzipped, sleeves won\\"t be lowered, prints won\\"t disappear), ensuring product consistency through multi-layer defense of "script rewriting + explicit constraint injection + failure-aware retry."
2523
- * - Reference image priority + 6-axis consistency verification: Uses a Reference-Image-First generation paradigm with the original product image as the sole visual truth source. Automatically performs 6-dimensional VL diagnostics (color drift, pattern loss, contour deviation, structural addition/removal, model matching, stain detection), fundamentally preventing generated images from deviating from the product.
2524
- * - Flexible storyboard arrangement and duration control: Supports adjustable video duration of 5–30 seconds. The Agent autonomously plans independent storyboards to showcase product effects in different scenarios. Also supports fixed scene mode for in-depth product presentation under a unified visual style.
2680
+ * - Fully automated end-to-end batch generation with zero prompt threshold: Callers only need to provide product image URLs and titles. The system automatically completes the entire process from product understanding, storyboard planning, to video generation without manual prompt writing, template selection, or repeated parameter tuning. Built-in multi-agent capabilities including product understanding, visual quality inspection, script planning, and cinematography direction significantly lower the usage barrier.
2681
+ * - Highly stable generation with low waste rate: Uses a deterministic generation pipeline and multi-layer quality control mechanism to output usable assets with fewer retries, reducing invalid generation and resource waste, making overall production costs more controllable.
2682
+ * - E-commerce-specific product fidelity: Built-in multi-round quality inspection agents lock product state throughout video generation (e.g., zippers won\\"t be unzipped, sleeves won\\"t be lowered, prints won\\"t disappear), ensuring product consistency through multi-layer defense of "script rewriting + explicit constraint injection + failure-aware retry."
2683
+ * - Reference image priority + 6-axis consistency verification: Adopts a Reference-Image-First generation paradigm using the original product image as the sole visual truth source, automatically performing 6-dimensional VL diagnostics (color drift, pattern loss, contour deviation, structural addition/removal, model matching, stain detection), fundamentally eliminating the problem of generated images not resembling the product.
2684
+ * - Flexible storyboard arrangement and duration control: Supports adjustable video duration of 5–30 seconds. The agent autonomously plans independent storyboards to showcase product effects in different scenarios. Also supports fixed scene mode for in-depth product presentation under a unified visual style.
2525
2685
  * - Cinematic camera movement capabilities: Built-in advanced camera modes including bullet time, Grammy-style slow motion, 360° orbital rotation, and full-body model rotation display, achieving deterministic output through segmented precise control.
2526
- * - Model library and customization services: Built-in multi-type model resource library. Supports merchants specifying fixed models, customizing exclusive model personas, and long-term brand visual identity binding to ensure brand visual consistency.
2527
- * - Adapted for high-frequency e-commerce content scenarios: Supports multiple resolutions such as 720P and 1080P, and multiple aspect ratios such as 3:4 and 9:16. Suitable for product detail page video slots, product homepage video displays, waterfall/information feed placements, campaign materials, and new product and promotional video generation.
2686
+ * - Model library and customization services: Built-in multi-type model resource library supporting merchants in specifying fixed models, customizing exclusive model personas, and long-term brand visual identity binding to ensure brand visual consistency.
2687
+ * - Adapted to high-frequency e-commerce content scenarios: Supports multiple resolutions such as 720P and 1080P, and multiple aspect ratios such as 3:4 and 9:16, suitable for product detail page video slots, product homepage video display, waterfall/information feed placement, campaign material, and new product and promotional video generation.
2528
2688
  *
2529
2689
  * @param tmpReq - VideoGenerationRequest
2530
2690
  * @param runtime - runtime options for this request RuntimeOptions
@@ -2570,25 +2730,25 @@ class Client extends openapi_core_1.default {
2570
2730
  return $dara.cast(await this.callApi(params, req, runtime), new $_model.VideoGenerationResponse({}));
2571
2731
  }
2572
2732
  /**
2573
- * The E-commerce AI Video Generation Agent is designed for e-commerce merchants and platforms. Based on product main images, titles, selling points, and other information, it automatically generates 5–30 second product showcase short videos, helping customers efficiently produce and distribute e-commerce content. The product supports multiple resolution outputs such as 720P and 1080P, supports both single-product quick calls and multi-product batch generation, catering to both daily operations and large-scale product content production needs. Currently, it covers all apparel categories (tops, pants, skirts, suits, underwear, swimwear, etc.) and is gradually expanding to skincare, cosmetics, food and beverages, home appliances, and other core e-commerce categories.
2733
+ * Invokes the e-commerce AI video generation agent for e-commerce merchants and platforms. Based on product main images, titles, selling points, and other information, it automatically generates 5–30 second product showcase short videos, helping customers efficiently produce and distribute e-commerce content. The service supports multiple resolution outputs such as 720P and 1080P, single-product quick invocation and multi-product batch generation, catering to both daily operations and large-scale product content production needs. Currently overwrites all apparel categories (tops, pants, skirts, suits, underwear, swimwear, etc.), and is gradually expanding to skincare, cosmetics, food and beverages, home appliances, and other core e-commerce categories.
2574
2734
  *
2575
2735
  * @remarks
2576
2736
  * # Scenarios
2577
- * - Sellers/platforms batch-generate product short videos: Supports multiple video aspect ratios and sizes (3:4, 9:16), suitable for product detail page video slots, product homepage displays, information feed placements, short video content marketing, campaign material, and other scenarios.
2578
- * - New product launches with rapid initial video material generation: When merchants have a large number of new products to list, they only need to upload product images and titles to quickly generate product showcase videos, model try-on videos, voiceover explanation videos, and other content, helping merchants rapidly complete material deployment during the launch phase.
2737
+ * - Batch generation of product short videos for sellers/platforms: Supports multiple video aspect ratios and sizes (3:4, 9:16), suitable for product detail page video slots, product homepage display, information feed placement, short video content marketing, campaign material, and other scenarios.
2738
+ * - Quick generation of initial video assets for new product launches: When merchants have a large number of new products to list, they only need to upload product images and titles to quickly generate product showcase videos, model try-on videos, voiceover explanation videos, and other content, helping merchants rapidly complete asset creation during the launch phase.
2579
2739
  * - High-fidelity apparel display: Generates model showcase videos that closely resemble real commercial photography based on product main images, with optimized capabilities for silhouette reproduction, fabric texture preservation, accurate color rendering, and consistent detail stability. Supports common e-commerce display methods such as garment try-on, turning, walking, close-up shots, and multi-angle switching.
2580
- * - High-quality commercial photography models: Includes 20+ built-in target audience model libraries covering plus-size women, plus-size men, swimwear, youthful style, smart casual commuter, young casual, business menswear, sports and fitness, and other body types, skin tones, and ethnicities. Supports standing poses, side views, walking displays, partial close-ups, and other commercial photography expressions.
2581
- * - Standard product explanations and other high-frequency e-commerce scenarios: Suitable for standardized product categories such as skincare, cosmetics, personal care small appliances, food and beverages, household cleaning products, and 3C digital products. Can quickly generate product explanation videos based on product main images, titles, selling point information, and explanation scripts.
2582
- * - Multi-product, multi-selling-point testing to improve placement efficiency: For information feed advertising, short video placement, and content marketing scenarios, quickly generates multiple versions of video materials, enabling enterprises to validate conversion effects of different selling points and presentation formats at low cost, improving placement ROI.
2740
+ * - High-quality commercial photography models: Includes 20+ built-in target audience model libraries covering plus-size women, plus-size men, swimwear, youthful style, smart casual commute, young casual, business menswear, sports and fitness, and other body types, skin tones, and ethnicities. Supports standing poses, side views, walking displays, partial close-ups, and other commercial photography expressions.
2741
+ * - Standard product explanation and other high-frequency e-commerce scenarios: Applicable to standardized product categories such as skincare, cosmetics, personal care small appliances, food and beverages, household cleaning products, and 3C digital products. Quickly generates product explanation videos based on product main images, titles, selling points, and explanation scripts.
2742
+ * - Multi-product and multi-selling-point testing to improve placement efficiency: For information feed advertising, short video placement, and content marketing scenarios, quickly generates multiple versions of video assets, enabling enterprises to validate conversion effects of different selling points and presentation formats at low cost, improving placement ROI.
2583
2743
  * # Features
2584
- * - Fully automated end-to-end batch generation with zero Prompt threshold: Callers only need to provide product image URLs and titles. The system automatically completes the entire process from product understanding, storyboard planning to video generation, without manual Prompt writing, template selection, or repeated parameter tuning. Built-in multi-Agent capabilities including product understanding, visual quality inspection, script planning, and cinematography direction significantly lower the usage barrier.
2585
- * - Highly stable generation with low discard rate: Uses a deterministic generation pipeline and multi-layer quality control mechanisms to output usable materials with fewer retries, reducing invalid generation and resource waste, making overall production costs more controllable.
2586
- * - E-commerce-specific product fidelity capability: Built-in multi-round quality inspection Agent locks product state throughout video generation (e.g., zippers won\\"t be unzipped, sleeves won\\"t be lowered, prints won\\"t disappear), ensuring product consistency through multi-layer defense of "script rewriting + explicit constraint injection + failure-aware retry."
2587
- * - Reference image priority + 6-axis consistency verification: Uses a Reference-Image-First generation paradigm with the original product image as the sole visual truth source. Automatically performs 6-dimensional VL diagnostics (color drift, pattern loss, contour deviation, structural addition/removal, model matching, stain detection), fundamentally preventing generated images from deviating from the product.
2588
- * - Flexible storyboard arrangement and duration control: Supports adjustable video duration of 5–30 seconds. The Agent autonomously plans independent storyboards to showcase product effects in different scenarios. Also supports fixed scene mode for in-depth product presentation under a unified visual style.
2744
+ * - Fully automated end-to-end batch generation with zero prompt threshold: Callers only need to provide product image URLs and titles. The system automatically completes the entire process from product understanding, storyboard planning, to video generation without manual prompt writing, template selection, or repeated parameter tuning. Built-in multi-agent capabilities including product understanding, visual quality inspection, script planning, and cinematography direction significantly lower the usage barrier.
2745
+ * - Highly stable generation with low waste rate: Uses a deterministic generation pipeline and multi-layer quality control mechanism to output usable assets with fewer retries, reducing invalid generation and resource waste, making overall production costs more controllable.
2746
+ * - E-commerce-specific product fidelity: Built-in multi-round quality inspection agents lock product state throughout video generation (e.g., zippers won\\"t be unzipped, sleeves won\\"t be lowered, prints won\\"t disappear), ensuring product consistency through multi-layer defense of "script rewriting + explicit constraint injection + failure-aware retry."
2747
+ * - Reference image priority + 6-axis consistency verification: Adopts a Reference-Image-First generation paradigm using the original product image as the sole visual truth source, automatically performing 6-dimensional VL diagnostics (color drift, pattern loss, contour deviation, structural addition/removal, model matching, stain detection), fundamentally eliminating the problem of generated images not resembling the product.
2748
+ * - Flexible storyboard arrangement and duration control: Supports adjustable video duration of 5–30 seconds. The agent autonomously plans independent storyboards to showcase product effects in different scenarios. Also supports fixed scene mode for in-depth product presentation under a unified visual style.
2589
2749
  * - Cinematic camera movement capabilities: Built-in advanced camera modes including bullet time, Grammy-style slow motion, 360° orbital rotation, and full-body model rotation display, achieving deterministic output through segmented precise control.
2590
- * - Model library and customization services: Built-in multi-type model resource library. Supports merchants specifying fixed models, customizing exclusive model personas, and long-term brand visual identity binding to ensure brand visual consistency.
2591
- * - Adapted for high-frequency e-commerce content scenarios: Supports multiple resolutions such as 720P and 1080P, and multiple aspect ratios such as 3:4 and 9:16. Suitable for product detail page video slots, product homepage video displays, waterfall/information feed placements, campaign materials, and new product and promotional video generation.
2750
+ * - Model library and customization services: Built-in multi-type model resource library supporting merchants in specifying fixed models, customizing exclusive model personas, and long-term brand visual identity binding to ensure brand visual consistency.
2751
+ * - Adapted to high-frequency e-commerce content scenarios: Supports multiple resolutions such as 720P and 1080P, and multiple aspect ratios such as 3:4 and 9:16, suitable for product detail page video slots, product homepage video display, waterfall/information feed placement, campaign material, and new product and promotional video generation.
2592
2752
  *
2593
2753
  * @param request - VideoGenerationRequest
2594
2754
  * @returns VideoGenerationResponse