短剧创作工坊
你会拿到
- 一份制作设定：谁保持不变，哪些服装和道具是长期的，哪些状态只属于一个节拍。
- 一份节拍表。每个节拍有一件戏剧任务、视觉锚点、构图、对白和时长。
- 每个主要人物和反复出现的场景各一张竖屏参考静帧，然后每个要出图的节拍一张竖屏静帧，都锁在这些参考上。
- 每个有对白的节拍一句口播，用这个人物的声音。
- 一条原创器乐。
- 一条竖屏成片，由你接受做运动的镜头组成：钩子、转折和收束，除非你点名更多。每个运动镜头从它已接受的静帧开始。成片带上对白、配乐和字幕。
怎么跑
- 工坊套装。默认。先设定和节拍表，再做你确认的静帧、对白和配乐，然后成片。
- 一个动画镜头。只有这一轮的静帧，或你提供的静帧，成为开场帧之后。
- 你提供的声音。一次克隆，只有当你交出一段干净的单人样本，并确认你有权使用它。否则每个人物用账户里的一条现成声音。
有人带着前提，想要一条能看的竖屏集，而不是单条电影镜头，也不是商品广告，就从这里开始。
范围和相邻路线
这条路线用于按节拍讲的竖屏短剧：爱情、悬疑、喜剧或催泪。没有整集骨架的单条电影镜头走镜头路线。漫画分格走漫画短剧。没有戏剧节拍的商品广告走商品视频。
输入和默认
硬性输入是短剧前提：关于谁、冲突是什么、结尾是什么感觉。缺了只问这个。沿用已知的演员、服装和场景。
默认竖屏 9:16、六到八个节拍、每个节拍一张静帧、每个有对白的节拍一句口播，以及一条器乐。每个节拍都出图。让钩子、转折和收束动起来，其余节拍保持静帧，除非用户点名。静帧被接受之前不要做成镜头。运动镜头最多八个，以便收成一条。
黄金路径
- 写出设定和节拍表并展示。把长期身份和只属于一个节拍的状态分开。这段文字不收费。
- 用户提供脸、服装照片或场景照片时，用
beatra.assets.upload上传，并把这个文件留作参考。没有照片的第一张参考静帧是一次beatra.images.generate，在beatra.models.list之后，载荷{"capability": "text_to_image"}。之后每张静帧是一次beatra.images.transform，载荷{"capability": "image_to_image"}，用已接受的人物和场景文件，最多四张。 - 用
beatra.voices.list为每个说话人选一条现成声音，这个人的每句对白都用这个声音。提供的样本是一次beatra.voices.clone，载荷{"capability": "voice_clone"}，并且只在用户确认权利之后。然后每个已确认的对白一次beatra.speech.synthesize，载荷{"capability": "text_to_speech"}。 - 配乐调用
beatra.models.list，载荷{"capability": "text_to_music"}，然后一次器乐beatra.music.generate。 - 为静帧、对白和配乐出示制作卡并等待。然后只做这些槽位。
- 每个接受做运动的镜头，调用
beatra.models.list，载荷{"capability": "image_to_video"}，从这张静帧提交一次beatra.videos.animate。节拍有对白时，把这句口播作为driving_audio传入，并选择接受图像加驱动音频的模型。用户也接受了结束帧时，改用beatra.videos.interpolate，载荷{"capability": "frames_to_video"}。有人物和场景参考但没有单张开场静帧时，用beatra.videos.generate_from_references，载荷{"capability": "reference_to_video"}。 - 视频卡是分开的。已确认的静帧、对白和音乐不批准它。
- 每个运动镜头都成功之后，用
beatra.videos.compose收成一次。这次拼接不收费，也不另需一张卡；它写在视频卡上。用beatra.tasks.get轮询，交付成片、零件和billing.net_charged_credits。
静帧回来脸、服装或道具不对时，一次 beatra.images.edit，载荷 {"capability": "image_edit"}，用自己的卡，以这张静帧为底。修一次，然后停。
需要确认的决定
规划和写出来的文字不收费，也不算批准。
每次付费调用之前，出示当前的制作卡并等待：
- 做什么：用用户的话说出将要做出的东西，并说明这次是生成、克隆还是查询。
- 积分：刚刚从模型卡读到的现价。不要沿用记得的数字。
- 次数：每个槽位一次付费调用。制作卡可以列出每张静帧、每句对白和配乐；每个槽位有自己的
client_request_id。视频调用另等一张卡。 - 标识：每次调用一个新的不透明
client_request_id。提示词、文件、模型或控制项一变，就换一个新标识。 - 停在这里：已经写出的文字仍然可用。
- 余额不足：原样转达官方消息和其中的充值地址。用户说已经充值之前不要重试。
声音克隆是自己的一张卡。只有用户确认对这段样本有权，并且 consent_attested 为真时才提交。查询和生成是两张卡。已确认的静帧、对白或音乐不批准视频。所有远程 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）。
