
vits-simple-api
一键部署 VITS 语音合成 API,快速集成 TTS 到你的应用
项目预览
项目数据
项目介绍
Star 增长趋势
本站每日记录该项目 GitHub 星标变化,观测越久曲线越完整
数据来源:GitHub API 逐日快照 · 收录于 2026-08-09 · 当前星标 ★ 1046
使用教程
ℹ 本教程由 AI 依据该项目 README 整理,个别步骤可能需要按你的环境微调。
环境要求
- Linux 系统(Docker 部署为官方推荐)
- 已安装 Docker 与 wget 命令
- 虚拟环境部署需 Python 3.10(官方推荐版本)
- GPU 加速需 NVIDIA 显卡及对应版本 CUDA,如 CUDA 11.7
- 预留足够磁盘空间存放 VITS/Bert-VITS2/GPT-SoVITS 模型文件
安装与启动步骤
-
1选择部署方式
README 提供 Docker、虚拟环境、Windows 快速包、云端一键部署四种方式;Linux 推荐 Docker。无论选哪种,部署后都要导入模型才能使用。
-
2Docker 拉取镜像
运行官方安装脚本,按脚本提示选择需要下载的文件并拉取镜像。配置文件与模型默认目录为 /usr/local/vits-simple-api/。
bash -c "$(wget -O- https://raw.githubusercontent.com/Artrajz/vits-simple-api/main/vits-simple-api-installer-latest.sh)" -
3装 Python 依赖
虚拟环境部署方式:建议使用 Python 3.10 的虚拟环境,在项目目录安装 requirements.txt 中的依赖;若个别依赖安装失败请看常见问题。
pip install -r requirements.txt -
4Windows 快速包
到 releases 页面下载最新部署包并解压。因压缩与单文件 2GB 限制,部分可选依赖模型未打包,程序加载对应声音模型时会自动下载。
-
5检查 CUDA 版本
需要 GPU 加速时,先用 nvidia-smi 查看显卡支持的最高 CUDA 版本,再据此到官网下载安装对应 CUDA(示例为 CUDA 11.7)。
nvidia-smi -
6安装 PyTorch
按显卡 CUDA 版本从 PyTorch 官网选择对应安装命令,README 给出的是 CUDA 11.8 版本示例。
pip install torch --index-url https://download.pytorch.org/whl/cu118 -
7导入模型文件
部署完成后必须把 VITS/Bert-VITS2/GPT-SoVITS 等模型导入到模型目录,服务才能实际提供语音合成,模型会按类型加载对应依赖。
-
8配置模型语言
使用 Bert-VITS2 v2.0 以上模型时,可在模型 config.json 的 data 段加 lang 参数,指定要加载的语言 Bert 模型,减少无谓加载。
关键配置
| 配置项 | 必填 | 说明 | 示例 |
|---|---|---|---|
data.lang | 否 | 写在模型 config.json 的 data 段,限定该模型使用的语言与要加载的 Bert 模型 | ["zh", "ja"] |
如何确认成功
README 未给出明确启动命令与端口;部署后导入模型,可访问 /voice/speakers 查看已加载说话人列表,能返回音频即服务正常。
常见问题
Q:安装 Python 依赖时报错怎么办?
A:README 提示参考其罗列的常见问题(common problems)章节,通常是 Python 版本或个别包编译问题,建议改用 Python 3.10 虚拟环境重试。
Q:部署后可用模型列表是空的?
A:说明模型未正确加载或依赖模型缺失。请按 README 的 Troubleshooting - Successfully loaded model is empty 章节排查,必要时手动下载依赖模型。
Q:Windows 部署包怎么没有全部模型?
A:因压缩需要及 GitHub 单文件 2GB 限制,部分可选依赖模型未打包,程序加载对应声音模型时会自动下载。
Q:加载 Bert-VITS2 模型太占资源怎么办?
A:在模型 config.json 的 data 段加 lang 参数,例如只写 ["zh"] 就只加载中文 Bert 模型,避免加载用不到的语言模型。
注意事项
- Docker 方式下项目配置与模型默认路径为 /usr/local/vits-simple-api/
- 部署只是第一步,必须导入模型后才能使用语音合成功能
- 只有 Bert-VITS2 v2.0 及以上模型才需要配置 data.lang 语言范围
- 在线体验地址的 id 编号与支持语言各不相同,本地部署请以自己的说话人列表为准
核心亮点
- 统一封装多种 VITS 模型(bert-vits2、gpt-sovits 等),无需重复开发接口
- 提供简洁的 RESTful API,支持流式音频返回,易于对接 Web 和移动端
- 支持多说话人切换和参数调节,灵活适配不同音色和语速需求
不足之处
- 文档/社区待观察
- 依赖模型文件较大,首次部署需要额外下载和配置
适用场景
- 为聊天机器人或虚拟助手添加语音回复功能
- 批量生成有声书或播客内容
- 在游戏或互动应用中实现角色语音合成
替代项目
Coqui TTS、MeloTTS、ChatTTS
上一篇:pied
下一篇:CapCut-TTS
同类项目推荐
youtube-auto-dub
开源
一键将 YouTube 视频自动翻译并配音成多语言,保留原声背景音乐。
AI-powered YouTube video dubbing pipeline. Automatically transcribes (Whisper), tran···
Awesome-Singing-Voice-Synthesis-···
开源
一站式导航歌声合成与转换前沿资源
A paper and project list about the cutting edge Speech Synthesis, Text-to-Speech (TT···
TTS-recipes
开源
一键跑通多种数据集的 TTS 训练配方,快速上手语音合成。
TTS recipes for different datasets
ComfyUI-Step_Audio_EditX_TTS
开源
在 ComfyUI 里拖拽节点,几秒克隆声音并编辑音频
ComfyUI nodes for Step Audio EditX - State-of-the-art zero-shot voice cloning and au···
Dicy2
开源
在 Max 里用机器学习生成音乐序列,实现交互式创作
"Dicy2 for Max" is a Max package implementing interactive agents using machine-learn···
VoicEra
开源
开源语音AI模块,接上电话就能让LLM打电话对话
A complete voice AI building block with telephony integration, featuring real-time s···
earshot
开源
给AI装上耳朵,边写代码边审声音
Ears for coding agents: let AI hear, review and make sound. CPU-only, open source.
VAENAR-TTS
开源
用VAE+非自回归框架,让语音合成更快更稳
PyTorch Implementation of VAENAR-TTS: Variational Auto-Encoder based Non-AutoRegress···
FlexiCodec
开源
低帧率下也能保真,让音频编解码更灵活高效
[ICLR2026] FlexiCodec: A Dynamic Neural Audio Codec for Low Frame Rates