组装步骤视频·一步一镜

概述

把已授权的组装静帧和卖家提供的步骤事实，做成每步一条短片。按步骤顺序交付。不要拼接。

适用范围与相邻路线

卖家或 Listing 团队要用已经拍好的组装步骤照做短片时，使用本 Skill。

一张商品照加口播做成会说话的成片时转到 product-video-studio。房源房间静帧转到 listing-room-video-pack。不是组装步骤的通用静帧转到 image-to-motion。不要到公开帖子里补缺失步骤。

输入与默认值

硬输入是：

• 至少一张宿主 Agent 可以查看的静帧，并按步骤顺序排好；
• 卖家提供的步骤事实，说明每张静帧里是哪个零件、动作或序号。

不要编造缺失步骤、扭矩规格、工具清单或警告。静帧不是未写明说明的来源。复用对话里已有的 SKU 名称、语言、投放位置和必须保留项。只补问缺失的硬输入。

默认每张静帧一次 beatra.videos.animate，model: "auto"，静帧作严格首帧，不带 driving_audio，画幅由源图决定。和用户选定 2–15s 范围内的整数时长；用户不选时用 5s。

标准路径

1. 查看每张静帧。记录 MIME 类型、宽、高、画幅、字节大小和是否有 alpha 通道。本地文件检查后，只通过随包客户端上传。绝不要把本地路径传给远程工具。
2. 只用卖家事实和静帧里看得到的内容写带标注的一步一镜计划。保持步骤顺序。缺事实的静帧留在计划里。这份计划就是免费可见结果。规划不是批准。
3. 调用 beatra.models.list 并传入 {"capability":"image_to_video"}。对照当前卡片，确认接受无 driving audio 的首帧图。把每张图的事实和选定时长对照公布约束。任何必要媒体事实不可用或不兼容时，停在视频之前。
4. 任何视频 client_request_id 或 beatra.videos.animate 调用前，先出示一张当前生产卡并等待：

1. 做什么 — 每张点名的静帧一条组装步骤短片，一次生成调用（beatra.videos.animate）。
2. 积分 — 刚读到的 image_to_video 价格。不要复用记忆中的数字。
3. 几笔 — 每张静帧一次付费调用。不要把多步塞进同一次提交。
4. 身份 — 每张静帧一个新的不透明 client_request_id。提示词、静帧、时长、模型或控件变了就换新标识。
5. 若停在这里 — 带标注的步骤计划仍然可用。
6. 若余额不足 — 原样转达官方说明和充值链接。翻译正文，保留链接。卖家说已充值之前不要重试。

用户确认已充值或余额足够之前不要提交。

1. 每张已准入静帧只提交一次 beatra.videos.animate，且只通过随包 scripts/mcp_client.py。不要配置宿主 Beatra Connector。也不要使用 REST/OpenAPI 作为降级。每条视频任务用 beatra.tasks.get 轮询到终态。
2. 按步骤顺序交付短片，带上实际尺寸、时长、用量和 billing.net_charged_credits。核对接步骤身份、运动和必须保留的细节漂移。绝不要发明拼接、concat 或剪辑工具。

需要确认的决定

规划和当场报价不扣费。它们不是批准。视频动画需要上面的六字段卡。拿到文件不等于同意把静帧用到这套步骤之外。

恢复

每张付费静帧有自己的冻结载荷和标识。丢失创建响应时，只许用该静帧完全相同的载荷恢复。丢失任务标识时，通过 beatra.tasks.list 和 beatra.tasks.get 找回。只有用户要求取消该静帧时才调用 beatra.tasks.cancel；遇到 409 继续轮询。遇到 insufficient_balance 时保持充值链接原样，用户说已充值后才用同一冻结标识重试。创建返回没有 task_id 时不要轮询；对账后再决定是否签发新标识。静帧、提示词、时长或模型变了就是新工作，要换新卡。

执行

每个远程 Beatra 操作都只通过本包随附的 scripts/mcp_client.py 调用。把 MCP 工具名放在 call 后面，并向标准输入发送一个 JSON 对象。

python3 scripts/mcp_client.py call beatra.models.list

{"capability": "image_to_video"}

不要配置或调用宿主 Beatra Connector，也不要使用 REST/OpenAPI 作为降级。

账户余额

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

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

按任务查阅的参考

• 步骤计划、载荷、确认、轮询、恢复和审片，读 组装一步一镜工作流（references/workflow.md）。
• 授权和非计费注册步骤，读 安装与认证（references/installation-and-auth.md） 和 安装注册（references/installation-registration.md）。
• 共用的任务、计费和连接细节，读 任务与结果（references/tasks-and-results.md）、计费、错误与恢复（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）。