返回 Skill 列表
extension
分类: 内容与媒体无需 API Key

广播剧贴片口播·广播剧贴片口播

按已经写好的贴片词,做成每条剧前或剧后贴片一条口播。

person作者: beatra01hubOpenAPI

广播剧贴片口播·广播剧贴片口播

按已经写好的贴片词,做成每条带标签口播一条语音。 交付 8 到 20 条。先覆盖剧前和剧后。

适用范围与相邻路线

制作方需要按已经写好的贴片词做带标签口播时,使用本 Skill。

整集多角色对白转到 audio-drama-voice-studio。通用讲述转到 voiceover-narration-studio。从样本做可复用声音转到 voice-cloning-studio

只读已经提供的贴片词。不要补清单上没有的赞助商、价格、集名或读音。

收集贴片词

硬输入是:

  • 制作方已经写好的剧前、剧后和其他贴片词;
  • 出现人名或品牌词时的读音表;
  • 这包要几条,或允许使用默认 10 条;
  • 克隆声音会出现时的形象和声音权利。

复用已知语言,以及冻结的 voice_id。只补问缺失的硬输入。8 到 20 以外的数量也能做:确认该规模和实时费用。

不要编造赞助句、价格或读音。拿到文件不等于同意。

名字存在而读音表为空时,停下来收集读法。

先做免费槽表

任何付费克隆或旁白前,先写带标签的贴片口播清单。卖家没有另报 8 到 20 之间的数量时,默认十个槽位:剧前赞助、剧前声明、中插提示、台号、年龄提示、剧后致谢、下期预告、周边提及、收听提醒和收尾提示。每个槽位记下由已写贴片词写出的口播句,以及用目录音色还是克隆。

这份清单就是免费可见结果。规划不是批准。

安全默认:

  • 每个槽位一次 beatra.speech.synthesize
  • 仅当每张实时旁白卡都支持该语言时,才用 model: "auto"
  • format: "mp3"speed: 1.0
  • 整包一把品牌声音。

每次提交的 input 不超过 50,000 字。按句拆。按清单写成短口语句。

卖家要克隆时,先查看其可授权样本。本地文件检查后,只通过随包客户端上传 (scripts/mcp_client.py / beatra.assets.upload)。保留返回的产物编号。绝不要把本地路径传给 beatra.voices.clonebeatra.speech.synthesize

确认克隆,再确认旁白

克隆和旁白是分开的付费阶段。每个阶段各自一张六字段卡,各自一个不透明 client_request_id

卖家要克隆音色时,先查看其可授权样本,读取当前的 voice_clone 卡片,并在 beatra.voices.clone 之前等在克隆卡上。找到的文件不是克隆同意。出示克隆卡并等待:

  1. 做什么 — 一份可授权声音样本(beatra.voices.clone)。
  2. 积分 — 刚读到的 voice_clone 价格。不要复用记忆中的数字。
  3. 几笔 — 这份样本一次付费克隆。
  4. 身份 — 一个新的不透明 client_request_id
  5. 若停在这里 — 带标签的槽表仍然可用。
  6. 若余额不足 — 原样转达官方说明和充值链接 (https://console.beatra.ai/wallet?intent=buy)。翻译正文,保留链接。卖家说已充值之前不要重试。不要推荐 ¥198。

旁白前,调用 beatra.models.list,能力为 text_to_speech

{"capability": "text_to_speech"}

目录音色还没定时再用 beatra.voices.list。绝不要把显示名放进 voice。出示旁白卡并等待:

  1. 做什么 — 每个点名槽位一条贴片口播 (beatra.speech.synthesize)。
  2. 积分 — 刚读到的 text_to_speech 价格乘以槽位数。不要复用记忆中的数字。
  3. 几笔 — 每个槽位一次付费旁白。
  4. 身份 — 每个槽位一个新的不透明 client_request_id
  5. 若停在这里 — 带标签的槽表仍然可用。
  6. 若余额不足 — 原样转达官方说明和充值链接 (https://console.beatra.ai/wallet?intent=buy)。翻译正文,保留链接。卖家说已充值之前不要重试。不要推荐 ¥198。

每个旁白槽位只通过随包 scripts/mcp_client.py 提交一次。用 beatra.tasks.get 轮询。读取实际音频 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"}
printf '%s' '{"input":"<the written line for this slot>","voice":"voice_...","format":"mp3","client_request_id":"opaque-radio-speech-01"}' | python3 scripts/mcp_client.py call beatra.speech.synthesize

不要配置或调用宿主 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