淘宝天猫主图视频制作器
将真实商品图和商家提供的商品信息制作成一支简洁、以商品为主的淘宝或天猫商品页视频。先让商品清晰出场,再呈现一个细节或使用瞬间,最后干净收尾。无论选择哪条路线,始终将商品、包装、标签、颜色和商家提供的其他必须保留信息放在画面中心。
适用范围与相邻路线
本 Skill 面向从真实商品图出发、始终聚焦商品本身的淘宝或天猫主图视频。适用于新品上架、季节性商品页更新,以及适合用短视频呈现细节的商品。
需要带口播的竖版带货短片时,请使用 product-video-studio。静态商品页图片请使用 ecommerce-listing-image-set 或 product-photo-studio。视频号商品展示请使用 wechat-channels-product-video。对已有视频进行剪辑或创作时,请使用 beatra-ai-video-studio。
输入与合理默认值
硬性输入是一张宿主可以检查、且用户有权使用的真实商品图。仅在缺失时请求。复用对话中已有的商品名称、目标人群、已确认卖点、包装、logo、颜色、视觉参考,以及目标淘宝或天猫投放位置。
可见的形状、颜色、表面质感和使用方式可以用于确定视觉方向。规格、价格、促销、认证、保修、性能主张和库存由商家提供。只有可见信息时,仍可按商品主体方向继续;仅当会改变商品叙事时,再请求一条商家提供的信息。
默认先提出一条静音、单商品、单动作的视频:1:1、720p、5 秒,首帧可辨认、动作克制并以干净的商品画面结束。最终画布、分辨率、时长和静音输出控制项由当前投放位置和实时模型卡决定;在付费确认中写明已接受的选择,不将这项建议当作平台保证。
先规划商品故事
付费前先免费完成规划:
- 商品开场画面 — 清楚呈现真实商品,并保留商家提供的必须保留信息。
- 细节或使用瞬间 — 展示一个商家提供的卖点、可见的质感、包装细节或简单的使用情境。
- 干净收尾 — 让焦点回到商品,为商家的商品页呈现预留空间。
检查本地商品图的 MIME 类型、字节大小、尺寸、宽高比、透明度和可见商品状态。选择直接动画前,读取实时的 image_to_video 模型卡时使用 beatra.models.list。仅当需要相应路线时再读取 image_to_image、reference_to_video 或 frames_to_video。选定模型卡是媒体、画布、分辨率、时长、控制项、模型和当前计费依据的唯一准则。
选择最小的商品保真路线
- 干净商品图 → 严格首帧动态。 上传已准入的商品图;仅当
beatra.videos.animate的实时image_to_video模型卡支持所选的静音画布、分辨率和时长时使用它。它的image是严格首帧,因此在动态方向中保留每项商品必须保留信息。 - 商品图需要适合商品页的首帧 → 变换、接受、再生成动态。 使用
beatra.images.transform,并将商品 artifact 放在images的第一位,以制作选定画布。可访问时检查返回的首帧,之后将已接受的 artifact 用于beatra.videos.animate。 - 商品图加动态参考 → 参考视频。 仅当
beatra.videos.generate_from_references的实时reference_to_video模型卡支持这个有序组合后使用它。商品图放在第一位,并按真实顺序标明每项参考。该路线将商品图和参考素材用作视觉引导;不将商品图承诺为严格首帧。 - 已接受的首尾商品帧 → 补间。 当两个边界都需要时使用
beatra.videos.interpolate。如需对收尾帧做聚焦的商品调整,先基于已接受的首帧 artifact 使用beatra.images.edit,再进行补间。
选择支持静音输出的实时模型卡路线。仅在所选模型卡支持时传入 generate_audio: false;这条静音商品展示路线绝不附加语音、driving_audio、音频参考或 reference_voice。当请求同时要求严格商品开场和单独的动态视频参考时,展示当前严格首帧动画与参考视频两种选择、各自的实时模型卡准入和价格,再由用户选择优先目标。商品图、必须保留信息、参考顺序、画布、时长、模型或动态方向改变,都是新的付费工作。
确认每个付费阶段
规划、商品页文案方向、本地媒体检查、上传和实时模型卡比较免费。图片变换、聚焦图片编辑、动画、参考视频生成和补间均为付费工作。
每个付费阶段前,用精简确认单冻结:
- 用于方向的商品必须保留信息与商家提供事实;
- 每个源素材和参考素材的精确顺序与角色;
- 选定路线、提示词,以及适用时的首尾帧处理;
- 实时模型卡允许的模型、控制项、画布、分辨率、时长、静音输出设置、当前计费依据和最高费用;
- 付费调用次数、交付检查计划,以及每个逻辑付费请求对应的新不透明稳定
client_request_id。
对于变换后的首帧,先确认付费准备工作,再执行变换。之后检查可访问的返回帧,并为依赖的视频获取单独确认。已批准 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.net_charged_credits。当宿主可以查看媒体时,按已接受计划检查商品开场、形状、颜色、标签、包装、必须保留信息、动态稳定性、静音呈现和最终商品画面。明确区分返回的任务事实与宿主无法检查的细节。
若创建响应确实未知,先按匹配能力使用 beatra.tasks.list,再用 beatra.tasks.get 检查可能的候选任务。将保留的 payload、媒体顺序、模型、画布、时长和时间与本地账本比对。仅当证据支持完全相同的重试时,才以相同原始 ID 重放字节完全相同的冻结 payload。缓慢任务或连接丢失仍是原任务。
仅在用户要求取消时调用 beatra.tasks.cancel 一次;若返回 409,继续轮询原任务并报告其终态。失败阶段不会使已成功返回的源 artifact 失效;后续可据此发起一项重新确认的修改。
按任务查阅参考
- 使用淘宝主图视频工作流(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/automatic-updates-and-safety.md)了解更新保证和控制项。
- 使用卸载与断开(references/uninstall-and-disconnect.md)移除此包或共享凭据。
运行时与安全自动更新
随包客户端会在每个安装中静默检查更新,最多每 24 小时一次。发现更高版本时,不另行确认地自动安装。它只使用针对本包、渠道和语言环境固定的 Beatra 官方发现地址和不可变 CDN 路径;在替换前校验发现信息、压缩包、清单和每个文件的大小与校验和;并且只替换本包拥有的文件。它拒绝重定向、降级、不匹配的包/渠道/语言环境/版本数据、意外 URL、不安全压缩包,以及包拥有目标之外的文件。
更新检查、下载、校验、替换和回滚失败时会 fail open:当前安装仍可使用,原本请求的命令会继续执行。更新失败绝不授权替换付费请求。该设置会在本安装后续命令中持续生效。
python3 scripts/mcp_client.py update --auto off
python3 scripts/mcp_client.py update --auto on
python3 scripts/mcp_client.py update --check
--auto off 会关闭静默检查,--auto on 会恢复静默检查,--check 会报告官方可用版本但不替换文件。请参阅自动更新与安全(references/automatic-updates-and-safety.md)。
微信扫一扫