理财产品口播·说明书转口播
把顾问提供的产品说明书要点和授权静帧，做成每张静帧一条口播。交付 2 到 8 条。不要拼接。只说这份说明书上已经写好的产品要点。
适用范围与相邻路线
理财顾问或厅堂投教要用可授权静帧、把已经拿到的产品说明书读成短口播时，使用本 Skill。
不是说明书朗读的通用讲述者转到
talking-avatar-video。民宿欢迎转到
airbnb-welcome-avatar。上新预告转到
creator-drop-talking。已公开交易日历朗读转到
market-calendar-talking。只要财报稿朗读、不要视频转到
earnings-script-read。无声商品动态转到
product-video-studio。只要说明书分页静图、不要口播视频转到
fund-page-set。
收集这份说明书
硬输入是：
- 至少一张宿主 Agent 可以查看的静帧——出镜人像或将作为首帧的说明书图；
- 顾问已经提供的产品说明书要点（名称、期限、规则、费用、页面上已有的风险等级）；
- 画面里会出现人脸或要克隆声音时的形象和声音权利；
- 这包要几条，或允许使用默认 3 条。
复用已知措辞、场所名称，以及冻结的 voice_id。
只补问缺失的硬输入。2 到 8 以外的数量也能做：确认该规模和实时费用。
不要编造收益率、评级、买入建议、涨跌路径或未写明的条款。拿到文件不等于同意。
查看每张静帧。记录 MIME 类型、宽、高、画幅、字节大小和是否有 alpha 通道。本地文件检查后，只通过随包客户端上传
（scripts/mcp_client.py / beatra.assets.upload）。保留返回的产物编号。绝不要把本地路径传给 beatra.voices.clone、
beatra.speech.synthesize 或 beatra.videos.animate。
先做免费槽表
任何付费克隆、旁白或视频前，先写带标签的产品口播清单。顾问没有另报 2 到 8 之间的数量时，默认三个槽位：产品卖点、期限与规则、费用。每个槽位记下静帧、由已提供说明书写出的口播句、作为 2–15s 成片的目标时长，以及用目录音色、已确认音轨还是克隆。
这份清单就是免费可见结果。规划不是批准。
安全默认：
- 每张静帧一次
beatra.videos.animate； model: "auto"，除非顾问选了实时 SKU；- 静帧作严格首帧；
- 画幅由源图决定；
- 时长由音频决定，落在 2–15s。不要拼接。
确认克隆、旁白，再确认视频
克隆、旁白和视频是分开的付费阶段。每个阶段各自一张六字段卡，每个槽位各自一个不透明 client_request_id。
顾问要克隆音色时，先查看其可授权样本，读取当前的 voice_clone 卡片，并在 beatra.voices.clone 之前等在克隆卡上。找到的文件不是克隆同意。出示克隆卡并等待：
- 做什么 — 一份可授权声音样本（
beatra.voices.clone）。 - 积分 — 刚读到的
voice_clone价格。不要复用记忆中的数字。 - 几笔 — 这份样本一次付费克隆。
- 身份 — 一个新的不透明
client_request_id。 - 若停在这里 — 带标签的槽表仍然可用。
- 若余额不足 — 原样转达官方说明和充值链接。翻译正文，保留链接。顾问说已充值之前不要重试。
旁白前，调用 beatra.models.list，能力为 text_to_speech：
{"capability": "text_to_speech"}
目录音色还没定时再用 beatra.voices.list。
出示旁白卡并等待：
- 做什么 — 每个点名槽位一句说明书口播
（beatra.speech.synthesize）。 - 积分 — 刚读到的
text_to_speech价格乘以槽位数。不要复用记忆中的数字。 - 几笔 — 每个槽位一次付费旁白。
- 身份 — 每个槽位一个新的不透明
client_request_id。 - 若停在这里 — 带标签的槽表仍然可用。
- 若余额不足 — 原样转达官方说明和充值链接。翻译正文，保留链接。顾问说已充值之前不要重试。
每个旁白槽位只通过随包 scripts/mcp_client.py 提交一次。用
beatra.tasks.get 轮询。读取实际音频 MIME、时长和大小。文稿预览不是音频审听。
视频前，调用 beatra.models.list，能力为 image_to_video：
{"capability": "image_to_video"}
确认当前卡片接受 [image, driving_audio]。把每张图的事实和真实音频 MIME、时长、大小对照公布约束。实时 driving-audio 成片是 2–15s。旁白长于最长可容纳成片时，拆成连续可容纳分段；每段各自新的旁白和新的视频，各用新标识。不要把分段拼成一个文件。已确认旁白并不批准视频。600 积分注册礼金通常开不起这次视频。出示视频卡并等待：
- 做什么 — 每张点名静帧一条说明书口播
（beatra.videos.animate）。 - 积分 — 刚读到的
image_to_video价格乘以分段数。不要复用记忆中的数字。 - 几笔 — 每段已确认音频一次付费视频。
- 身份 — 每段一个新的不透明
client_request_id。 - 若停在这里 — 槽表和已确认旁白仍然可用。
- 若余额不足 — 原样转达官方说明和充值链接。翻译正文，保留链接。顾问说已充值之前不要重试。
然后每段已确认音频提交一次 beatra.videos.animate。
审片、交付与恢复
核对形象、口播清晰度和口型时机。只报告宿主实际看得到、听得到的内容。不要承诺完美对口型。绝不要发明拼接、concat 或剪辑工具。每个付费任务到终态后，交付实际字节以及存在的 MIME、时长和大小，还有 billing.net_charged_credits。不要承诺预付估价就是最终扣费。
拿到 task_id 后轮询该任务。创建响应丢失时，先用 beatra.tasks.list 搜索，再用
beatra.tasks.get 核对，然后再重放。只有参数逐字节相同才能复用原标识。静帧、口播句、音色或时长变了就是新卡和新标识。只有顾问要求时才取消。
执行
每个远程 Beatra 操作都只通过本包随附的
scripts/mcp_client.py 调用。把 MCP 工具名放在 call 后面，并向标准输入发送一个 JSON 对象。
python3 scripts/mcp_client.py call beatra.models.list
{"capability": "text_to_speech"}
python3 scripts/mcp_client.py call beatra.models.list
{"capability": "image_to_video"}
printf '%s' '{"image":{"type":"artifact","artifact_id":"art-fact-01"},"driving_audio":{"type":"artifact","artifact_id":"art-speech-01"},"prompt":"A restrained product factsheet read with steady eye line and a stable camera.","duration":8,"client_request_id":"opaque-fact-video-01"}' | python3 scripts/mcp_client.py call beatra.videos.animate
不要配置或调用宿主 Beatra Connector，也不要使用 REST/OpenAPI 作为降级。
账户余额
用户问还剩多少积分，或某次实时估价够不够时，调用 beatra.wallet.get。问已经扣了多少
时，调用 beatra.wallet.ledger。两者都是只读的。不要臆造查余额或充值的工具。也不要把
wallet.get 变成每次付费提交前的必需步骤。
模型卡返回里带 top_up 块时，按卡片给出的档位和顺序原样转述。不要给档位排高低，不要
贬低其中任何一档，也不要替用户挑。选哪一档是用户自己的事，钱包页会把整份清单摆在他
面前。任何时候都不要凭记忆报档位。
按任务查阅的参考
- 槽表、载荷和恢复，读
说明书口播工作流。 - 授权和非计费注册步骤，读
安装与认证
和 安装注册。 - 共用的任务、计费和连接细节，读 任务与结果、计费、错误与恢复 和 随包 MCP Client 连接诊断。
- 更新保证和控制，读 自动更新与安全。移除时读 卸载与断开。
运行时与安全的自动更新
随包客户端会在每个安装中静默检查更新，最多每 24 小时一次。发现更高版本时，不另行确认地自动安装。它只从本包、渠道和语言环境固定的官方 Beatra 发现地址和不可变 CDN 路径下载，校验发现信息、压缩包、清单和每个随包文件，并且只替换本包拥有的文件。
更新检查、下载、校验、替换、回滚和恢复失败时会 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
