ChatTTS本地部署教程5分钟搭一套免费的文字转语音服务【免费下载链接】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需要批量产出配音又不想把文本交给云端、不想按字数付费ChatTTS-ui 就是为此而生的本地方案一个网页界面把中英文混杂、带数字符号的文本合成为自然语音同时对外暴露 REST 接口方便接进你现有的程序。按下面的步骤走从空机器到第一条语音大概 5 分钟。先确认你属于哪类人这个项目适合三种情况内容制作要批量合成中文、中英混杂的旁白且希望同一句子的音色可固定复用开发者字幕、配音、朗读类应用需要一个可私有的 TTS 接口隐私敏感文本不能离开本机或团队内部部署、多人共用一台机器如果你的需求只是偶尔转几句话云 TTS API 反而更省事没必要折腾本地部署。5分钟跑通预打包版最快Windows 用户从 Releases 下载压缩包解压后直接双击app.exe浏览器会自动打开http://127.0.0.1:9966。两个注意点部分安全软件会误报病毒可临时放行或改走源码部署英伟达显卡显存大于 4G 且安装了 CUDA 12.8 才会启用 GPU 加速否则自动回退 CPU源码部署Linux / macOS / Windows 三条路三种系统的流程一致只是装 torch 的方式不同。以 Linux 为例要求 Python 3.9–3.113.12 以上会报 Dynamo 错误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.txtCPU 版直接装基础 torchGPU 版追加--index-url https://download.pytorch.org/whl/cu128并装好 CUDA 12.8pip3 install torch2.7.1 torchaudio2.7.1 --index-url https://download.pytorch.org/whl/cu128最后一步统一是python3 app.py启动后浏览器自动打开默认地址http://127.0.0.1:9966。macOS 用户额外执行brew install libsndfile libompDocker 用户则只需一条命令docker compose -f docker-compose.gpu.yaml up -d # CPU 换成 docker-compose.cpu.yaml首次启动会自动下载 ChatTTS 模型优先从魔塔 modelscope 拉取连不上再走 huggingface。 这一步是唯一耗时的环节下完就缓存在本地了。网页界面能做什么界面由 templates/index.html 渲染按系统语言自动切换中英文核心控件就这几类控件说明文本框按行输入每行合成一段支持数字、符号与控制符混杂音色选择读取speaker/目录下的 csv / pt 音色文件也可填一个数字随机取音色控制符 prompt如[oral_2][laugh_0][break_6]控制口语度、笑声、停顿采样参数temperature默认 0.3、top_p0.7、top_k20自定义音色种子填大于 0 的整数比voice参数优先级更高合成结果统一是 24kHz 的 wav落在static/wavs/目录页面上可直接试听和下载。接入你的程序/tts 接口对外接口定义在 app.pyPOST http://127.0.0.1:9966/tts唯一必填参数是textimport requests res requests.post( http://127.0.0.1:9966/tts, data{text: 你好这是 ChatTTS 本地合成的语音, voice: 3333} ) print(res.json()) # 成功: {code:0, msg:ok, audio_files:[{filename:本地wav路径, url:可下载地址, ...}]} # 失败: {code:1, msg:错误原因}按需再加这些可选参数prompt控制符如[oral_2][break_6]custom_voice自定义音色种子设置后忽略voicetemperature/top_p/top_k随机性控制speed语速默认 5wav1直接返回 wav 文件而不是 JSONaudio_files里同时给了本地绝对路径和 http 下载地址按你的场景取一个即可。常见报错怎么解九成问题都能在下面这条清单里对号入座完整列表见 faq.md症状处理modelscope 下载报 ProxyError从魔塔下模型时关闭代理国内连不上它才会回退 huggingface缺spk_stat.pt或path.yaml模型不完整手动补齐到models/pzc163/chatTTS/对应子目录cannot find a working triton installation打开.env把compiletrue改成compilefalse有 GPU 却慢、走 CPU显存低于 4G 会强制 CPU否则卸载 torch 重装 cu128 版本同种子音色对不上正常现象跨机器、甚至同机器多次合成音色都可能漂移地址和端口想改就编辑 .env 里的WEB_ADDRESS比如改成192.168.0.10:9966让局域网访问device字段可手动指定cpu/mps/cuda。上线前检查清单Python 在 3.9–3.11 区间3.12 会报 Dynamo 不支持torch 版本 2.7.1GPU 用户确认装的是 cu128 版本首次启动已让模型下载完毕models/目录.env中WEB_ADDRESS是你想要的监听地址浏览器打开http://127.0.0.1:9966成功合成出一句语音机器只启动这一次最费时之后每一次合成都是本地免费完成——文本不出门接口随你调。【免费下载链接】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），仅供参考