oddtts TTS 语音服务安装和配置指南

前言

• oddtts，顾名思义，是一个文本转语音服务，支持 edgeTTS, Kokoro 等模型，其中 kokoro-v1.1-zh 中英文混合效果很好，但只有 pth 格式没有onnx 格式（推理更快），此格式说明 kokoro-v1.1-zh 中英文混合模型正处于研发测试中
• oddtts 中的 edgeTTS 其实是一种远程调用，所以不需要下载模型、加载模型
• 以下步骤及细节以 Ubuntu 系统为例
• Ubuntu 23.04 以后，出于对 Python 环境的保护，pip 已无法正常安装应用模块，此时可使用 pipx
• 需要定位目标时使用 locate（sudo apt install -y plocate），类似于 Windows 的 everything，定位极快（find 太慢，which，where只能找可执行文件

安装 pipx（Ubuntu 22.04 及以下版本略过）

• root 用户
  1. apt update
  2. apt install -y pipx（）
  3. pipx --version
• 普通用户
  1. sudo apt update
  2. python3 -m pip install pipx
  3. python3 -m pipx ensurepath
  4. source ~/.bashrc
  5. pipx --version

安装 oddtts

• pipx install oddtts（仓库中版本有可能较老）
• pipx install -i https://pypi.org/simple/ oddtts（官方推荐，更新实时）
• pipx install -i https://pypi.mirrors.ustc.edu.cn/simple/ oddtts（中科大加速）
• pipx install -i https://pypi.tuna.tsinghua.edu.cn/simple/ oddtts（清华加速）
• pipx install -i https://mirrors.aliyun.com/pypi/simple/ oddtts（阿里云加速）

修改 oddtts 配置

• 查看配置位置 locate oddtts_config.py
• 修改内容
  HOST = "127.0.0.1"（默认地址，如需远程测试可改为 0.0.0.0，也可在 oddtts 启动时改为 0.0.0.0）
  PORT = 9001（默认端口，可在此自定义，也可在 oddtts 启动时自定义）
  oddtts_cfg = {
  "tts_type": ODDTTS_TYPE.ODDTTS_KOKORO_V1_1,（生产部署时固定模型，Kokoro-v1.1-zh 中英文）
  "local_model_dir": "ckpts", (暂不支持改动，kokoro-v1.1-zh 中英文混合模型需要，因正在研发测试中，需更新版本)
  }
  log_level = 40（默认 10，改为 40， 错误才保留日志，节省资源）

运行 oddtts

• oddtts
• oddtts --host 0.0.0.0 --port 10001

预先下载模型到默认位置

oddtts首次调用模型时，会自动从 huggingface 下载。
但是会产生两个问题，一个时 huggingface 国内下载很慢，而且 ckpts 及其下面的链接符号没有被自动创建。

• 这时候需要设置代理或有海外地址，
• 下载完成后，还需要手动使用脚本创建 ckpts 及其下面的链接符号（指向 ~/.cache/huggingface/hub/models--hexgrad--Kokoro-82M-v1.1-zh/snapshots/ID/ 同发布包内名称相同的、所有的链接符号（指向下载缓冲的相对路径）。

~/ckpts（配置固定的，首次下载 kokoro-v1.1-zh 模型时自动创建）
~/.cache/huggingface/hub（固定的，首次下载模型时自动创建）

测试 oddtts

• Web 测试
  http://127.0.0.1:9001（外部测试时使用 oddtts --host 0.0.0.0 + http://IP:9001 ，或者 oddtts + SSH 隧道即可）

• 命令行测试
  curl -X POST http://127.0.0.1:9001/v1/audio/speech
  -H "Content-Type: application/json"
  -d '{
  "model": "models--hexgrad--Kokoro-82M-v1.1-zh", （支持中英文混合的模型）
  "input": "你好，欢迎使用 OddTTS，这是一个使用 curl 命令的测试",
  "voice": "zf_001",
  "response_format": "wav"（默认 mp3）
  }'
  --output /tmp/test.wav

将 oddtts 注册为服务或 使用 Docker 部署

备注

• 测试页，有配置文件名，但无路径
• 如果 locate 什么也找不到，则 执行 sudo updatedb（locate 专有索引数据库更新）