@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.
- package/dist/client.d.ts +97 -36
- package/dist/client.js +132 -39
- package/dist/client.js.map +1 -1
- package/dist/models/EcomVideoRecreationRequest.d.ts +156 -0
- package/dist/models/EcomVideoRecreationRequest.js +150 -0
- package/dist/models/EcomVideoRecreationRequest.js.map +1 -0
- package/dist/models/EcomVideoRecreationResponse.d.ts +19 -0
- package/dist/models/EcomVideoRecreationResponse.js +69 -0
- package/dist/models/EcomVideoRecreationResponse.js.map +1 -0
- package/dist/models/EcomVideoRecreationResponseBody.d.ts +70 -0
- package/dist/models/EcomVideoRecreationResponseBody.js +88 -0
- package/dist/models/EcomVideoRecreationResponseBody.js.map +1 -0
- package/dist/models/EcomVideoRecreationShrinkRequest.d.ts +25 -0
- package/dist/models/EcomVideoRecreationShrinkRequest.js +60 -0
- package/dist/models/EcomVideoRecreationShrinkRequest.js.map +1 -0
- package/dist/models/LanguageDetectRequest.d.ts +1 -1
- package/dist/models/LanguageDetectResponseBody.d.ts +2 -2
- package/dist/models/VideoGenerationRequest.d.ts +45 -8
- package/dist/models/VideoGenerationRequest.js.map +1 -1
- package/dist/models/VideoGenerationResponseBody.d.ts +5 -5
- package/dist/models/model.d.ts +8 -0
- package/dist/models/model.js +20 -4
- package/dist/models/model.js.map +1 -1
- package/package.json +1 -1
- package/src/client.ts +138 -39
- package/src/models/EcomVideoRecreationRequest.ts +234 -0
- package/src/models/EcomVideoRecreationResponse.ts +40 -0
- package/src/models/EcomVideoRecreationResponseBody.ts +104 -0
- package/src/models/EcomVideoRecreationShrinkRequest.ts +40 -0
- package/src/models/LanguageDetectRequest.ts +1 -1
- package/src/models/LanguageDetectResponseBody.ts +2 -2
- package/src/models/VideoGenerationRequest.ts +45 -8
- package/src/models/VideoGenerationResponseBody.ts +5 -5
- 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
|
|
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
|
|
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
|
|
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
|
|
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
|
-
*
|
|
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
|
-
* #
|
|
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
|
|
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
|
|
2902
|
-
* - High-fidelity apparel display: Generates model showcase videos that closely resemble real commercial photography
|
|
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
|
|
2904
|
-
* - Standard product explanation and other high-frequency e-commerce scenarios:
|
|
2905
|
-
* - Multi-product
|
|
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
|
|
2908
|
-
* - Highly stable generation with low
|
|
2909
|
-
* - E-commerce-specific product fidelity
|
|
2910
|
-
* - Reference image priority + 6-axis consistency verification:
|
|
2911
|
-
* - Flexible storyboard arrangement and duration control: Supports adjustable video duration
|
|
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
|
|
2913
|
-
* - Model library and customization services: Built-in multi-type model resource library
|
|
2914
|
-
* - Adapted
|
|
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
|
-
*
|
|
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
|
-
* #
|
|
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
|
|
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
|
|
2973
|
-
* - High-fidelity apparel display: Generates model showcase videos that closely resemble real commercial photography
|
|
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
|
|
2975
|
-
* - Standard product explanation and other high-frequency e-commerce scenarios:
|
|
2976
|
-
* - Multi-product
|
|
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
|
|
2979
|
-
* - Highly stable generation with low
|
|
2980
|
-
* - E-commerce-specific product fidelity
|
|
2981
|
-
* - Reference image priority + 6-axis consistency verification:
|
|
2982
|
-
* - Flexible storyboard arrangement and duration control: Supports adjustable video duration
|
|
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
|
|
2984
|
-
* - Model library and customization services: Built-in multi-type model resource library
|
|
2985
|
-
* - Adapted
|
|
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
|
+
|