电商AI视频生成Agent面向电商商家与平台，基于商品主图、标题、卖点等信息，自动生成 5–30 秒商品展示短视频，帮助客户高效完成电商内容生产与分发。产品支持 720P、1080P 等多种清晰度输出，支持单商品快速调用与多商品批量生成，兼顾日常运营和大规模商品内容生产需求。当前已覆盖服饰全品类（上衣、裤装、裙装、套装、内衣、泳装等），逐步拓展至护肤品、化妆品、食品饮料、家用电器等电商核心类目。

接口说明

适用场景

卖家/平台批量生成商品短视频：支持多种视频比例与尺寸（3:4、9:16），适配商品详情页视频位、商品主页展示、信息流投放、短视频种草、活动会场素材等场景。
商品上新，快速生成首批视频素材：当商家有大量新品集中上架时，只需上传商品图、商品标题等基础信息，即可快速生成商品展示视频、模特上身视频、口播讲解视频等内容，帮助商家在上新阶段迅速完成素材铺设。
高保真服饰展示：基于商品主图生成更贴近真实商拍效果的模特展示视频，重点优化版型还原、面料纹理保留、颜色准确呈现、细节稳定一致等能力，支持服装上身、转身、走动、近景特写、多角度切换等常见电商展示方式。
生成高质量商拍模特：内置目标受众模特库，覆盖大码女性、大码男性、泳装、少女风、轻熟通勤、青年休闲、商务男装、运动健身等多体型、多肤色、多人种模特，支持站姿展示、侧身展示、走动展示、局部特写等多种商拍表达方式。
标品讲解等高频电商场景：适用于护肤品、化妆品、个护小家电、食品饮料、家清日用、3C 数码等标准化商品类目，可基于商品主图、标题、卖点信息和讲解脚本快速生成商品讲解视频。
多商品、多卖点测试，提升投放效率：面向信息流广告、短视频投放和内容种草场景，可快速生成多个版本的视频素材，便于企业低成本验证不同卖点与表现形式的转化效果，提升投放 ROI。

功能介绍

全自动端到端批量生成，零 Prompt 门槛：调用方仅需传入商品图片 URL 与标题，系统自动完成从商品理解、分镜规划到视频生成的全流程处理，无需人工编写 Prompt、选择模板或反复调参。内置商品理解、画面质检、脚本规划、编导运镜等多 Agent，大幅降低使用门槛。
高稳定生成，低废片率：采用确定性生成流程与多层质量控制机制，可在更少重试次数下输出可用素材，减少无效生成和资源浪费，整体生产成本更可控。
电商专属商品保真能力：内置多轮质检 Agent，在视频生成全程锁定商品状态（如拉链不会被拉开、袖子不会被放下、印花不会消失），通过「脚本改写 + 显式约束注入 + 失败感知重试」多层防御确保商品一致性。
参考图优先 + 6 轴一致性校验：采用 Reference-Image-First 生成范式，以原商品图作为视觉唯一事实源，自动执行 6 维度 VL 诊断（颜色漂移、图案缺失、轮廓偏移、结构增减、模特匹配、脏污检测），从机制上杜绝生成图与商品不像的问题。
灵活的分镜编排与时长控制：支持 5–30 秒可调视频时长；Agent 自主规划独立分镜展示商品在不同场景下的效果；也支持固定场景模式，在统一视觉风格下深度展示产品调性。
电影级运镜能力：内置子弹时间、格莱美慢镜头、360° 环绕旋转、模特全身旋转展示等高级运镜模式，通过分段精准控制实现确定性产出。
模特库与定制化服务：内置多类型模特资源库，支持商家指定固定模特、定制专属模特形象、长期绑定品牌视觉人设，保证品牌视觉统一性。
适配高频电商内容场景：支持 720P、1080P 等多种清晰度及 3:4、9:16 等多种长宽比，适配商品详情页视频位、商品主页视频展示、瀑布流/信息流投放、活动会场素材、上新与促销视频生成。

调试

您可以在OpenAPI Explorer中直接运行该接口，免去您计算签名的困扰。运行成功后，OpenAPI Explorer可以自动生成SDK代码示例。

调试

授权信息

下表是API对应的授权信息，可以在RAM权限策略语句的Action元素中使用，用来给RAM用户或RAM角色授予调用此API的权限。具体说明如下：

