AI 助理
文档备案控制台
官方文档
首页 电商经营助手 开发参考 电商视频生成基础版

电商视频生成基础版

更新时间：
复制 MD 格式
产品详情
我的收藏

1、产品简介

电商视频基础版面向电商商家与平台，根据商品标题、同一商品的多张图片，可选输入分镜脚本，自动选择参考图、规划三段分镜并生成单商品展示视频。接口采用异步任务方式，支持 720P、1080P 分辨率和四种画幅，适用于非服饰类目的商品内容生产。服饰类目使用电商增强版。

2、适用场景

• 商品上新素材生成：提供商品标题和图片，即可自动规划商品亮相、细节或使用展示等分镜内容。

• 已有脚本的视频制作：提供分镜脚本或创意描述，系统结合商品图优化分镜脚本，保留有图片依据的镜头意图。

• 适配不同视频展示位：通过画幅参数适配竖屏短视频、商品主图、详情页和横屏展示。批量生产时，每次请求对应一个商品和一条视频。

3、功能介绍

• 自动选图与分镜规划：无脚本时依据商品标题和图片生成分镜；有脚本时仍进行选图与规划，无需调用方自行整理视频提示词。

• 商品外观一致性约束：以选定的完整商品图作为外观基准，核对其他图片的配色、结构、比例、纹理、版本和规格，仅选取可确认属于同一 SKU 的参考图。

• 灵活的视频规格：无脚本支持 5～15 秒，有脚本支持 5～30 秒；支持 16:9、1:1、3:4、9:16 四种画幅，以及 720P、1080P 两种分辨率。

• 异步生成与任务查询：创建任务后返回任务 ID，调用方通过查询接口获取结果。成片包含背景音乐，无旁白，不新增字幕或营销文字。

4、效果示例

5、开发指南

5.1 请求参数

本服务是异步任务，创建任务使用 POST /v1/product-video/tasks。

字段

类型

必填

说明

product_title

string

是

商品标题。不能为空

product_images

string[]

是

公网图片 URL。至少一张。每一项去掉首尾空白后必须以 http:// 或 https:// 开头

script

string

否

已有脚本。不传或只有空白时走自动规划

duration

integer

否

秒。默认 15。无脚本取值 5 到 15 的整数。有脚本取值 5 到 30 的整数。15.0 视为 15

aspect_ratio

string

否

默认 9:16。允许 16:9、1:1、3:4、9:16

resolution

string

否

默认 720P。允许 720P、1080P。大小写不敏感，服务统一转成大写

画幅按投放位置选择。

aspect_ratio

适用场景

9:16

竖屏短视频和直播间引流，例如抖音、快手、淘宝逛逛、TikTok、Reels

3:4

淘宝天猫竖版主图、详情首屏

1:1

商品主图视频和跨境平台商品页，例如淘宝方形主图、京东、亚马逊、Shopee

16:9

商品详情页、PC 店铺和横屏视频平台

查询任务

GET /v1/product-video/tasks/{task_id}

字段名称

字段详情

* task_id  string

路径参数。创建任务时返回的本服务任务 ID。
示例值：task_001

5.2 请求示例

  • 无脚本生成

{  
  "product_title": "白色简约陶瓷马克杯",  
  "product_images": [
    "https://example.com/cup-front.jpg","https://example.com/cup-side.jpg"  ],  
  "duration": 15,  
  "aspect_ratio": "9:16",  
  "resolution": "720P" 
}

  • 有脚本生成

{  "product_title": "白色简约陶瓷马克杯",  
  "product_images": [
    "https://example.com/cup-front.jpg"  ],  "script": "0到5秒展示完整杯身。5到10秒展示杯口和手柄。10到15秒拉远收尾。", 
  "duration": 15,  
  "aspect_ratio": "9:16",  
  "resolution": "720P" 
}

示例图片地址为占位地址，调用时需替换为公网可访问的实际商品图片 URL。

  • 默认值

项目

默认

时长

15 秒

画幅

9:16

分辨率

720P

分镜

三段。首尾各最多一个镜头，中间最多两个

声音

背景音乐，无旁白

字幕和营销文字

不生成，不叠加

卖点

只拍参考图里看得到的细节和使用方式。不打字，不配旁白，不从标题推断功效

5.3 响应参数

字段

说明

task_id

