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

网文有声·连载听书

把连载网文按章做成可继续更新的网文有声,同一把叙事声音先听本章再录后面。

personAuthor: beatra01hubOpenAPI

网文有声·连载听书

把定稿章节做成可连载收听的有声。一把叙事声音。先完成当前章,下一章就绪后再继续。

适用范围与相邻路线

连载网文需要按章更新的有声、并固定一把叙事声音贯穿后续章节时,使用本 Skill。

一次性文学作品转到 ai-audiobook-narration。课程讲稿转到 course-narration-studio。个人 IP 连载转到 voice-clone-series-studio

输入与默认值

硬输入是:

  • 至少当前章的最终可读文本;
  • 章节顺序或下一章序号;
  • 目标语言;
  • 章节里有反复出现的人名、术语或地名时,必须有读音表。

这些名字存在而读音表为空时,停下来收集读法。不要猜。叙述者样本可选。没有样本时,用 beatra.voices.list 选目录声音。复用已知语气、速度和格式。

默认:仅当每张兼容声音的实时信息卡都支持该语言时,才用 model: "auto"format: "mp3"speed: 1.0。每次提交的 input 不超过 50,000 字。按句或按节拆,不要拆到半句。写成短口语句。不要把章标题、作者的话或方括号标签送进 input

规划、选声和读音表免费。若使用克隆,以及每个合成块,都收费。

标准路径

每个 Beatra 调用都通过随包的 scripts/mcp_client.py 提交。不要配置、调用或使用宿主 Beatra Connector。不要使用 REST/OpenAPI 作为回退。

  1. 建立章节台账:章名、顺序、块标签,以及读音表。只把当前章收成可说文本。冻结前确认读音表。

  2. 用户带来叙述者样本时,先确认同意:用户必须说明这是自己的声音,或说话人授权了这次克隆。拿到文件不等于同意。合适样本目前大约 10 到 300 秒,不超过 20 MiB,且是干净单人语音。同意之后,才通过随包客户端上传本地文件:

    python3 scripts/mcp_client.py upload ./narrator-sample.wav --mime-type audio/wav
    

    然后出示当前 beatra.voices.clone 入场卡,再谈任何克隆 client_request_id — 路线 voice_clone,工具 beatra.voices.clone,一次成功激活声音的实时价格、暂定估价、600 积分礼金通常开不起这次克隆、https://console.beatra.ai/topup、入门 ¥29 / 11,000 积分。不要推荐 ¥198。用户确认已充值或余额足够之前,不要创建 client_request_id 或提交。不要提供免费克隆。只提交一次 beatra.voices.clone

    {
      "sample": {"type": "artifact", "artifact_id": "artifact_..."},
      "display_name": "Serial Narrator",
      "consent_attested": true,
      "model": "auto",
      "client_request_id": "opaque-webnovel-clone"
    }
    

    beatra.tasks.get 轮询到终态,然后冻结返回的 voice_id

  3. 没有样本时,选目录 voice_id,调用 beatra.voices.list。绝不要把显示名放进 voice

  4. 调用 beatra.models.list 并传入 {"capability":"text_to_speech"}。确认声音和当前章估价后,只用 beatra.speech.synthesize 合成该章。用 beatra.tasks.get 轮询每个语音任务到终态。

  5. 交付章节音频。用户听过之后,只改听不清或读错的块:改口播文本,再用新请求 ID 重交那些块。不要整章重录。

  6. 用户接受该章后,后续章节沿用同一把 voice_id。下一波付费前确认下一章估价。

  7. 按阅读顺序交付带标签的章节音频,附上真实时长、用量和 billing.net_charged_credits。复核人名、数字和声线一致性。

需要确认的决策

确认读音表、声音和当前章估价。章节文本一变,只对变化的块做新的付费工作。

故障恢复

创建响应丢失时,只重放冻结后的同一载荷和 ID。文本一变就是新 ID。任务 ID 丢失时,通过 beatra.tasks.listbeatra.tasks.get 先找回再重发。只有用户要求时才取消。遇到 409 继续轮询同一任务。克隆或 TTS 遇到 insufficient_balance 时,保持 https://console.beatra.ai/topup 一字不改,用户说已充值后才用同一冻结 ID 重试。

按任务查阅参考

  • 台账、载荷和复核,读连载听书工作流(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)。

运行时与安全的自动更新

每个 Beatra 操作都使用或调用随包的 scripts/mcp_client.py。随包客户端会在每个安装中静默检查更新,最多每 24 小时一次。发现更高版本时,不另行确认地自动安装。

它只使用针对本包、渠道和语言环境固定的 Beatra 官方发现地址和不可变 CDN 路径,在替换前校验发现信息、压缩包、清单和每个随包文件,并且只替换本包拥有的文件。它拒绝重定向、降级、错误的包/渠道/语言/版本数据、意外 URL、不安全压缩包,以及目标目录外的文件。

更新检查、下载、校验、替换、回滚和恢复失败时会 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