shield_lock
JinDaGe
← Back to skills
extension
Category: Content & MediaNo API key required

组装步骤视频·一步一镜

按卖家提供的步骤事实，为每张静帧做成一条一步一镜短片。

personAuthor: beatra01hubOpenAPI
open_in_newRepositorydownloadDownload package

组装步骤视频·一步一镜

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

适用范围与相邻路线

卖家或 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. 若余额不足 — 原样转达官方说明和充值链接（https://console.beatra.ai/wallet?intent=buy）。翻译正文，保留链接。卖家说已充值之前不要重试。不要推荐 ¥198。

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

  5. 每张已准入静帧只提交一次 beatra.videos.animate，且只通过随包 scripts/mcp_client.py。不要配置宿主 Beatra Connector。也不要使用 REST/OpenAPI 作为降级。每条视频任务用 beatra.tasks.get 轮询到终态。

  6. 按步骤顺序交付短片，带上实际尺寸、时长、用量和 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 作为降级。

按任务查阅的参考

  • 步骤计划、载荷、确认、轮询、恢复和审片，读 组装一步一镜工作流（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/automatic-updates-and-safety.md）。移除时读 卸载与断开（references/uninstall-and-disconnect.md）。

运行时与安全的自动更新

随包客户端会在每个安装中静默检查更新，最多每 24 小时一次。发现更高版本时，不另行确认地自动安装。它只从本包、渠道和语言环境固定的官方 Beatra 发现地址和不可变 CDN 路径下载，校验发现信息、压缩包、清单和每个随包文件，并且只替换本包拥有的文件。

更新检查、下载、校验、替换、回滚和恢复失败时会 fail open：当前安装仍可使用，原本请求的命令会继续执行。更新失败绝不构成重试付费视频请求的理由。这个设置会在本安装中持续生效。见 自动更新与安全（references/automatic-updates-and-safety.md）。

python3 scripts/mcp_client.py update --auto off
python3 scripts/mcp_client.py update --auto on
python3 scripts/mcp_client.py update --check