操作：是指具体的权限点。
访问级别：是指每个操作的访问级别，取值为写入（Write）、读取（Read）或列出（List）。
资源类型：是指操作中支持授权的资源类型。具体说明如下：
- 对于必选的资源类型，用前面加 * 表示。
- 对于不支持资源级授权的操作，用全部资源表示。
条件关键字：是指云产品自身定义的条件关键字。
关联操作：是指成功执行操作所需要的其他权限。操作者必须同时具备关联操作的权限，操作才能成功。

操作

访问级别

资源类型

条件关键字

关联操作

aidge:VideoGeneration

none

*全部资源

*

无

请求语法

POST  HTTP/1.1

请求参数

名称	类型	必填	描述	示例值
Input	object	是	商品输入
Images	array	是	商品图 URL 列表（1~8 张），需公网可访问
	string	是	商品图 URL ，需公网可访问	https://img.alicdn.com/xxx.jpg
Title	string	是	商品标题，最多截取前 60 个字符	2026 New Slimming Women's Summer Dress with Mid-Length Design, High-Quality Waist Definition for a Slender Look
Extra	object	否	扩展信息
AssetBindings	array<object>	否	素材绑定列表
	object	否
AssetIndex	integer	否	0,1,2,3 等，与图片 URL 的数字保持一致	0
Slot	string	否	从以下 3 选 1：look_reference、scene_reference、garment_reference 说明： look_reference：对应人物上身的整套穿搭效果图（整体视觉）。 scene_reference：对应场景参考图（通常为封面主图）。 garment_reference：对应所有商品细节图（包括衣服正面、背面、侧面、鞋子、裙子等局部特写）。	-
Description	string	否	图片的描述，比如： 1、look_reference 对应的描述：人物正面全身穿搭参考图 2、scene_reference 对应的描述：指定的服饰展示场景； 3、garment_reference 对应的描述： ● 上衣的正面； ● 下装的背面； ● 鞋子的侧面；	-
Intent	object	否	意图参数，暂不可用
Goal	string	否	业务目标 camera_motion：运镜模式，按固定 360 运镜逻辑生成； scripted_video：带脚本模式，提供脚本/提示词，由系统按脚本生成； auto_video：不带脚本模式，不提供脚本，由系统自动规划脚本后生成。	auto_video
Channel	string	否	投放渠道	-
Script	string	否	脚本/提示词	【2. Shot Breakdown】 [0-1s]【Eye-level close-up, static camera】Summer commute trousers folded on a clean tabletop; one corner is quickly unfolded to reveal the solid-color fabric and crisp crease line. The frame focuses on the trouser leg's surface smoothness and sharp appearance. [BGM/SFX: Upbeat, crisp commute-vibe background music begins] [1-2s]【Low-angle mid-shot, static camera】The full pair of trousers hangs freely in the air with a slight swing, showcasing the natural drape of the lightweight fabric and the complete straight-leg silhouette, then returns to a still, hanging state. [2-3s]【Eye-level mid-shot, static camera】A commute-styled model stands in a fitting area, holding the folded trousers at waist level with both hands, performing one up-and-down sizing gesture before holding them steady, displaying the overall proportions of the trousers in their folded state and the expected fit. [[Voiceover]: Who says wearing trousers in summer has to be stuffy? Most likely you just haven't picked the right pair.] [3-5s]【Eye-level full shot, slight pullback】The commute-styled model, now wearing the trousers paired with a clean commute top, takes two steps forward in a modern office building corridor, dynamically showcasing the front straight-leg silhouette, trouser leg lines, and commute outfit coordination. [5-7s]【Low-angle mid-shot, static camera】The commute-styled model shifts to an angled side stance, one hand in the front pocket and the other in the back pocket, displaying the cut from waist and hip down to the knee, the solid-color surface, and the clean lateral lines. [7-9s]【Eye-level mid-shot, static camera】The commute-styled model lifts one foot onto a low step, one hand brushes down the lower-leg trouser fabric and lightly lifts the hem, briefly exposing the ankle, showcasing the hem edge, side-seam details, and the wearing state during movement. [[Voiceover]: These ice-skin trousers are lightweight and breathable, solid-color straight-leg — looking sharp and at ease even when walking around at work.] [9-11s]【Overhead close-up, static camera】The lens focuses closely on the waistband area; the commute-styled model presses both hands along the waistband contour and smooths it, then pauses to display the seams and actual wearing state, clearly presenting the waistband shape and structural details. [11-13s]【Eye-level close-up, static camera】The commute-styled model gently lifts the fabric on both sides of the thigh with both hands, then raises one knee with a slight lateral turn before returning to a natural stance, demonstrating the actual range of motion during knee-lift and side-turn, as well as how the straight-leg trouser recovers after the foot lands. [13-15s]【Eye-level close-up, static camera】The commute-styled model enters the frame from the rear side, places one hand in the back pocket, then lightly traces along the back pocket edge and rear waist seam, showcasing the back pocket contour, pocket opening edge, and rear waist seam details up close. [[Voiceover]: If you're always on the move, there's room for knee lifts and side turns — commuting just got easier.] [15-17s]【Eye-level mid-shot, static camera】The commute-styled model faces away to display the rear silhouette of the trousers, hands naturally in pockets with a slight weight shift, then turns slightly to an angled side view so both the rear and lateral trouser lines are visible, fully presenting the rear cut and the overall line from hip and thigh down to the hem. [17-19s]【Eye-level full shot, smooth follow】The commute-styled model first walks sideways to the right, then transitions into a forward stride to complete the full presentation, finishing in the modern office building corridor in full commute attire, clearly showing the front straight-leg silhouette, clean lines, and overall fit. [[Voiceover]: If you like this fit, go check out the details.] 【3. Negative/Constraint Instructions】 The entire video centers on the summer commute trousers; no unrelated products or multi-person interactions are allowed.
Output	object	是	输出参数
Duration	integer	是	按 Intent.goal 区分时长：`auto_video` 支持 5～15 秒，`scripted_video` 支持 5～30 秒，`camera_motion` 固定生成 10 秒并返回两段 5 秒视频。	10
Ratio	string	否	按 Intent.goal 区分时长：`auto_video` 和 `scripted_video` 仅支持 `9:16`，`camera_motion` 仅支持 `3:4`。枚举值： 9:16 : 9:16	9:16
Quality	string	是	输出分辨率枚举值： 1080p : 1080p 720p : 720p	1080p

