aculeasis/rhvoice-rest

rhvoice-rest Docker镜像文档

镜像概述

rhvoice-rest是一个基于Flask框架和RHVoice语音合成器构建的Web服务，通过REST API提供文本转语音(TTS)功能。该服务易于集成到各类应用中，作为TTS提供商使用，支持多种语言、音频格式及语音参数调整。

核心功能与特性

• 多语言支持：涵盖俄语(aleksandr、anna等)、英语(alan、bdl等)、世界语(spomenka)、格鲁吉亚语(natia)等多种语言语音
• 丰富音频格式：支持wav、mp3、***、flac等多种输出格式
• 可调节语音参数：支持语速(rate)、音调(pitch)、音量(volume)自定义
• 多架构支持：兼容x86-64(amd64)、arm64(arm64v8)、armhf(arm32v7)架构
• 灵活集成：提供标准REST API，支持与Rhasspy、Home Assistant等系统集成
• 可配置缓存：支持动态缓存和文件缓存，优化性能

使用场景

• 语音助手系统（如Rhasspy）的TTS模块
• 智能家居设备的语音提示功能
• 需要文本转语音功能的移动应用或Web应用
• 低性能设备（如单板机）的远程TTS服务

快速部署

Docker Run命令

bash
docker run -d \
  --name=rhvoice-rest \
  -p 8080:8080 \
  --restart unless-stopped \
  docker.xuanyuan.run/aculeasis/rhvoice-rest:latest

支持架构

自动更新

可配合https://github.com/containrrr/watchtower%E5%AE%9E%E7%8E%B0%E5%AE%B9%E5%99%A8%E8%87%AA%E5%8A%A8%E6%9B%B4%E6%96%B0%EF%BC%9A

bash
docker run -d \
  --name watchtower \
  -v /var/run/docker.sock:/var/run/docker.sock \
  docker.xuanyuan.run/containrrr/watchtower rhvoice-rest --interval 86400

API使用说明

基础接口

语音合成接口

http://SERVER/say?
text=<文本>&voice=<语音>&format=<格式>&rate=<语速>&pitch=<音调>&volume=<音量>

参数说明：

• SERVER：服务地址和端口（默认本地为localhost:8080）
• text：URL编码的文本内容（必填参数）
• voice：语音选择（可通过http://SERVER/voices获取完整列表，默认使用anna）
• format：输出格式（wav/mp3/***/flac，默认mp3）
• rate：语速（0-100，默认50）
• pitch：音调（0-100，默认50）
• volume：音量（0-100，默认50）

服务信息接口

http://SERVER/info

返回JSON格式的服务器信息

使用示例

1. 基础语音合成（默认参数）：

http://localhost:8080/say?text=Привет

2. 自定义格式和语音：

http://localhost:8080/say?text=Hello%20world&voice=alan&format=opus

3. 调整语音参数：

http://localhost:8080/say?text=Привет%20ещё%20раз&rate=60&pitch=40&volume=70

集成指南

Rhasspy语音助手集成

通过Rhasspy的Remote TTS系统集成，需将接口路径替换为/rhasspy：

json
"text_to_speech": {
  "system": "remote",
  "remote": {
      "url": "http://localhost:8080/rhasspy?voice=anna"
  }
}

注：Rhasspy集成时会忽略text和format参数，格式固定为wav，文本通过POST请求体传递

Home Assistant集成

可使用第三方组件https://github.com/definitio/ha-rhvoice%E5%AE%9E%E7%8E%B0%E4%B8%8EHome Assistant的集成

配置参数

所有配置通过环境变量设置，可在docker run命令中使用-e参数传递：

配置示例

bash
docker run -d \
  --name=rhvoice-rest \
  -p 8080:8080 \
  -e THREADED=2 \
  -e RHVOICE_FCACHE=true \
  -e RHVOICE_FCACHE_LIFETIME=24 \
  --restart unless-stopped \
  docker.xuanyuan.run/aculeasis/rhvoice-rest:latest

验证测试

服务启动后可通过以下URL验证：

• 基础测试：http://localhost:8080/say?text=Привет
• 格式测试：http://localhost:8080/say?text=Привет%20ещё%20раз&format=opus
• 多语言测试：http://localhost:8080/say?text=Kaj%20mi%20ankaŭ%20parolas%20Esperanton&voice=spomenka&format=opus