前言¶
短视频成片前，口播往往卡在「脚本已定、人声未定」：自己录要排期和设备，外包要来回改读音和节奏。若你已经在 Cursor、Claude Code 等环境里用 Agent Skill 串联文案与素材，缺的一环通常是「按脚本出一条能直接进时间线的配音轨」。下面介绍的 Skill 走文字转语音（TTS）路线，面向中文短视频脚本，输出 MP3，便于后续剪辑与发布。
这是什么¶
短视频配音（坐标 @beatra-ai/short-form-voiceover-audio）是 SkillHub 上的 enterprise 来源 Skill，分类为 design-media，当前版本 0.2.4，由发布者 beatra 提供。
一句话定位：把已定稿的短视频脚本转成自然的中文 AI 配音，交付可直接剪辑的 MP3，用于口播、旁白与解说类内容。
- SkillHub 页面：https://www.skillhub.cn/skills/beatra-ai/short-form-voiceover-audio
- 官方地址：https://api.skillhub.cn/beatra-ai/short-form-voiceover-audio
页面标注 requires_api_key=true，使用前需按 Skill 说明配置 API Key（具体字段以安装后的 SKILL.md 为准）。
核心功能¶
以下能力均来自官方简介与 SkillHub 页面描述，未单独列出的接口名或参数不在本文臆造。
- 脚本转配音：基于文字转语音，将最终短视频脚本生成中文 AI 配音。
- 交付格式：输出 MP3，便于导入剪辑软件作为配音轨。
- 读音与节奏：可先处理人名、数字、品牌等读音；通过自然断句调整语速与停顿。
- 音色与语言：选择支持目标语言的音色；生成前可查看当前费用估算。
- 成片前复查：音频返回后，按实际时长与听感复查，再用于剪辑或下游流程。
官方列出的下游用途包括：视频配音、字幕、数字人口播、口型同步、广告剪辑与内容发布。
安装与启用¶
SkillHub 推荐让 Agent 按安装文档拉取该 Skill，或在已安装 skillhub CLI 时指定安装目录。
1、确认 CLI（可选）¶
若本机尚未安装 SkillHub CLI，可先检查版本：
command -v skillhub && skillhub --version
未安装时，可按 SkillHub 安装文档 执行官方安装脚本（完整安装或 --cli-only 仅装 CLI）。
2、安装本 Skill¶
安装时必须用 --dir 指向当前 Agent 实际读取的 skills 目录，否则默认落在 ./skills/ 可能不会被识别。
skillhub install @beatra-ai/short-form-voiceover-audio --dir <skills 目录>
常见客户端 skills 路径（摘自 SkillHub 安装文档，按你当前环境选用其一）：
- Cursor：
~/.cursor/skills/ - Claude Code：
~/.claude/skills/ - Codex：
~/.codex/skills/或项目下的.agents/skills/
也可在 SkillHub 技能页，将提示词发给 AI，要求其根据 https://skillhub.cn/install/skillhub.md 安装 @beatra-ai/short-form-voiceover-audio。
3、API Key¶
标签标明需要 API Key。安装完成后在 Agent 中启用该 Skill，并按 SKILL.md 配置密钥与调用方式；本文无法在未安装包的情况下核对具体环境变量名或配置文件路径。
典型用法¶
官方工作流可概括为「先文本、再音频、再剪辑」，适合在 Agent 对话里用自然语言驱动，步骤如下。
- 准备定稿脚本：口播稿、商品介绍、解说词或广告旁白等最终文本，避免边生成边大改结构。
- 读音与断句：说明人名、数字、品牌希望怎么读；在脚本里用标点或换行标出停顿，控制语速节奏。
- 选音色并确认费用：指定目标语言对应的音色，在生成前查看当前费用估算。
- 生成并复查：拿到 MP3 后听一遍，核对时长是否与画面规划一致，再导入剪辑或字幕、数字人等环节。
适用平台类型在简介中写明：TikTok、Reels、YouTube Shorts 等场景的中文口播、商品介绍、解说、开场钩子与广告旁白。
适用场景与注意¶
适合谁
- 需要快速出中文口播轨的短视频作者、运营与剪辑同学。
- 已在用 Agent 写脚本、拆镜头，希望少一步人工录音或外包沟通的团队。
使用注意
- enterprise 来源：与企业侧 Skill 分发策略相关，安装与更新以 SkillHub 页面与 CLI 为准。
- 计费：生成前查看费用估算；实际扣费以 Skill 背后服务为准。
- 听感与合规：AI 配音需自行复查读音、敏感词与平台规范；数字人口播、口型同步等还需与画面素材匹配。
- 统计信息：SkillHub 页面展示评分与下载量会变动；撰写时页面为评分 100000、下载 16492（以你打开页面时的数据为准）。
结尾¶
短视频配音把「定稿脚本 → MP3 配音轨」收进一条 Agent Skill 流程：读音、断句、音色与费用在生成前可配置，生成后按听感复查即可进剪辑。需要安装或更新时，以上述 SkillHub 页面与 @beatra-ai/short-form-voiceover-audio 为准。
官方地址：https://api.skillhub.cn/beatra-ai/short-form-voiceover-audio