请求示例

{
  "input": {
    "images": ["https://img.alicdn.com/xxx.jpg"],
    "title": "2026 新款修身连衣裙女夏季气质收腰显瘦中长款",
    "extra": {},
    "goal":"",
    "AssetBindings":{}
  },
  "output": {
    "duration": 10,
    "ratio": "9:16",
    "quality": "1080p"
  }
}

返回参数

名称	类型	描述	示例值
	object	输出信息
RequestId	string	请求 ID，用于识别唯一一次请求调用	70CBEFDF-BB17-1EB3-8A21-569F3124738F
Code	string	响应代码。success 代表调用成功，failed 代表失败	success
Success	boolean	是否成功。true 代表成功，false 代表失败	true
Message	string	返回信息，失败时返回错误信息	Success
Data	object	返回结果的结构体信息
UsageMap	object	计量用量信息
	integer	视频时长和视频分辨率	ProcessedVideoDurationSeconds=10, Resolution=720P
TaskId	string	下游任务 ID	778fa8bd21804828a5d147050e30edac

响应示例

成功时

{
  "Data": {
    "UsageMap": {
      "Resolution": "720P",
      "Duration": "10"
    },
    "Result": {
      "Status": "completed",
      "JobId": "72bfbb50f8bb41c790ab1dc9a18af29c",
      "VideoUrl": "https://mpp-cn-shanghai-yike.oss-cn-shanghai.aliyuncs.com/xxx.mp4?Expires=..."
    }
  },
  "RequestId": "70CBEFDF-BB17-1EB3-8A21-569F3124738F",
  "Message": "Success",
  "Code": "success",
  "Success": true
}

失败时

{
  "Data": {
    "UsageMap": {
      "Resolution": "",
      "Duration": ""
    },
    "Result": {
      "Status": "failed",
      "JobId": "72bfbb50f8bb41c790ab1dc9a18af29c",
      "VideoUrl": ""
    }
  },
  "RequestId": "70CBEFDF-BB17-1EB3-8A21-569F3124738F",
  "Message": "服饰商品视频生成失败，请检查输入图片是否清晰、是否与商品标题一致",
  "Code": "failed",
  "Success": false
}

示例

正常返回示例

JSON格式

{
  "RequestId": "70CBEFDF-BB17-1EB3-8A21-569F3124738F",
  "Code": "success",
  "Success": true,
  "Message": "Success",
  "Data": {
    "UsageMap": {
      "key": 0
    },
    "TaskId": "778fa8bd21804828a5d147050e30edac"
  }
}

错误码

访问错误中心查看更多错误码。

变更历史

更多信息，参考变更详情。