声音克隆 文本转语音narrator-ai-cli-skill 独立任务实战AI 解说大师配音两大技能【免费下载链接】narrator-ai-cli-skillAI 解说大师 — Agent skill封装 narrator-ai-cli 供 Claude/Codex 等工具调用项目地址: https://gitcode.com/gh_mirrors/na/narrator-ai-cli-skill如果你只需要「给文字配上 AI 解说旁白」而不需要合成整条视频那么narrator-ai-cli-skillAI 解说大师提供的两个独立任务——声音克隆与文本转语音TTS正好是最低门槛的切入点。装上这个 Agent 技能后你只需用自然语言对 Claude、Codex 等 AI 工具说一句话它就会调用 narrator-ai-cli 自动完成克隆音色、生成配音的全流程无需手动研究参数。本文带你零基础上手这两大配音技能从克隆自己的声音到让 AI 用这个声音朗读任意文案。 独立任务是什么配音能力单独可用narrator-ai-cli-skill 是一套 AI Agent 技能文件它教会 AI 工具如何操作 narrator-ai-cli 命令行。除了「搜片 → 选模板 → 生成文案 → 合成视频」的完整流水线外它还内置了可单独运行的配音任务也就是技能文档 SKILL.md 中 Standalone Tasks 一节描述的两大能力技能作用输入输出声音克隆voice-clone从一段录音中提取音色音频文件file_id专属音色voice_id文本转语音tts用指定音色朗读文本voice_id 文案文字配音音频文件两者关系很简单克隆是「造声音」TTS 是「用声音」。你既可以用克隆出的声音配音也可以直接使用内置的 63 个多语种配音角色通过dubbing list查看详见 references/resources.md。 开始前的两步准备在使用独立任务前只需确认环境就绪全程 2 分钟安装 CLI 并配置 API Key通过 pip 安装narrator-ai-cli再执行narrator-ai-cli config set app_key 你的API_Key详细步骤见 README_CN.md 的「快速安装」章节。验证配置运行narrator-ai-cli user balance能返回账户积分余额说明环境配置成功。 安装 Agent 技能将本仓库 clone 到你所用 Agent 的技能目录即可SKILL.md与references/目录缺一不可升级时在目录内执行git pull。️ 实战第一步声音克隆让 AI 学会你的声音声音克隆只需要一条命令。前提是把一段录音支持.mp3、.m4a、.wav等格式上传到你的账户文件列表# 1. 上传录音得到 file_id narrator-ai-cli file upload ./我的声音.mp3 --json # 2. 用 file_id 创建克隆任务 narrator-ai-cli task create voice-clone --json -d {audio_file_id: file_id}任务创建成功后会返回一个task_id拿着它查询即可等到结果。克隆完成后响应中会包含你的专属音色voice_id——这就是下一步 TTS 的钥匙。克隆效果小建议录音选择安静环境、语速均匀、10 秒以上的清晰片段效果更稳两个任务都支持可选参数clone_model默认为pro档追求更高还原度时显式指定即可 实战第二步文本转语音一句话变配音拿到voice_id后文本转语音同样只需一条命令输入音色 ID 和要朗读的文字narrator-ai-cli task create tts --json \ -d {voice_id: voice_id, audio_text: 大家好欢迎收看本期电影解说。}任务完成后响应里的files[0].file_id就是生成的配音音频用file download即可下载到本地。这一步对应的完整参数说明可在 SKILL.md 的 Standalone Tasks 小节和 references/operations.md 中随时查阅。⏳ 任务轮询如何知道任务做完了所有任务都是异步执行的统一用同一个模式查询这也是 Agent 自动执行的核心规则narrator-ai-cli task query task_id --json关注顶层.status字段2表示成功3表示失败。技能文档要求 AI 以 5 秒为间隔持续轮询直到出结果为止。拿到结果后声音克隆 → 记录voice_id文本转语音 → 读取.files[0].file_id准备下载音频完整响应结构哪些字段是task_order_num、哪些是file_id在 references/operations.md 的 Task Query Response Shape 一节有逐字段说明这也是排错时最值得看的一张表。 组合玩法克隆 TTS 视频流水线两大独立技能的真正威力在于它们能与完整视频流水线无缝衔接给解说视频换上「自己的声音」先做声音克隆拿到voice_id再在生成解说视频的fast-clip-data/clip-data步骤中把dubbing参数指定为该voice_id即可让整条电影解说视频用你的音色旁白流程详见 references/workflows.md。批量生成口播音频同一voice_id可反复用于 TTS 任务一次克隆无限配音适合做系列短视频的固定「主播」。❓ 常见问题与排错新手最容易踩的三个坑现象原因处理任务一直查不到结果轮询看错了字段只看顶层.status别看嵌套的results.tasks[0].status编码体系不同报错10004/10005API Key 或签名配置问题运行config show检查必要时联系支持报错10009积分余额不足充值后重试全部 18 个错误码及对应处理方式收录在 references/operations.md 的 Error Codes 表格中遇到未知报错直接对照即可。 延伸阅读技能文档导航想了解去哪里看技能总览、流水线图、强制规则SKILL.md安装步骤、支持平台、能力清单README_CN.md素材 / BGM / 配音角色列表命令references/resources.md两条工作流完整参数与示例references/workflows.md轮询模式、文件操作、错误码references/operations.md视觉模板magic-video用法references/magic-video.md从一段录音到专属音色从一句文字到成品配音——声音克隆 文本转语音这两个独立任务就是 AI 解说大师配音能力的最小可用单元。装上 narrator-ai-cli-skill把配音这件事交给 AI你只负责说需求。【免费下载链接】narrator-ai-cli-skillAI 解说大师 — Agent skill封装 narrator-ai-cli 供 Claude/Codex 等工具调用项目地址: https://gitcode.com/gh_mirrors/na/narrator-ai-cli-skill创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考