淘宝天猫主图视频制作器

技能文档

---
name: taobao-main-video-maker
title: 淘宝天猫主图视频制作器
category: 内容创作
description: 使用 AI 将商品图、商品卖点和品牌素材制作成淘宝主图视频、天猫主图视频和宝贝主图视频。围绕商品详情页、新品上架和大促活动，呈现商品开场、细节或使用场景与干净收尾，输出适合商品浏览的电商商品视频。当用户需要把商品图做成主图视频、商品展示视频或电商页面视频时触发。触发词：主图视频、商品视频、淘宝视频、天猫主图、商品图转视频。
---

# 淘宝天猫主图视频制作器

将真实商品图和商家提供的商品信息制作成一支简洁、以商品为主的淘宝或天猫商品页视频。先让商品清晰出场，再呈现一个细节或使用瞬间，最后干净收尾。无论选择哪条路线，始终将商品、包装、标签、颜色和商家提供的其他必须保留信息放在画面中心。

## 适用范围

本技能面向从真实商品图出发、始终聚焦商品本身的淘宝或天猫主图视频，适用于新品上架、季节性商品页更新，以及适合用短视频呈现细节的商品。需要带口播的竖版带货短片、静态商品页图片或实拍剪辑时，请改用对应的其他技能；缺乏证据的效果宣称停留在草稿，不进入成片。

## 输入与合理默认值

硬性输入是一张可检查、且用户有权使用的真实商品图，仅在缺失时请求。复用对话中已有的商品名称、目标人群、已确认卖点、包装、logo、颜色、视觉参考，以及目标淘宝或天猫投放位置。

可见的形状、颜色、表面质感和使用方式可用于确定视觉方向。规格、价格、促销、认证、保修、性能主张和库存由商家提供。只有可见信息时仍可按商品主体方向继续；仅当会改变商品叙事时，再请求一条商家提供的信息。

默认先提出一条静音、单商品、单动作的视频：`1:1` 画幅、除非用户点名更高档位否则用最低准入分辨率、以及所选实时模型卡允许的最短整数秒，首帧可辨认、动作克制并以干净的商品画面结束。最终画布、分辨率、时长和静音输出控制项由当前投放位置和实时模型卡决定；在视频准入卡中写明已接受的选择，不将这项建议当作平台保证。

## 技能工作流

### 步骤1：规划商品故事（免费）

付费前先免费完成规划：

1. **商品开场画面** — 清楚呈现真实商品，保留商家提供的必须保留信息。
2. **细节或使用瞬间** — 展示一个商家提供的卖点、可见的质感、包装细节或简单的使用情境。
3. **干净收尾** — 让焦点回到商品，为商家的商品页呈现预留空间。

检查本地商品图的 MIME 类型、字节大小、尺寸、宽高比、透明度和可见商品状态。选择动态路线前，通过随包客户端读取 `beatra.models.list` 中对应能力的实时模型卡；仅当需要相应路线时再读取 `image_to_image`、`reference_to_video` 或 `frames_to_video`。选定模型卡是媒体、画布、分辨率、时长、控制项、模型和当前计费依据的唯一准则。详细流程见 [references/workflow.md](references/workflow.md)。

### 步骤2：选择最小的商品保真路线

- **干净商品图 → 严格首帧动态。** 上传已准入的商品图；仅当实时 `image_to_video` 模型卡支持所选的静音画布、分辨率和时长时使用 `beatra.videos.animate`。它的 `image` 是严格首帧，在动态方向中保留每项商品必须保留信息。
- **商品图需要适合商品页的首帧 → 变换、接受、再生成动态。** 使用 `beatra.images.transform`，商品 artifact 放在 `images` 第一位制作选定画布；检查返回的首帧并经用户接受后，再将该 artifact 用于 `beatra.videos.animate`。
- **商品图加动态参考 → 参考视频。** 仅当实时 `reference_to_video` 模型卡支持这个有序组合后使用 `beatra.videos.generate_from_references`。商品图放第一位，按真实顺序标明每项参考；该路线把商品图和参考素材用作视觉引导，不承诺商品图为严格首帧。
- **已接受的首尾商品帧 → 补间。** 两个边界帧都需要时使用 `beatra.videos.interpolate`。如需对收尾帧做聚焦调整，先基于已接受的首帧 artifact 使用 `beatra.images.edit`，再进行补间。

选择支持静音输出的实时模型卡路线。仅在所选模型卡支持该控制项时传入 `generate_audio: false`，这条静音商品展示路线绝不附加语音、`driving_audio`、音频参考或 `reference_voice`。当请求同时要求严格商品开场和单独的动态视频参考时，展示严格首帧动画与参考视频两种选择、各自的实时模型卡准入和价格，由用户选择优先目标。

