电商商品素材

你会拿到

一份画面清单：主图、一张材质特写、一张比例图、一张使用图，以及短片。
一张主图和你确认的详情配图。你提供商品图时，每一帧里都是这个商品。
一条十五秒以内的口播商品短片，从已接受的主图做出，人声下面有一条轻配乐。

怎么跑

静帧和短片。默认。
只出清单。在你确认画面之前这是默认。在卡上划掉任何一帧。
带一次品类读取。你要求看这类商品在抖音或小红书上怎么被展示时，在画面清单定稿之前查一次。

一个商品上架前需要主图、详情和一条短片，就从这里开始。

范围和相邻路线

这条路线用于商品上架前需要的图片和一条短片。没有上架任务的品牌海报走视觉创作。已经导出的文件要审核，走营销素材审核。

输入和默认

硬性输入是这个商品：它是什么，以及必须长什么样。缺了只问这个。默认方形主图、3:4 详情配图，以及一条十五秒以内的竖屏短片。用户提供商品照片时，用 beatra.assets.upload 上传，并让每一帧都保持这个商品。没有照片时，说明画面是按描述画的。不要读取店铺后台、订单或广告账户。

黄金路径

写出画面清单并展示。这段文字不收费。
这次包含品类读取时，一张查询卡：beatra.social.tools.search、beatra.social.tools.get，复制 schema_hash，一次 beatra.social.execute。允许的键是 social.douyin.video.search 和 social.xiaohongshu.note.search。用它来决定构图。不要把这些帖子当成这家店的销量。
每张已确认的静帧是一次 beatra.images.transform，在 beatra.models.list 之后，载荷 {"capability": "image_to_image"}，从商品照片或已接受的主图出发。没有照片时，只有主图是 beatra.images.generate，载荷 {"capability": "text_to_image"}。静帧改了商品时，一次 beatra.images.edit，载荷 {"capability": "image_edit"}，把商品恢复回来。
beatra.voices.list，卖点那句话一次 beatra.speech.synthesize，载荷 {"capability": "text_to_speech"}，以及一条轻器乐 beatra.music.generate，载荷 {"capability": "text_to_music"}。
制作卡，然后视频卡：一次 beatra.videos.animate，载荷 {"capability": "image_to_video"}，从已接受的主图出发，这句话作为 driving_audio，时长是下一个整秒。
一次 beatra.videos.compose 保留这句话并把配乐压低。用 beatra.tasks.get 轮询，交付画面、短片和 billing.net_charged_credits。

需要确认的决定

规划和写出来的文字不收费，也不算批准。

每次付费调用之前，出示当前的制作卡并等待：

做什么：用用户的话说出将要做出的东西，并说明这次是生成还是查询。
积分：刚刚从模型卡或 beatra.social.tools.get 读到的现价。不要沿用记得的数字。
次数：每个槽位一次付费调用。制作卡可以列出每张静帧、口播和配乐；每个槽位有自己的 client_request_id。查询的下一页是另一次调用。短片另等一张卡。
标识：每次调用一个新的不透明 client_request_id。提示词、文件、模型或控制项一变，就换一个新标识。
停在这里：已经写出的文字仍然可用。
余额不足：原样转达官方消息和其中的充值地址。用户说已经充值之前不要重试。

查询和生成是两张卡。已确认的静帧和音频不批准短片。所有远程 Beatra 工具只通过随包 scripts/mcp_client.py 调用。工具名是命令参数，JSON 参数走标准输入。不要配置、调用或使用宿主 Beatra Connector。不要使用 REST/OpenAPI 降级。

创建响应丢失时，只用逐字节相同的载荷和同一个 client_request_id 重试。任务标识丢失时，先调用 beatra.tasks.list，再调用 beatra.tasks.get，对照冻结的请求之后才做相同重试。只有用户要求取消时才调用 beatra.tasks.cancel，然后用 beatra.tasks.get 确认该任务。

用户问还剩多少积分时，调用 beatra.wallet.get。用户问扣了什么时，调用 beatra.wallet.ledger。

按任务阅读

画面任务、短片载荷和一套做成的素材，读场景工作流（references/workflow.md）。任务卡住、响应丢失、价格看起来不对，或一帧改了商品，读出错时怎么处理（references/faq.md）。连接还没就绪时，读安装与认证（references/installation-and-auth.md）。首次注册，读安装注册（references/installation-registration.md）。调用在任务出现之前失败时，读随包 MCP Client 连接诊断（references/mcp-connection.md）。任务在排队、运行或找不到时，读任务与结果（references/tasks-and-results.md）。扣费、退款或丢失的响应需要共用规则时，读计费、错误与恢复（references/billing-errors-and-recovery.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）。