@alicloud/aidge20260428 5.3.2 → 5.4.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.
Files changed (34) hide show
  1. package/dist/client.d.ts +97 -36
  2. package/dist/client.js +132 -39
  3. package/dist/client.js.map +1 -1
  4. package/dist/models/EcomVideoRecreationRequest.d.ts +156 -0
  5. package/dist/models/EcomVideoRecreationRequest.js +150 -0
  6. package/dist/models/EcomVideoRecreationRequest.js.map +1 -0
  7. package/dist/models/EcomVideoRecreationResponse.d.ts +19 -0
  8. package/dist/models/EcomVideoRecreationResponse.js +69 -0
  9. package/dist/models/EcomVideoRecreationResponse.js.map +1 -0
  10. package/dist/models/EcomVideoRecreationResponseBody.d.ts +70 -0
  11. package/dist/models/EcomVideoRecreationResponseBody.js +88 -0
  12. package/dist/models/EcomVideoRecreationResponseBody.js.map +1 -0
  13. package/dist/models/EcomVideoRecreationShrinkRequest.d.ts +25 -0
  14. package/dist/models/EcomVideoRecreationShrinkRequest.js +60 -0
  15. package/dist/models/EcomVideoRecreationShrinkRequest.js.map +1 -0
  16. package/dist/models/LanguageDetectRequest.d.ts +1 -1
  17. package/dist/models/LanguageDetectResponseBody.d.ts +2 -2
  18. package/dist/models/VideoGenerationRequest.d.ts +45 -8
  19. package/dist/models/VideoGenerationRequest.js.map +1 -1
  20. package/dist/models/VideoGenerationResponseBody.d.ts +5 -5
  21. package/dist/models/model.d.ts +8 -0
  22. package/dist/models/model.js +20 -4
  23. package/dist/models/model.js.map +1 -1
  24. package/package.json +1 -1
  25. package/src/client.ts +138 -39
  26. package/src/models/EcomVideoRecreationRequest.ts +234 -0
  27. package/src/models/EcomVideoRecreationResponse.ts +40 -0
  28. package/src/models/EcomVideoRecreationResponseBody.ts +104 -0
  29. package/src/models/EcomVideoRecreationShrinkRequest.ts +40 -0
  30. package/src/models/LanguageDetectRequest.ts +1 -1
  31. package/src/models/LanguageDetectResponseBody.ts +2 -2
  32. package/src/models/VideoGenerationRequest.ts +45 -8
  33. package/src/models/VideoGenerationResponseBody.ts +5 -5
  34. package/src/models/model.ts +8 -0
