Agent Skill

课程配音工作室

课程配音工作室把课件整理成可朗读的讲稿,为每个章节录制老师声音的 AI课程配音和课程旁白,交付可直接配幻灯片的网课配音、课程音频、培训旁白和知识付费音频。

教育学习·beatra·来自 skill_hub·skillhub.cn ↗
skillhub install @beatra-ai/course-narration-studio
8 Stars·18.4万 综合热度·5,633 字文档·源站更新 2026-11-22

README 文档

5,633 字

课程配音工作室(Course Narration Studio)

将定稿讲义文本打磨为音量一致、章节顺序井然的课程配音交付包。一套课程是按教学日程分批推进的课时序列,而不是一大段有声书录音。先做好并验收一节口播样课,再用同一个已锁定老师音色稳定扩展整门课程。

适用范围与相邻路线

当系列课程、企业内训或知识付费专栏需要用统一稳定的老师声线贯通多个课时时,选用本工作室。样课测试区与其余正式章节分开建账;发起付费合成前,先把PPT标题、讲台动作批注和配图备注清理为顺口讲稿(切勿手工删改 / 停顿标记或生造方括号声效标签),待用户认可样课效果后按同一规范扩产全包。

文学图书或长篇小说手稿路由至 ai-audiobook-narration;多集连载克隆声线播客节目路由至 voice-clone-series-studio;真人出镜口播课程视频路由至 course-video-studio;单条短视频或独立旁白路由至 short-form-voiceover-audio 或 voiceover-narration-studio;音色永久删除(voices.delete)路由至 voice-cloning-studio;多人对白、语音转写、音效或人声伴奏分离路由至 beatra-ai-voice-studio(以 scripts/mcp_client.py tools 返回为准)。

