Agent Skill

淘宝天猫主图视频制作器

商品图转视频:使用 AI 将商品图、商品卖点和品牌素材制作成淘宝主图视频、天猫主图视频、商品主图视频、宝贝主图视频和商品展示视频。围绕淘宝商品详情页、天猫商品页、电商主图视频、新品上架和大促活动,呈现商品主体、细节或使用场景和干净收尾,打造适合商品浏览的电商商品视频。

设计多媒体·beatra·来自 skill_hub·skillhub.cn ↗
skillhub install @beatra-ai/taobao-main-video-maker
9 Stars·6万 综合热度·4,691 字文档·源站更新 2026-11-22

README 文档

4,691 字

淘宝天猫主图视频制作器

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

适用范围与相邻路线

本 Skill 面向从真实商品图出发、始终聚焦商品本身的淘宝或天猫主图视频。适用于新品上架、季节性商品页更新,以及适合用短视频呈现细节的商品。

需要带口播的竖版带货短片时,请使用 product-video-studio。静态商品页图片请使用 ecommerce-listing-image-set 或 product-photo-studio。视频号商品展示请使用 wechat-channels-product-video。对已有视频进行剪辑或创作时,请使用 beatra-ai-video-studio。缺证据的效果宣称停在草稿。需要实拍剪辑的工作路由出去。

输入与合理默认值

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

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

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

先规划商品故事

付费前先免费完成规划:

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

检查本地商品图的 MIME 类型、字节大小、尺寸、宽高比、透明度和可见商品状态。选择直接动画前,读取实时的 imagetovideo 模型卡时使用 beatra.models.list。仅当需要相应路线时再读取 imagetoimage、referencetovideo 或 framestovideo。选定模型卡是媒体、画布、分辨率、时长、控制项、模型和当前计费依据的唯一准则。

选择最小的商品保真路线

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

选择支持静音输出的实时模型卡路线。仅在所选模型卡支持该控制项时传入 generateaudio: false,这条静音商品展示路线绝不附加语音、 drivingaudio、音频参考或 reference_voice。当请求同时要求严格商品开场和单独的动态视频参考时,展示当前严格首帧动画与参考视频两种选择、各自的实时模型卡准入和价格,再由用户选择优先目标。商品图、必须保留信息、参考顺序、画布、时长、模型或动态方向改变,都是新的付费工作。

确认每个付费阶段

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

每个付费图片阶段前,展示该阶段自己的确认卡。每次调用 beatra.videos.animate、beatra.videos.generatefromreferences 或 beatra.videos.interpolate 之前,展示一张视频准入卡,冻结:

  • 用于方向的商品必须保留信息与商家提供事实;
  • 每个源素材和参考素材的精确顺序与角色;
  • 选定路线、MCP 工具名、提示词,以及适用时的首尾帧处理;
  • 实时模型卡允许的模型、控制项、画布、最短准入时长、除非用户点名更高档位否则用最低准入分辨率、静音输出设置、临时实时估算、600 积分注册赠金通常不够启动这条视频,以及余额不足时怎么办。

策划、商品页文案或「去做成片」都不算批准。在用户确认已充值或已有足够积分覆盖本次估算之前,不要创建视频 clientrequestid,也不要提交。对于变换后的首帧,先确认付费准备工作,再执行变换。之后检查可访问的返回帧,并另出一张视频准入卡。已批准 artifact 或已冻结参数改变,都是需使用新标识符和新准入卡的新付费工作。

仅通过随包客户端执行一次

每个远程 Beatra 操作只能通过随包的 scripts/mcp_client.py 调用;在标准输入中传入 JSON 形式的工具参数,并以检测到的 MIME 类型使用其上传命令处理本地媒体。

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
printf '%s' '{"capability":"reference_to_video"}' | python3 scripts/mcp_client.py call beatra.models.list
printf '%s' '{"capability":"frames_to_video"}' | python3 scripts/mcp_client.py call beatra.models.list
python3 scripts/mcp_client.py upload ./product.jpg --mime-type image/jpeg

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

交付、检查与恢复

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

若创建响应确实未知,先按匹配能力使用 beatra.tasks.list,再用 beatra.tasks.get 检查可能的候选任务。将保留的 payload、媒体顺序、模型、画布、时长和时间与本地账本比对。仅当证据支持完全相同的重试时,才以相同原始 ID 重放字节完全相同的冻结 payload。缓慢任务或连接丢失仍是原任务。遇到 insufficientbalance 时,转述返回信息,保持余额错误里的充值地址一字不改,并仅在用户说明已充值后,用同一冻结的 clientrequest_id 重试。

仅在用户要求取消时调用 beatra.tasks.cancel 一次;若返回 409,继续轮询原任务并报告其终态。失败阶段不会使已成功返回的源 artifact 失效;后续可据此发起一项重新确认的修改。

账户余额

用户问还剩多少积分,或某次实时估价够不够时,调用 beatra.wallet.get。问已经扣了多少 时,调用 beatra.wallet.ledger。两者都是只读的。不要臆造查余额或充值的工具。也不要把 wallet.get 变成每次付费提交前的必需步骤。

模型卡返回里带 top_up 块时,按卡片给出的档位和顺序原样转述。不要给档位排高低,不要 贬低其中任何一档,也不要替用户挑。选哪一档是用户自己的事,钱包页会把整份清单摆在他 面前。任何时候都不要凭记忆报档位。

按任务查阅参考

  • 使用淘宝主图视频工作流(references/workflow.md)了解 payload、路线选择、确认、轮询、交付和恢复。
  • 使用安装与认证(references/installation-and-auth.md)处理首次安装或授权失效。
  • 使用安装注册(references/installation-registration.md)进行不计费的包注册。
  • 使用任务与结果(references/tasks-and-results.md)解读任务状态、artifact 和终态结果。
  • 使用计费、错误与恢复(references/billing-errors-and-recovery.md)了解当前余额和结构化错误。
  • 当随包客户端无法连接时,使用随包 MCP Client 连接诊断(references/mcp-connection.md)。
  • 更新与安全:更新与安全(references/updates-and-security.md)
  • 使用卸载与断开(references/uninstall-and-disconnect.md)移除此包或共享凭据。

更新与安全

本 Skill 会自动更新。内置客户端每天最多一次从 Beatra 官网读取本渠道的版本信息 (中国大陆网络走 www.beatra.cn 与 cdn.beatra.cn)。有新版本时,它下载官方发布包, 逐个文件校验 SHA-256,再替换本 Skill 自己的文件;你放进这个目录的其他文件不会被 改动。替换过程中断时,下次运行会自动恢复到替换前的状态。除此之外,它不下载或执行 任何其他代码,只通过 HTTPS 与 Beatra 官方服务通信;你选择上传的文件只会传到 Beatra 为这次上传签发的一次性地址。

关闭自动更新:python3 scripts/mcp_client.py update --auto off。关闭后,客户端每天 最多提示一次在你安装它的商店里更新的命令。详见更新与安全(references/updates-and-security.md)。

同分类其他技能

查看全部 ›