package/src/client.ts CHANGED
@@ -12,9 +12,6 @@ export default class Client extends OpenApi {
12
12
  constructor(config: $OpenApiUtil.Config) {
13
13
  super(config);
14
14
  this._endpointRule = "regional";
15
- this._endpointMap = {
16
- 'cn-beijing': "aidge.cn-beijing.aliyuncs.com",
17
- };
18
15
  this.checkConfig(config);
19
16
  this._endpoint = this.getEndpoint("aidge", this._regionId, this._endpointRule, this._network, this._suffix, this._endpointMap, this._endpoint);
20
17
  }
@@ -684,6 +681,108 @@ export default class Client extends OpenApi {
684
681
  return await this.documentTranslateWithOptions(request, runtime);
685
682
  }
686
683
 
684
+ /**
685
+ * E-commerce Video Remix is an AI video service designed for product content production. It covers video understanding, element replacement, quality verification, and result delivery. The service focuses on product and person consistency, detail restoration, conversion-oriented expression, and large-scale production. It supports targeted replacement of products or persons based on hit video templates while preserving the original actions, shot rhythm, and marketing structure to rapidly generate multi-version content and reduce shooting, editing, and adaptation costs.
686
+ *
687
+ * @remarks
688
+ * ## **Product Introduction**
689
+ * E-commerce Video Remix is an AI video service designed for product content production. It covers video understanding, element replacement, quality verification, and result delivery. The service focuses on product and person consistency, detail restoration, conversion-oriented expression, and large-scale production. It supports targeted replacement of products or persons based on hit video templates while preserving the original actions, shot rhythm, and marketing structure to rapidly generate multi-version content and reduce shooting, editing, and adaptation costs.
690
+ * ## **Scenarios**
691
+ * - **Video asset remix:** Use an existing e-commerce video as a template and replace only the specified product or person while preserving the original shots, rhythm, and marketing expression. This is suitable for multi-SKU, multi-model, multi-region, and multi-version asset production.
692
+ * - **New product launch with rapid asset generation:** For products launched in batches, reduce the need for live shooting, studio time, post-production editing, and repetitive production. Quickly generate video assets for new products and help merchants shorten the cycle from discovering a hit video to scripting and publishing new content.
693
+ * - **Product presentation and selling point expression:** Suitable for apparel, beauty and personal care, food and beverages, home and daily essentials, 3C electronics, and small appliances. Based on the selling point structure, display actions, and shot rhythm of the original video, generate presentation videos optimized for new product conversion.
694
+ * - **Multi-selling-point and multi-version testing:** Rapidly generate multiple versions based on different product selling points, target audiences, scripts, shots, and visual styles to support content testing and ad creative iteration.
695
+ * ## **Capabilities**
696
+ * ### **Core capabilities**
697
+ * Two replacement modes are supported:
698
+ * - **Product replacement (product_replacement):** Preserves the original video host identity, actions, scene, and selling structure while replacing the original product with the target product.
699
+ * - **Person replacement (person_replacement):** Preserves the original video product, actions, scene, and selling structure while replacing the on-screen person with the target person from a reference image or description.
700
+ * - **Fully automated end-to-end generation with zero prompt requirements:** Simply provide a reference video and a target product image or person image. The system automatically completes the entire pipeline including video understanding, script planning, storyboard design, first-frame generation, and video synthesis.
701
+ * - **Product understanding and information structuring:** Identifies product category, appearance, material, color, structure, and key components, and combines merchant-provided titles, attributes, and selling points to generate usable video expression information.
702
+ * - **Template video element replacement:** Supports replacing products or persons within the authorized scope, with configurable replacement and protection ranges to minimize changes in non-target areas.
703
+ * - **Product subject consistency:** Maintains stable product shape, color, texture, pattern, packaging, and logo across different shots, angles, actions, and scenes.
704
+ * - **Product fidelity:** Multi-round VL quality inspection locks product state (color, texture, structure, and print) throughout the process to prevent product feature drift.
705
+ * - **Strength category — Apparel:** Faithfully restores apparel details with attention to silhouette, wrinkles, drape, fabric texture, buttons, zippers, prints, and accessories, reducing clipping, deformation, texture loss, and detail artifacts.
706
+ * - **Selling point script and storyboard replication:** Replicates the selling point structure, video composition, shot sequence, display actions, voiceover content, and closing style of the original video.
707
+ * - **Commercial model matching:** Supports matching model appearance and display style based on product style, silhouette, target audience, and market requirements.
708
+ * - **Quality verification and result feedback:** Performs multi-dimensional checks on product subject, person, apparel, text, frame completeness, audio, and overall usability, and outputs result information for manual review.
709
+ *
710
+ * @param tmpReq - EcomVideoRecreationRequest
711
+ * @param runtime - runtime options for this request RuntimeOptions
712
+ * @returns EcomVideoRecreationResponse
713
+ */
714
+ async ecomVideoRecreationWithOptions(tmpReq: $_model.EcomVideoRecreationRequest, runtime: $dara.RuntimeOptions): Promise<$_model.EcomVideoRecreationResponse> {
715
+ tmpReq.validate();
716
+ let request = new $_model.EcomVideoRecreationShrinkRequest({ });
717
+ OpenApiUtil.convert(tmpReq, request);
718
+ if (!$dara.isNull(tmpReq.input)) {
719
+ request.inputShrink = OpenApiUtil.arrayToStringWithSpecifiedStyle(tmpReq.input, "Input", "json");
720
+ }
721
+
722
+ if (!$dara.isNull(tmpReq.output)) {
723
+ request.outputShrink = OpenApiUtil.arrayToStringWithSpecifiedStyle(tmpReq.output, "Output", "json");
724
+ }
725
+
726
+ let query = { };
727
+ if (!$dara.isNull(request.inputShrink)) {
728
+ query["Input"] = request.inputShrink;
729
+ }
730
+
731
+ if (!$dara.isNull(request.outputShrink)) {
732
+ query["Output"] = request.outputShrink;
733
+ }
734
+
735
+ let req = new $OpenApiUtil.OpenApiRequest({
736
+ query: OpenApiUtil.query(query),
737
+ });
738
+ let params = new $OpenApiUtil.Params({
739
+ action: "EcomVideoRecreation",
740
+ version: "2026-04-28",
741
+ protocol: "HTTPS",
742
+ pathname: "/",
743
+ method: "POST",
744
+ authType: "AK",
745
+ style: "RPC",
746
+ reqBodyType: "formData",
747
+ bodyType: "json",
748
+ });
749
+ return $dara.cast<$_model.EcomVideoRecreationResponse>(await this.callApi(params, req, runtime), new $_model.EcomVideoRecreationResponse({}));
750
+ }
751
+
752
+ /**
753
+ * E-commerce Video Remix is an AI video service designed for product content production. It covers video understanding, element replacement, quality verification, and result delivery. The service focuses on product and person consistency, detail restoration, conversion-oriented expression, and large-scale production. It supports targeted replacement of products or persons based on hit video templates while preserving the original actions, shot rhythm, and marketing structure to rapidly generate multi-version content and reduce shooting, editing, and adaptation costs.
754
+ *
755
+ * @remarks
756
+ * ## **Product Introduction**
757
+ * E-commerce Video Remix is an AI video service designed for product content production. It covers video understanding, element replacement, quality verification, and result delivery. The service focuses on product and person consistency, detail restoration, conversion-oriented expression, and large-scale production. It supports targeted replacement of products or persons based on hit video templates while preserving the original actions, shot rhythm, and marketing structure to rapidly generate multi-version content and reduce shooting, editing, and adaptation costs.
758
+ * ## **Scenarios**
759
+ * - **Video asset remix:** Use an existing e-commerce video as a template and replace only the specified product or person while preserving the original shots, rhythm, and marketing expression. This is suitable for multi-SKU, multi-model, multi-region, and multi-version asset production.
760
+ * - **New product launch with rapid asset generation:** For products launched in batches, reduce the need for live shooting, studio time, post-production editing, and repetitive production. Quickly generate video assets for new products and help merchants shorten the cycle from discovering a hit video to scripting and publishing new content.
761
+ * - **Product presentation and selling point expression:** Suitable for apparel, beauty and personal care, food and beverages, home and daily essentials, 3C electronics, and small appliances. Based on the selling point structure, display actions, and shot rhythm of the original video, generate presentation videos optimized for new product conversion.
762
+ * - **Multi-selling-point and multi-version testing:** Rapidly generate multiple versions based on different product selling points, target audiences, scripts, shots, and visual styles to support content testing and ad creative iteration.
763
+ * ## **Capabilities**
764
+ * ### **Core capabilities**
765
+ * Two replacement modes are supported:
766
+ * - **Product replacement (product_replacement):** Preserves the original video host identity, actions, scene, and selling structure while replacing the original product with the target product.
767
+ * - **Person replacement (person_replacement):** Preserves the original video product, actions, scene, and selling structure while replacing the on-screen person with the target person from a reference image or description.
768
+ * - **Fully automated end-to-end generation with zero prompt requirements:** Simply provide a reference video and a target product image or person image. The system automatically completes the entire pipeline including video understanding, script planning, storyboard design, first-frame generation, and video synthesis.
769
+ * - **Product understanding and information structuring:** Identifies product category, appearance, material, color, structure, and key components, and combines merchant-provided titles, attributes, and selling points to generate usable video expression information.
770
+ * - **Template video element replacement:** Supports replacing products or persons within the authorized scope, with configurable replacement and protection ranges to minimize changes in non-target areas.
771
+ * - **Product subject consistency:** Maintains stable product shape, color, texture, pattern, packaging, and logo across different shots, angles, actions, and scenes.
772
+ * - **Product fidelity:** Multi-round VL quality inspection locks product state (color, texture, structure, and print) throughout the process to prevent product feature drift.
773
+ * - **Strength category — Apparel:** Faithfully restores apparel details with attention to silhouette, wrinkles, drape, fabric texture, buttons, zippers, prints, and accessories, reducing clipping, deformation, texture loss, and detail artifacts.
774
+ * - **Selling point script and storyboard replication:** Replicates the selling point structure, video composition, shot sequence, display actions, voiceover content, and closing style of the original video.
775
+ * - **Commercial model matching:** Supports matching model appearance and display style based on product style, silhouette, target audience, and market requirements.
776
+ * - **Quality verification and result feedback:** Performs multi-dimensional checks on product subject, person, apparel, text, frame completeness, audio, and overall usability, and outputs result information for manual review.
777
+ *
778
+ * @param request - EcomVideoRecreationRequest
779
+ * @returns EcomVideoRecreationResponse
780
+ */
781
+ async ecomVideoRecreation(request: $_model.EcomVideoRecreationRequest): Promise<$_model.EcomVideoRecreationResponse> {
782
+ let runtime = new $dara.RuntimeOptions({ });
783
+ return await this.ecomVideoRecreationWithOptions(request, runtime);
784
+ }
785
+
687
786
  /**
688
787
  * Intelligently crops images to specified dimensions, automatically identifies the main subject area, and precisely crops to various sizes to meet design requirements across different scenarios. (Synchronous)
689
788
  *
@@ -1753,11 +1852,11 @@ export default class Client extends OpenApi {
1753
1852
  }
1754
1853
 
1755
1854
  /**
1756
- * Supports automatic language identification for 24 language directions. Applicable to short text such as search queries, titles, and conversations.
1855
+ * Supports automatic language identification for 31 languages in query scenarios and 35 languages in general scenarios. Applicable to short text language identification such as search terms, titles, and conversations.
1757
1856
  *
1758
1857
  * @remarks
1759
1858
  * ## Product Introduction
1760
- * Supports automatic language identification for 24 language directions. Applicable to short text such as search queries, titles, and conversations.
1859
+ * Supports automatic language identification for 31 languages in query phrase scenarios and 35 languages in general scenarios. Applicable to short text language identification such as search terms, titles, and conversations. For supported language directions, refer to the [Language Direction Mapping Table](https://www.alibabacloud.com/help/en/document_detail/3041883.html).
1761
1860
  *
1762
1861
  * @param request - LanguageDetectRequest
1763
1862
  * @param runtime - runtime options for this request RuntimeOptions
@@ -1792,11 +1891,11 @@ export default class Client extends OpenApi {
1792
1891
  }
1793
1892
 
1794
1893
  /**
1795
- * Supports automatic language identification for 24 language directions. Applicable to short text such as search queries, titles, and conversations.
1894
+ * Supports automatic language identification for 31 languages in query scenarios and 35 languages in general scenarios. Applicable to short text language identification such as search terms, titles, and conversations.
1796
1895
  *
1797
1896
  * @remarks
1798
1897
  * ## Product Introduction
1799
- * Supports automatic language identification for 24 language directions. Applicable to short text such as search queries, titles, and conversations.
1898
+ * Supports automatic language identification for 31 languages in query phrase scenarios and 35 languages in general scenarios. Applicable to short text language identification such as search terms, titles, and conversations. For supported language directions, refer to the [Language Direction Mapping Table](https://www.alibabacloud.com/help/en/document_detail/3041883.html).
1800
1899
  *
1801
1900
  * @param request - LanguageDetectRequest
1802
1901
  * @returns LanguageDetectResponse
@@ -2893,25 +2992,25 @@ export default class Client extends OpenApi {
2893
2992
  }
2894
2993
 
2895
2994
  /**
2896
- * 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.
2995
+ * 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 quick single-product calls and multi-product batch generation, and accommodates 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.
2897
2996
  *
2898
2997
  * @remarks
2899
- * # Applicable scenarios
2900
- * - 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 display, information feed placement, short video content marketing, campaign material, and other scenarios.
2901
- * - 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 more, helping merchants rapidly complete material preparation during the launch phase.
2902
- * - High-fidelity apparel display: Generates model showcase videos that closely resemble real commercial photography based on product main images, with optimized capabilities for silhouette accuracy, fabric texture preservation, color fidelity, and consistent detail stability. Supports common e-commerce display methods such as wearing, turning, walking, close-up shots, and multi-angle switching.
2903
- * - 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.
2904
- * - 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.
2905
- * - 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.
2998
+ * # Scenarios
2999
+ * - 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.
3000
+ * - 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, product titles, and other basic information to quickly generate product showcase videos, model try-on videos, voiceover explanation videos, and other content, helping merchants rapidly complete material preparation during the launch phase.
3001
+ * - High-fidelity apparel display: Generates model showcase videos based on product main images that closely resemble real commercial photography, with key optimizations for silhouette accuracy, fabric texture preservation, color fidelity, and consistent detail stability. Supports common e-commerce display methods such as garment try-on, turning, walking, close-up shots, and multi-angle switching.
3002
+ * - 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 multiple commercial photography presentation methods such as standing poses, side views, walking displays, and detail close-ups.
3003
+ * - Standard product explanation 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. Quickly generates product explanation videos based on product main images, titles, selling point information, and explanation scripts.
3004
+ * - 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 materials, enabling businesses to cost-effectively validate the conversion performance of different selling points and presentation formats, improving placement ROI.
2906
3005
  * # Features
2907
- * - 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.
2908
- * - Highly stable generation with low discard rate: Uses a deterministic generation pipeline and multi-layer quality control mechanism to output usable materials with fewer retries, reducing invalid generation and resource waste, making overall production costs more controllable.
2909
- * - E-commerce-specific product fidelity capability: Built-in multi-round quality inspection agents lock product state throughout video generation (such as zippers not being unzipped, sleeves not being lowered, prints not disappearing), ensuring product consistency through multi-layer defense of "script rewriting + explicit constraint injection + failure-aware retry."
2910
- * - 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.
2911
- * - 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.
2912
- * - Cinematic camera movement capabilities: Built-in advanced camera modes including bullet time, Grammy slow motion, 360° orbital rotation, and full-body model rotation display, achieving deterministic output through segmented precise control.
2913
- * - 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.
2914
- * - 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 materials, and new product and promotional video generation.
3006
+ * - 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 for product understanding, visual quality inspection, script planning, and directing/camera movement significantly lower the barrier to use.
3007
+ * - Highly stable generation with low waste rate: Uses a deterministic generation process and multi-layer quality control mechanism to output usable materials with fewer retries, reducing invalid generation and resource waste, making overall production costs more controllable.
3008
+ * - E-commerce-specific product fidelity: Built-in multi-round quality inspection agents lock product state throughout video generation (for example, zippers will not be unzipped, sleeves will not be lowered, prints will not disappear). Multi-layer defense through "script rewriting + explicit constraint injection + failure-aware retry" ensures product consistency.
3009
+ * - Reference image priority + 6-axis consistency verification: Uses a Reference-Image-First generation paradigm with the original product image as the sole visual source of truth. 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.
3010
+ * - Flexible storyboard arrangement and duration control: Supports adjustable video duration from 5–30 seconds. The agent autonomously plans independent storyboards to showcase the product in different scenarios. Also supports fixed-scene mode for in-depth product presentation under a unified visual style.
3011
+ * - Cinematic camera movement capabilities: Built-in advanced camera movement modes including bullet time, Grammy-style slow motion, 360° orbital rotation, and full-body model rotation display, achieving deterministic output through segment-level precise control.
3012
+ * - Model library and customization services: Built-in multi-type model resource library. Supports merchants in specifying fixed models, customizing exclusive model personas, and long-term brand visual identity binding to ensure brand visual consistency.
3013
+ * - 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 launch and promotional video generation.
2915
3014
  *
2916
3015
  * @param tmpReq - VideoGenerationRequest
2917
3016
  * @param runtime - runtime options for this request RuntimeOptions
@@ -2964,25 +3063,25 @@ export default class Client extends OpenApi {
2964
3063
  }
2965
3064
 
2966
3065
  /**
2967
- * 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.
3066
+ * 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 quick single-product calls and multi-product batch generation, and accommodates 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.
2968
3067
  *
2969
3068
  * @remarks
2970
- * # Applicable scenarios
2971
- * - 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 display, information feed placement, short video content marketing, campaign material, and other scenarios.
2972
- * - 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 more, helping merchants rapidly complete material preparation during the launch phase.
2973
- * - High-fidelity apparel display: Generates model showcase videos that closely resemble real commercial photography based on product main images, with optimized capabilities for silhouette accuracy, fabric texture preservation, color fidelity, and consistent detail stability. Supports common e-commerce display methods such as wearing, turning, walking, close-up shots, and multi-angle switching.
2974
- * - 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.
2975
- * - 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.
2976
- * - 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.
3069
+ * # Scenarios
3070
+ * - 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.
3071
+ * - 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, product titles, and other basic information to quickly generate product showcase videos, model try-on videos, voiceover explanation videos, and other content, helping merchants rapidly complete material preparation during the launch phase.
3072
+ * - High-fidelity apparel display: Generates model showcase videos based on product main images that closely resemble real commercial photography, with key optimizations for silhouette accuracy, fabric texture preservation, color fidelity, and consistent detail stability. Supports common e-commerce display methods such as garment try-on, turning, walking, close-up shots, and multi-angle switching.
3073
+ * - 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 multiple commercial photography presentation methods such as standing poses, side views, walking displays, and detail close-ups.
3074
+ * - Standard product explanation 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. Quickly generates product explanation videos based on product main images, titles, selling point information, and explanation scripts.
3075
+ * - 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 materials, enabling businesses to cost-effectively validate the conversion performance of different selling points and presentation formats, improving placement ROI.
2977
3076
  * # Features
2978
- * - 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.
2979
- * - Highly stable generation with low discard rate: Uses a deterministic generation pipeline and multi-layer quality control mechanism to output usable materials with fewer retries, reducing invalid generation and resource waste, making overall production costs more controllable.
2980
- * - E-commerce-specific product fidelity capability: Built-in multi-round quality inspection agents lock product state throughout video generation (such as zippers not being unzipped, sleeves not being lowered, prints not disappearing), ensuring product consistency through multi-layer defense of "script rewriting + explicit constraint injection + failure-aware retry."
2981
- * - 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.
2982
- * - 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.
2983
- * - Cinematic camera movement capabilities: Built-in advanced camera modes including bullet time, Grammy slow motion, 360° orbital rotation, and full-body model rotation display, achieving deterministic output through segmented precise control.
2984
- * - 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.
2985
- * - 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 materials, and new product and promotional video generation.
3077
+ * - 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 for product understanding, visual quality inspection, script planning, and directing/camera movement significantly lower the barrier to use.
3078
+ * - Highly stable generation with low waste rate: Uses a deterministic generation process and multi-layer quality control mechanism to output usable materials with fewer retries, reducing invalid generation and resource waste, making overall production costs more controllable.
3079
+ * - E-commerce-specific product fidelity: Built-in multi-round quality inspection agents lock product state throughout video generation (for example, zippers will not be unzipped, sleeves will not be lowered, prints will not disappear). Multi-layer defense through "script rewriting + explicit constraint injection + failure-aware retry" ensures product consistency.
3080
+ * - Reference image priority + 6-axis consistency verification: Uses a Reference-Image-First generation paradigm with the original product image as the sole visual source of truth. 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.
3081
+ * - Flexible storyboard arrangement and duration control: Supports adjustable video duration from 5–30 seconds. The agent autonomously plans independent storyboards to showcase the product in different scenarios. Also supports fixed-scene mode for in-depth product presentation under a unified visual style.
3082
+ * - Cinematic camera movement capabilities: Built-in advanced camera movement modes including bullet time, Grammy-style slow motion, 360° orbital rotation, and full-body model rotation display, achieving deterministic output through segment-level precise control.
3083
+ * - Model library and customization services: Built-in multi-type model resource library. Supports merchants in specifying fixed models, customizing exclusive model personas, and long-term brand visual identity binding to ensure brand visual consistency.
3084
+ * - 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 launch and promotional video generation.
2986
3085
  *
2987
3086
  * @param request - VideoGenerationRequest
2988
3087
  * @returns VideoGenerationResponse
@@ -0,0 +1,234 @@
1
+ // This file is auto-generated, don't edit it
2
+ import * as $dara from '@darabonba/typescript';
3
+
4
+
5
+ export class EcomVideoRecreationRequestInputProductInfo extends $dara.Model {
6
+ /**
7
+ * @remarks
8
+ * The product category.
9
+ * Example: Women\\"s Clothing/Sun Protection Jacket
10
+ *
11
+ * @example
12
+ * Women\\"s clothing/sun protection clothing
13
+ */
14
+ category?: string;
15
+ /**
16
+ * @remarks
17
+ * The actual product information (SKU, brand, color, material, size, specifications, logo, and usage), used to constrain voiceover facts.
18
+ * Example: Light moon yellow, cool-touch fabric, sun protection to the back of the hand, UPF50+
19
+ *
20
+ * @example
21
+ * Light moon yellow, cool-touch fabric, sun protection extending to the back of the hand, UPF50+
22
+ */
23
+ detail?: string;
24
+ /**
25
+ * @remarks
26
+ * Required for product replacement. The name of the target product. Maximum length: 200 characters.
27
+ * Example: Light Moon Yellow Cool-touch Sun Protection Jacket
28
+ *
29
+ * @example
30
+ * Light moon yellow cool-touch sun protection clothing
31
+ */
32
+ title?: string;
33
+ static names(): { [key: string]: string } {
34
+ return {
35
+ category: 'Category',
36
+ detail: 'Detail',
37
+ title: 'Title',
38
+ };
39
+ }
40
+
41
+ static types(): { [key: string]: any } {
42
+ return {
43
+ category: 'string',
44
+ detail: 'string',
45
+ title: 'string',
46
+ };
47
+ }
48
+
49
+ validate() {
50
+ super.validate();
51
+ }
52
+
53
+ constructor(map?: { [key: string]: any }) {
54
+ super(map);
55
+ }
56
+ }
57
+
58
+ export class EcomVideoRecreationRequestInput extends $dara.Model {
59
+ /**
60
+ * @remarks
61
+ * The description or supplementary constraints for the target person in person replacement mode. 1 to 500 characters. Required when PersonReferenceImageUrls is not provided.
62
+ * Example: The target person is an adult male. Retain the original clothing and actions.
63
+ *
64
+ * @example
65
+ * The target character is an adult male, with the original costume and movements preserved.
66
+ */
67
+ changeDescription?: string;
68
+ /**
69
+ * @remarks
70
+ * The replacement mode. Valid values: `product_replacement` (default) and `person_replacement`.
71
+ *
72
+ * @example
73
+ * product_replacement
74
+ */
75
+ mode?: string;
76
+ /**
77
+ * @remarks
78
+ * The URLs of target person reference images for person replacement. 1 to 5 images of the same person are supported. Arrange images in the following order: face close-up, front view, 45-degree angle, side view, and back view.
79
+ * Example: ["https://example.com/person.jpg"]
80
+ */
81
+ personReferenceImageUrls?: string[];
82
+ /**
83
+ * @remarks
84
+ * The URL of the target product image. Required for product replacement. Exactly one image must be provided. A clear subject with no occlusion and a clean background is recommended.
85
+ * Example: ["https://example.com/product.png"]
86
+ */
87
+ productImageUrls?: string[];
88
+ /**
89
+ * @remarks
90
+ * The target product information. Provide this parameter to improve voiceover accuracy.
91
+ */
92
+ productInfo?: EcomVideoRecreationRequestInputProductInfo;
93
+ /**
94
+ * @remarks
95
+ * The HTTP(S) URL of the reference video. The video duration must be in the range of 2 to 360 seconds. The URL must remain accessible during task execution. Set the URL validity period to at least 24 hours.
96
+ *
97
+ * This parameter is required.
98
+ *
99
+ * @example
100
+ * https://example.com/source.mp4
101
+ */
102
+ sourceVideoUrl?: string;
103
+ static names(): { [key: string]: string } {
104
+ return {
105
+ changeDescription: 'ChangeDescription',
106
+ mode: 'Mode',
107
+ personReferenceImageUrls: 'PersonReferenceImageUrls',
108
+ productImageUrls: 'ProductImageUrls',
109
+ productInfo: 'ProductInfo',
110
+ sourceVideoUrl: 'SourceVideoUrl',
111
+ };
112
+ }
113
+
114
+ static types(): { [key: string]: any } {
115
+ return {
116
+ changeDescription: 'string',
117
+ mode: 'string',
118
+ personReferenceImageUrls: { 'type': 'array', 'itemType': 'string' },
119
+ productImageUrls: { 'type': 'array', 'itemType': 'string' },
120
+ productInfo: EcomVideoRecreationRequestInputProductInfo,
121
+ sourceVideoUrl: 'string',
122
+ };
123
+ }
124
+
125
+ validate() {
126
+ if(Array.isArray(this.personReferenceImageUrls)) {
127
+ $dara.Model.validateArray(this.personReferenceImageUrls);
128
+ }
129
+ if(Array.isArray(this.productImageUrls)) {
130
+ $dara.Model.validateArray(this.productImageUrls);
131
+ }
132
+ if(this.productInfo && typeof (this.productInfo as any).validate === 'function') {
133
+ (this.productInfo as any).validate();
134
+ }
135
+ super.validate();
136
+ }
137
+
138
+ constructor(map?: { [key: string]: any }) {
139
+ super(map);
140
+ }
141
+ }
142
+
143
+ export class EcomVideoRecreationRequestOutput extends $dara.Model {
144
+ /**
145
+ * @remarks
146
+ * The target duration in seconds. `"auto"` (default): determined by the system. For product replacement, an integer from 5 to 60 can be specified. For person replacement, only `"auto"` is supported.
147
+ *
148
+ * @example
149
+ * auto
150
+ */
151
+ duration?: number;
152
+ /**
153
+ * @remarks
154
+ * The output resolution. Default value: `720p`.
155
+ *
156
+ * @example
157
+ * 720p、1080p
158
+ */
159
+ quality?: string;
160
+ /**
161
+ * @remarks
162
+ * The output aspect ratio. Default value: `auto` (automatically matches the original video).
163
+ *
164
+ * @example
165
+ * auto、9:16、3:4、1:1、4:3、16:9
166
+ */
167
+ ratio?: string;
168
+ static names(): { [key: string]: string } {
169
+ return {
170
+ duration: 'Duration',
171
+ quality: 'Quality',
172
+ ratio: 'Ratio',
173
+ };
174
+ }
175
+
176
+ static types(): { [key: string]: any } {
177
+ return {
178
+ duration: 'number',
179
+ quality: 'string',
180
+ ratio: 'string',
181
+ };
182
+ }
183
+
184
+ validate() {
185
+ super.validate();
186
+ }
187
+
188
+ constructor(map?: { [key: string]: any }) {
189
+ super(map);
190
+ }
191
+ }
192
+
193
+ export class EcomVideoRecreationRequest extends $dara.Model {
194
+ /**
195
+ * @remarks
196
+ * The input parameters for video remix.
197
+ *
198
+ * This parameter is required.
199
+ */
200
+ input?: EcomVideoRecreationRequestInput;
201
+ /**
202
+ * @remarks
203
+ * The output specifications for the final video.
204
+ */
205
+ output?: EcomVideoRecreationRequestOutput;
206
+ static names(): { [key: string]: string } {
207
+ return {
208
+ input: 'Input',
209
+ output: 'Output',
210
+ };
211
+ }
212
+
213
+ static types(): { [key: string]: any } {
214
+ return {
215
+ input: EcomVideoRecreationRequestInput,
216
+ output: EcomVideoRecreationRequestOutput,
217
+ };
218
+ }
219
+
220
+ validate() {
221
+ if(this.input && typeof (this.input as any).validate === 'function') {
222
+ (this.input as any).validate();
223
+ }
224
+ if(this.output && typeof (this.output as any).validate === 'function') {
225
+ (this.output as any).validate();
226
+ }
227
+ super.validate();
228
+ }
229
+
230
+ constructor(map?: { [key: string]: any }) {
231
+ super(map);
232
+ }
233
+ }
234
+
@@ -0,0 +1,40 @@
1
+ // This file is auto-generated, don't edit it
2
+ import * as $dara from '@darabonba/typescript';
3
+ import { EcomVideoRecreationResponseBody } from "./EcomVideoRecreationResponseBody";
4
+
5
+
6
+ export class EcomVideoRecreationResponse extends $dara.Model {
7
+ headers?: { [key: string]: string };
8
+ statusCode?: number;
9
+ body?: EcomVideoRecreationResponseBody;
10
+ static names(): { [key: string]: string } {
11
+ return {
12
+ headers: 'headers',
13
+ statusCode: 'statusCode',
14
+ body: 'body',
15
+ };
16
+ }
17
+
18
+ static types(): { [key: string]: any } {
19
+ return {
20
+ headers: { 'type': 'map', 'keyType': 'string', 'valueType': 'string' },
21
+ statusCode: 'number',
22
+ body: EcomVideoRecreationResponseBody,
23
+ };
24
+ }
25
+
26
+ validate() {
27
+ if(this.headers) {
28
+ $dara.Model.validateMap(this.headers);
29
+ }
30
+ if(this.body && typeof (this.body as any).validate === 'function') {
31
+ (this.body as any).validate();
32
+ }
33
+ super.validate();
34
+ }
35
+
36
+ constructor(map?: { [key: string]: any }) {
37
+ super(map);
38
+ }
39
+ }
40
+
@@ -0,0 +1,104 @@
1
+ // This file is auto-generated, don't edit it
2
+ import * as $dara from '@darabonba/typescript';
3
+
4
+
5
+ export class EcomVideoRecreationResponseBodyData extends $dara.Model {
6
+ /**
7
+ * @remarks
8
+ * The asynchronous task ID for QueryAsyncTaskResult queries.
9
+ *
10
+ * @example
11
+ * task_778fa8bd21804828a5d147050e30edac
12
+ */
13
+ taskId?: string;
14
+ static names(): { [key: string]: string } {
15
+ return {
16
+ taskId: 'TaskId',
17
+ };
18
+ }
19
+
20
+ static types(): { [key: string]: any } {
21
+ return {
22
+ taskId: 'string',
23
+ };
24
+ }
25
+
26
+ validate() {
27
+ super.validate();
28
+ }
29
+
30
+ constructor(map?: { [key: string]: any }) {
31
+ super(map);
32
+ }
33
+ }
34
+
35
+ export class EcomVideoRecreationResponseBody extends $dara.Model {
36
+ /**
37
+ * @remarks
38
+ * The result code. `success` indicates success. An error code is returned upon failure.
39
+ *
40
+ * @example
41
+ * success
42
+ */
43
+ code?: string;
44
+ /**
45
+ * @remarks
46
+ * The asynchronous task submit status.
47
+ */
48
+ data?: EcomVideoRecreationResponseBodyData;
49
+ /**
50
+ * @remarks
51
+ * The response message. An error description is returned upon failure.
52
+ *
53
+ * @example
54
+ * Task submitted
55
+ */
56
+ message?: string;
57
+ /**
58
+ * @remarks
59
+ * The request ID, used to identify a unique call.
60
+ *
61
+ * @example
62
+ * 70CBEFDF-BB17-1EB3-8A21-569F3124738F
63
+ */
64
+ requestId?: string;
65
+ /**
66
+ * @remarks
67
+ * Indicates whether the submission is successful.
68
+ *
69
+ * @example
70
+ * true
71
+ */
72
+ success?: boolean;
73
+ static names(): { [key: string]: string } {
74
+ return {
75
+ code: 'Code',
76
+ data: 'Data',
77
+ message: 'Message',
78
+ requestId: 'RequestId',
79
+ success: 'Success',
80
+ };
81
+ }
82
+
83
+ static types(): { [key: string]: any } {
84
+ return {
85
+ code: 'string',
86
+ data: EcomVideoRecreationResponseBodyData,
87
+ message: 'string',
88
+ requestId: 'string',
89
+ success: 'boolean',
90
+ };
91
+ }
92
+
93
+ validate() {
94
+ if(this.data && typeof (this.data as any).validate === 'function') {
95
+ (this.data as any).validate();
96
+ }
97
+ super.validate();
98
+ }
99
+
100
+ constructor(map?: { [key: string]: any }) {
101
+ super(map);
102
+ }
103
+ }
104
+