ChatTTS-ui本地语音合成实战3条部署路线、一张参数表、一个API【免费下载链接】ChatTTS-ui一个简单的本地网页界面使用ChatTTS将文字合成为语音同时支持对外提供API接口。A simple native web interface that uses ChatTTS to synthesize text into speech, along with support for external API interfaces.项目地址: https://gitcode.com/GitHub_Trending/ch/ChatTTS-uiChatTTS-ui是一个基于ChatTTS模型的本地语音合成工具在浏览器里运行支持中英文数字混杂文本提供多种预设音色并对外暴露标准HTTP接口可直接接入你的应用。为什么值得本地部署云端语音合成接口按字符计费高频使用成本不低文本还要全部上传到公网涉及隐私的内容尤不放心。ChatTTS-ui把完整模型跑在自己设备上首次下载模型后后续合成不依赖外网。生成的音频保存在本地服务可开放给局域网共用。界面和API同属一个项目不写代码的人点点按钮开发的同事直接发请求。项目概览与硬件要求后端是一个Flask应用直接运行 app.py 就能同时得到网页界面和/tts接口不需要额外配置CPU任何装有 Python 3.9–3.11 的机器即可运行不支持 3.12GPUNVIDIA 显卡需 CUDA 12.8 且显存 4G 以上低于 4G 自动退回 CPU模型首次启动自动从 ModelScope 或 Hugging Face 下载之后缓存本地端口默认 9966可在 .env 文件中修改部署路径选择按你的环境对号入座人设方案适用场景跑通步骤Windows 新手预打包 exe个人电脑、零代码3 步服务器运维Docker 容器Linux 服务器、团队共用3 条命令开发者源码安装需要自定义或二次开发6 条命令Windows 预打包版从 Releases 页下载压缩包并解压双击 app.exe。首次运行会下载模型完成后浏览器自动打开 http://127.0.0.1:9966。个别安全软件会误报遇到就改用源码部署。Docker 容器部署命令git clone https://gitcode.com/GitHub_Trending/ch/ChatTTS-ui chat-tts-ui cd chat-tts-ui docker compose -f docker-compose.cpu.yaml up -d # GPU 版换成 docker-compose.gpu.yaml docker compose logs -f日志出现启动信息后浏览器访问「服务器IP:9966」即可容器监听 0.0.0.0局域网可直接访问。Linux 源码部署命令mkdir -p /data/chattts cd /data/chattts git clone https://gitcode.com/GitHub_Trending/ch/ChatTTS-ui . python3 -m venv venv source venv/bin/activate pip3 install -r requirements.txt pip3 install torch2.7.1 torchaudio2.7.1 python3 app.py需要 GPU 加速时改装 cu128 版 torchpip3 install torch2.7.1 torchaudio2.7.1 --index-url https://download.pytorch.org/whl/cu128。macOS 用户先执行brew install libsndfile。第一次合成操作步骤浏览器打开 http://127.0.0.1:9966启动成功后会自动弹出在文本框输入要合成的文字一行一句从下拉框选音色2222、7869、6653、4099、5099 等或在「自定义音色值」填种子数点击「立即合成声音」等待生成结束在下方列表里直接试听满意就下载 wav只改个别参数时其余留空即可页面已带默认值。音色参数推荐值参数作用推荐值voice预设音色种子2222稳妥适合初用custom_voice自定义音色种子大于0的整数优先于 voice固定填同一数字音色保持稳定temperature采样随机度0.00001–1.00.3top_p采样概率上限0.7top_k候选词数量20speed语速1–95prompt控制符笑声、停顿、口语化[laugh_0][break_6][oral_2]skip_refine跳过文本精修步骤默认 0控制符不生效时再改 1固定一个专属音色0.92 版本起把 csv 或 pt 格式的音色文件放进 speaker/ 目录页面下拉框就会出现。仓库自带 24 个 csv 预设音色。注意官方提示同一种子在不同设备上音色尤其音调可能有差异需要严格一致时建议直接用文件音色。接入 TTS API 最短示例import requests r requests.post(http://127.0.0.1:9966/tts, data{text: 本地语音合成演示, voice: 2222}) print(r.json())成功返回{code:0,msg:ok,audio_files:[{filename:…wav,url:http://127.0.0.1:9966/static/wavs/….wav}]}失败返回{code:1,msg:错误原因}。其余参数temperature、top_p、top_k、prompt、custom_voice、speed 等都有默认值只传 text 也能出音频追加wav1则直接返回音频文件而非 JSON。避坑手册常见报错与解法现象原因解法下载模型报 ProxyErrorModelScope 不允许走代理下载关闭代理后重试缺spk_stat.pt或path.yaml社区模型个别文件缺失手动下载对应文件放入models/pzc163/chatTTS/cannot find a working triton installation当前环境不支持 torch.compile.env 中把compiletrue改为compilefalsemacOS 卡在 0% 或报 libomp 错误缺少 libomp 依赖brew install libomp有显卡却仍用 CPU、速度很慢显存低于 4G 或 CUDA 版本不匹配升级 CUDA 12.8、显存 4G 起重装 cu128 版 torchDynamo is not supported on Python 3.12仅支持 Python 3.9–3.11降级到 Python 3.10场景与进阶技巧短视频配音文案里加[break_2]、[laugh_0]等控制符制造停顿和语气导出 wav 直接当视频音频无障碍朗读给视障用户读文本用 speed1–9按需调快或调慢对接第三方工具pyVideoTrans 1.82 在设置里填入本服务地址即可用它做视频自动配音的声源长文本按行分段输入系统逐行合成后自动合并成一个文件提速CUDA 12.8 的 GPU 明显更快.env 里的device可手动指定 cpu / mps / cuda产物音频为 24kHz wav存在static/wavs/目录页面有按钮可一键清空详细步骤见 README.md报错全集见 faq.md。项目仍在更新关注新版本即可。【免费下载链接】ChatTTS-ui一个简单的本地网页界面使用ChatTTS将文字合成为语音同时支持对外提供API接口。A simple native web interface that uses ChatTTS to synthesize text into speech, along with support for external API interfaces.项目地址: https://gitcode.com/GitHub_Trending/ch/ChatTTS-ui创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考