Speaches 本地语音 API
将以下提示词粘贴到你的 AI 对话框中:
请根据 https://skillhub.cn/install/skillhub.md,安装 @user_3c6cb52e/self-host-an-openai-compatible-speech-api-for-local-transcription-translation-and-tts-with-speaches。
技能介绍
要解决的具体问题
当你的 Agent 技术栈依赖 OpenAI 风格的音频接口(如 /audio/transcriptions、/audio/translations、/audio/speech)时,若语音数据需留在本地、不经过第三方托管服务,又不想修改现有客户端的请求逻辑,本地化兼容接口会成为更可控的选择。
核心能力与工作原理
- 兼容现有技术栈:技能基于 Speaches 构建后端,直接暴露与 OpenAI 匹配的音频端点,现有客户端无需调整请求结构即可调用本地服务。
- 覆盖三类核心任务:支持本地语音转录(将音频转为文本)、语音翻译(直接翻译音频内容)、文本转语音(TTS,将文本生成音频),满足 Agent 中语音处理的基础需求。
- 部署依赖明确:需要 Docker 或 Python 部署环境、CPU/GPU 运行时、已适配的语音模型,以及可调用 OpenAI 兼容接口的客户端或 Agent 栈。
适用边界与注意点
- 仅聚焦「本地化兼容接口」,不替代 OpenAI 官方 API 的所有功能,需根据实际任务验证接口兼容性。
- 安装步骤、模型适配细节需参考上游 Speaches 文档,技能未额外封装部署脚本或配置模板。
- 实时语音 API(Realtime API)的具体用法需以上游文档为准,避免直接套用 OpenAI 实时接口逻辑。
使用场景
- 自托管语音服务用于本地转录,替代OpenAI托管API,确保音频数据不离开本地
- 为Agent技术栈部署兼容OpenAI的本地后端,支持语音翻译和TTS,无需修改客户端
- 在无外网环境构建本地语音处理服务,实现转录、翻译、TTS全流程本地化
- 将现有依赖OpenAI音频端点的应用迁移到本地Speaches后端,保持接口不变
适合人员
- Agent开发者,需要为项目集成本地化语音后端,同时兼容OpenAI风格接口
- 私有化部署工程师,负责为内部系统搭建本地语音服务,确保数据不出网
- 数据合规人员,需将语音处理流程本地化,避免使用第三方托管API
- 开源项目维护者,需为工具添加自托管语音功能,支持转录翻译和TTS