本服务的任务 ID

status

当前状态

route

受理时写入的 DIRECT 或 AUTO_PLAN

used_prompt

实际交给 Wan 的完整提示词，含保真前缀。失败或尚未提交时为 null

video_url

Wan 返回的视频地址。成功时才有。地址有效期 24 小时。本期不转存

error

失败时的错误对象。成功时为 null

返回 HTTP 202（此时还未调用模型）。

{
  "task_id": "task_001",
  "status": "PENDING",
  "route": "AUTO_PLAN"
}

5.4 响应示例

  • 响应就结果

  • 返回 HTTP 202（此时还未调用模型）。

{
  "task_id": "task_001",
  "status": "PENDING",
  "route": "AUTO_PLAN"
}

  • 成功结果

{
  "task_id": "task_001",
  "status": "SUCCEEDED",
  "route": "AUTO_PLAN",
  "used_prompt": "以下图片按传入顺序编号：\n图1：整体外观与配色基准。\n\n……",
  "video_url": "https://example.com/result.mp4",
  "error": null
}

  • 任务状态

状态

含义

PENDING

已受理，尚未开始规划

PLANNING

正在调用 Qwen 并校验规划结果。两条链路都会进入

GENERATING

Wan 任务已提交，Java 正在轮询

SUCCEEDED

Wan 返回成功和视频地址

FAILED

校验失败、规划失败或 Wan 失败

正常流程：PENDING → PLANNING → GENERATING → SUCCEEDED。入参校验失败时从 PENDING 转为 FAILED；规划失败时不进入 GENERATING。失败后不自动重新规划，也不切换备用模型。

6、错误码

error.code

归因

何时使用

InvalidParameter

调用方

入参不合法，脚本与商品品类不符，或下游明确返回图片、内容审核、侵权、请求参数类错误

DownstreamUnavailable

服务

模型调用失败、返回无法解析，或其他未列入上表的下游错误

  • 入参校验错误

条件

错误信息

图片缺失、为空或含空白项

product_images cannot be empty or null

图片 URL 非 HTTP 或 HTTPS

product_images must be http or https URLs

标题为空

product_title cannot be empty or null

无脚本时时长非法

duration must be an integer between 5 and 15 when script is empty

有脚本时时长非法

duration must be an integer between 5 and 30

画幅不在允许范围

aspect_ratio must be one of 16:9, 1:1, 3:4, 9:16

分辨率不在允许范围

resolution must be one of 720P, 1080P

脚本与商品品类明显不符

script does not match product images

  • 其他失败原因

条件

错误信息

内容审核未通过

input content did not pass content inspection

输入内容存在侵权风险

input content may infringe intellectual property

图片文件不合法

invalid image file

输入内容过长

input is too long

图片或请求参数不合法

invalid image or request parameter

模型或下游服务失败

Algorithm service failed

规划或提交结果无法解析

Algorithm result parsing failed

前五类归为 InvalidParameter；服务失败及结果解析失败归为 DownstreamUnavailable。

7、计费方式

仅在视频生成成功后计费，按下游返回的实际视频时长计算。受理成功或提交成功不表示已完成计费条件。任务失败不计费，查询响应不透出 usage。

计费规格

计费单位

价格

输出视频 480P

元/秒

0.6

输出视频 720P

元/秒

1.2

8、使用限制

  • 系统从输入图片中选择最多 10 张参考图。该数值为入选参考图上限，不是请求图片数量上限。只有一张合适图片时，也可生成视频。

  • 优先提供完整、清晰、无遮挡的单商品整体图，再补充同一 SKU 的其他视角、细节或真实使用图。纯文字图、通用示意图、无法确认一致性的图片，以及拆解零件或未组装形态的图片不入选。SKU 一致性依据图片判断，本接口不接收 SKU 标签，也不核验后台 SKU 编号。

  • 只有源图明确展示人物实际使用同一商品时，才允许安排人物出镜。只有手部或身体局部时，不扩展成完整模特；没有适用的使用图时，不生成额外人物、手部或人体局部。

  • 视频不新增字幕、标题、价格、参数数字、营销文案、额外 Logo、水印或界面文字。商品表面原有印字和标识按源图保留。卖点仅转换为有图片依据的细节或使用画面，不生成旁白。

上一篇：空位检测下一篇：电商视频生成