如果老师希望把 PPT 课件直接按页出音并嵌入 PowerPoint 或 WPS,可指向「课件逐页配音(slide-narration-studio)」;若需基于幻灯片合成全套讲课视频,可指向「讲义视频工坊(lecture-video-maker)」。引介其他 Skill 时须采用课程配音工作流(references/workflow.md#pointing-to-another-skill)中的固定话术,且仅在用户主动提出后才安装。面向最终定稿讲义的分章节纯配音工作留在本工作室完成。

输入前提与默认规则

必须集齐以下硬性输入:

  • 至少首节样课的最终可读文本(或先明确委托整理/智能语音导演润色出可朗读口播稿);
  • 清晰排列的章节教学顺序;
  • 目标语种(仅当用户明确指定时才带入;除非用户要求改动,原样保持原有简繁体用字与方言措辞);
  • 只要课程中存在反复出现的专有名词、英文术语或缩写,就必须先补全读音表。

若存在高频术语而读音表尚空,立即暂停补问,绝不自行猜读。是否提供老师人声样本为可选项;无样本时通过 beatra.voices.list 的 11 维条件筛选音色库中现成声线,并通过 preview_url 或 beatra.voices.preview 免费试听定音。

默认参数保持:model: "auto" 仅在音色兼容的每一条在线模型卡片都支持规范化 BCP-47 目标语种(nb -> no、tl -> fil)时启用;其余采用 format: "mp3"、speed: 1.0、volume: 1.0、pitch: 0。如果 beatra.speech.validate 或合成因文本过长而拒绝,按拒绝信息操作:在自然的课时、小节或句子边界拆分,并按顺序提交各段。切勿臆造「每分钟多少字(WPM)」控制参数;需要讲授停顿与语调层次指导时,可选用智能语音导演(beatra.speech.prepare_script)。

策划整理、挑选试听、beatra.speech.validate、beatra.voices.update 与术语读音表全部免费。智能语音导演(preparescript)、噪声样本预处理(isolatevoice)、voices.clone、speech.synthesize 与 normalize_loudness 均属付费操作,切勿把付费步骤宣称为免费。

标准制作路径

请通过随包 scripts/mcp_client.py 提交每一项 Beatra 调用。不要配置、调用或使用宿主 Beatra Connector,也不要使用 REST/OpenAPI 作为降级回退。

  1. 建立课时台账:整理各讲标题、排序、每小节核心讲解点与术语读音表。发起任何付费朗读前先行运行免费 beatra.speech.validate(获取 estimateddurationseconds);若需进一步调优停顿与表现力,先查 {"capability": "speechscript"} 并经六要素卡批准后调用智能语音导演(beatra.speech.preparescript),妥善处理 synthesis: null(依据 warnings 修正),并谨记 48 小时内保持原文本/指令/语种/上下文不变、仅替换 voice 或 model 重编译虽可免二次计费,仍须满足余额覆盖首次预估且并发不超过 2 个。
  2. 授权克隆老师音色(如提供样本):任何本地上传之前都必须取得明确人声授权确认(确认声音属于老师本人或已获说话人授权,手里有音频文件不代表获得克隆授权)。若样本混杂环境噪声,先提供付费人声预分离方案:beatra.audio.process(operation: "isolatevoice",使用 source 字段,限制 4.6 秒至 5 分钟、<= 100 MB,按 {"capability": "audiovoice_isolation"} 报价)。随后上传样本:
   python3 scripts/mcp_client.py upload ./narrator-sample.wav --mime-type audio/wav

按语音与音频指南(references/speech-and-audio.md) §5 选择克隆模型,展示六要素制作确认卡(包含路线与模型、精确范围、实时单价与计费基准、时长/数量、付费方式与调用次数,以及「此刻中止可零成本留存的免费成果」——绝不写死固定积分或反问用户是否余额充足)并带上克隆实时价格,卡上只写克隆对课程的作用,不写模型 ID 或供应商名,待明确同意后单次提交,如遇拒绝则按计费、错误与恢复(references/billing-errors-and-recovery.md)处理:

   {
     "sample": {"type": "artifact", "artifact_id": "artifact_..."},
     "display_name": "Course Teacher",
     "consent_attested": true,
     "model": "auto",
     "client_request_id": "opaque-course-clone"
   }

通过 beatra.tasks.get 轮询至终态。当克隆结果或音色列表中的音色状态为 pendingactivation 时,使用该音色前须按语音与音频指南(references/speech-and-audio.md) §5 的步骤 E 执行。随后可调用不计费的 beatra.voices.update(makedefault: true、use_case)为该课程长期固定好默认音色与标签。

  1. 无样本则库内选声:使用 beatra.voices.list 的 11 维筛选条件(category、language、gender、agegroup、usecase、emotion、supportscontext、supportsdirection、supportsperformancetags、supportsdialogue、supportsspeechtospeech)挑出合适声线,并以 beatra.voices.preview({"voice_id": "..."})免费试听。传入 voice 时只能填精确 ID,绝不能直接填展示名称。
  2. 合成单节样课:调用 beatra.models.list(传入 {"capability": "texttospeech"})获取实时卡片,并用免费 beatra.speech.validate 完成预检后,选取术语数字最密集的一讲作为样课出示六要素确认卡;获批后通过 beatra.speech.synthesize 仅合成该样课(需要学习字幕对轨时设 subtitle_enable: true 免费获取 SRT / VTT 字幕,切勿传 subtitles 字段),再通过 beatra.tasks.get 轮询结果。
  3. 听感验收与局部修补:交付样课并对照术语读音表试听验收;若仅个别段落读错或不够清晰,只为修改块出新卡、换用新的 clientrequestid 重跑局部,绝不整讲全盘重做。
  4. 整门扩产与响度统一:样课验收通过后,批准其余章节制作卡并按单块唯一 clientrequestid 逐一完成合成。如需保持整门课程各讲音量一致,可在另行出卡获批后串行调用付费 beatra.audio.process(operation: "normalizeloudness",输入使用 source 字段,如 -14 LUFS,限 <= 60 min / <= 300 MB / 输出 >= 1 s、每日 50 次,按 {"capability": "audioprocess"} 实时卡片报价)逐课处理——切勿将收尾步骤说成免费或专业母带处理服务。
  5. 按教学顺序交付全包:交付逐课编号命名好的音频、可选同步字幕、实际用量及 billing.netchargedcredits。

必须征得明确确认的节点

以下动作每次变更都须取得明确批准:术语读音表、六要素克隆卡(且样本上传前必过明示授权)、可选 isolatevoice / preparescript 卡片、样课卡、剩余全课卡以及可选 normalizeloudness 响度收尾卡。正文改动、音色调整、语速声调或目标响度变更,仅对受影响切片以新的 clientrequest_id 生成新付费任务。

异常恢复机制

若任务创建提交结果不明,只允许使用完全一致的参数字段和同一 clientrequestid 重放——且须先遍历 beatra.tasks.list(含 nextcursor 分页)并配合 beatra.tasks.get 核查确认尚未落库,绝不自动重试。仅按用户明确指示取消任务。遇 insufficientbalance 时,原样转述 Beatra 官方信息与精确 topup_url,等用户确认充值完成后再用原先冻结参数重放请求。若拒绝信息还指明了其他可行的处理方式,一并向用户说明,并按计费、错误与恢复(references/billing-errors-and-recovery.md)处理。

账户余额与充值指引

绝不把 beatra.wallet.get 设为付费提交前置关卡,也不反问用户积分是否够用。仅在用户主动问起余额或额度匹配度时调用只读 beatra.wallet.get,询问扣费流水时调用 beatra.wallet.ledger。模型卡片包含 top_up 推荐档位时,严格按返回顺序原样列出,绝不排序或替用户指定档位。

按任务查阅参考文档

  • 跨工具上限、声音克隆、智能语音导演与六要素确认卡:语音与音频指南(references/speech-and-audio.md)
  • 课程台账、样课试跑、isolatevoice、preparescript、validate、synthesize 与 normalize_loudness 请求体及跨 Skill 引介写法:课程配音工作流(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/updates-and-security.md)
  • 用户要求卸载及停用本包时:卸载与断开连接(references/uninstall-and-disconnect.md)

每一项 Beatra 操作都统一通过随包 scripts/mcp_client.py 触发与执行。

更新与安全

本 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)。

同分类其他技能

查看全部 ›