🗣️ ZAI/GLM TTS

Install / 安装

🐳 Docker compose

mkdir /opt/zai-tts2api
cd /opt/zai-tts2api
echo "ZAI_USERID=xxxx-yyyy" > .env
echo "ZAI_TOKEN=eyJhbGc..." >> .env
wget https://raw.githubusercontent.com/aahl/zai-tts2api/refs/heads/main/docker-compose.yml
docker compose up -d

ZAI_USERID和ZAI_TOKEN可在audio.z.ai登录后，通过F12开发者工具在控制台执行localStorage['auth-storage']获取

🐳 Docker run

docker run -d \
  --name zai-tts2api \
  --restart=unless-stopped \
  -p 8823:80 \
  ghcr.io/aahl/zai-tts2api:main

🏠 Home Assistant OS Add-on

1. 添加加载项仓库

   • 打开 HomeAssistant，点击左侧菜单的 配置 (Settings) -> 加载项 (Add-ons)
   • 点击右下角的 加载项商店 (Add-on Store)
   • 点击右上角的三个点 -> 仓库 (Repositories)
   • 在输入框填入：https://gitee.com/hasscc/addons, 点击添加

2. 安装加载项：

   • 刷新页面，找到并点击 智谱TTS
   • 点击 安装 (Install)
   • 切换到 配置 标签页，添加ZAI_USERID和ZAI_TOKEN环境变量
   • 启动并设置开机启动

💻 Usage / 使用

🌐 CURL调用示例

curl --request POST \
  --url http://localhost:8823/v1/audio/speech \
  --header 'Content-Type: application/json' \
  --data '{"voice":"system_001", "input":"hello", "speed":1.0, "volume":1}' \
  --output output.wav

🏠 Home Assistant

1. 安装 AI Conversation 集成

   点击这里 一键安装，安装完记得重启HA

2. 添加 AI Conversation 服务，配置模型提供商

   服务商: 自定义; 接口: http://4e0de88e-zai-tts/v1; 密钥留空

3. 添加TTS模型，模型ID随意
4. 配置语音助手

如果想要使用克隆的音色，请在audio.z.ai完成音色克隆，并通过F12获取voice_id作为voice参数值