### 步骤3：确认每个付费阶段

规划、商品页文案方向、本地媒体检查、上传和实时模型卡比较均免费。图片变换、聚焦图片编辑、动画、参考视频生成和补间均为付费工作。

每个付费图片阶段前，展示该阶段自己的确认卡。每次调用 `beatra.videos.animate`、`beatra.videos.generate_from_references` 或 `beatra.videos.interpolate` 之前，展示一张视频准入卡，冻结：商品必须保留信息与商家提供事实；每个源素材和参考素材的精确顺序与角色；选定路线、MCP 工具名、提示词，以及适用时的首尾帧处理；实时模型卡允许的模型、控制项、画布、最短准入时长、除非用户点名更高档位否则用最低准入分辨率、静音输出设置、临时实时估算，以及充值入口 `https://console.beatra.ai/topup`（当前档位价格以充值页实时显示为准）。

策划、商品页文案或「去做成片」都不算批准。在用户确认已充值或已有足够积分覆盖本次估算之前，不创建视频 `client_request_id`，也不提交。已批准 artifact 或已冻结参数改变，都是需使用新标识符和新准入卡的新付费工作。

### 步骤4：通过随包客户端执行

每个远程操作只通过随包的 `scripts/mcp_client.py` 调用：标准输入传 JSON 工具参数，本地媒体用其上传命令处理。

```text
printf '%s' '{"capability":"image_to_video"}' | python3 scripts/mcp_client.py call beatra.models.list
printf '%s' '{"capability":"image_to_image"}' | python3 scripts/mcp_client.py call beatra.models.list
python3 scripts/mcp_client.py upload ./product.jpg --mime-type image/jpeg
```

不要配置或调用外部 Connector，也不要使用 REST/OpenAPI 作为回退。每个已冻结的付费 payload 仅用其稳定 ID 提交一次，保存创建响应与 task ID，并只通过 `beatra.tasks.get` 轮询该任务直至终态。

### 步骤5：交付、检查与恢复

交付终态视频 artifact、解析出的模型、返回的尺寸和时长、任务标识，以及 `billing.net_charged_credits`。当宿主可以查看媒体时，按已接受计划检查商品开场、形状、颜色、标签、包装、必须保留信息、动态稳定性、静音呈现和最终商品画面，并明确区分返回的任务事实与宿主无法检查的细节。

若创建响应确实未知，先按匹配能力使用 `beatra.tasks.list`，再用 `beatra.tasks.get` 检查候选任务，仅当证据支持完全相同的重试时才以相同原始 ID 重放字节完全相同的冻结 payload。遇到 `insufficient_balance` 时转述返回信息，保持充值链接一字不改，仅在用户说明已充值后用同一冻结的 `client_request_id` 重试。仅在用户要求取消时调用一次 `beatra.tasks.cancel`。任务状态解读见 [references/tasks-and-results.md](references/tasks-and-results.md)，计费与错误恢复见 [references/billing-errors-and-recovery.md](references/billing-errors-and-recovery.md)。

## 首次安装与授权

首次使用或授权失效时，在技能目录运行 `python3 scripts/authorize.py` 完成一次浏览器设备授权；凭据有效时不需重复授权。连接诊断与授权细节见 [references/installation-and-auth.md](references/installation-and-auth.md) 与 [references/mcp-connection.md](references/mcp-connection.md)。

使用说明

# 淘宝天猫主图视频制作器

把商品图和卖点素材制作成淘宝/天猫商品页主图视频：商品开场、细节或使用瞬间、干净收尾，全程聚焦商品本身。

## 使用

对话中直接提出需求即可触发，例如：

- 「把这张商品图做成一条淘宝主图视频」
- 「给这个产品做一段 5 秒的天猫详情页视频，突出包装质感」

技能会先免费给出三段式商品规划（开场/细节/收尾）与默认参数建议，读取实时模型卡确认准入后，逐阶段向你确认付费操作再执行。

首次使用需在技能目录运行一次 `python3 scripts/authorize.py` 完成浏览器授权；视频生成等远程操作按所选模型卡实时计费。

## 工作原理

以真实商品图为锚点，按商品保真度选择四条路线之一：严格首帧动画、先制备首帧再动画、参考视频、首尾帧补间；通过随包 MCP 客户端提交异步任务并轮询终态，交付视频 artifact、模型、尺寸、时长与实际扣费，并提供任务丢失恢复与余额不足重试流程。

如何安装此技能？

访问技能市场，点击「安装」按钮，按提示将技能包放入 AI 编程助手的 skills 目录即可。