Xiaoai Tts

XiaoAI TTS

通过 XiaoAI HTTP API 控制小爱音箱播放语音，支持火山引擎豆包 TTS 多情感、多音色、语速调整等高级功能。

前置配置

在 env 中添加：

OPENXIAOAI_BASE_URL="http://192.168.x.x:9092"  # OpenXiaoAI 服务地址

使用方法

# 语音播报（优先 Doubao TTS，失败自动回退小爱自带 TTS）
xiaoai-tts tts "你好，我是小爱语音助手"

# 指定音色
xiaoai-tts tts "你好" -s zh_female_vv_uranus_bigtts

# 调整语速（0.8-2.0）
xiaoai-tts tts "你好" --speed 1.2

# 指定情感（仅多情感音色支持）
xiaoai-tts tts "你怎么能这样！" -s zh_male_lengkugege_emo_v2_mars_bigtts -m angry

# 2.0 音色 + 上下文指令
xiaoai-tts tts "这是一个很长的句子" -s zh_female_vv_uranus_bigtts -c "你可以说慢一点吗？"

# 强制使用小爱自带 TTS
xiaoai-tts text "你好"

# 唤醒小爱
xiaoai-tts wakeup
xiaoai-tts wakeup --silent   # 静默唤醒

# 状态 / 健康检查
xiaoai-tts status
xiaoai-tts health

# 播放音频
xiaoai-tts file /path/to/audio.mp3
xiaoai-tts url "http://example.com/audio.mp3"

# 查看可用音色
xiaoai-tts voices            # 所有音色
xiaoai-tts voices -v 2.0     # 仅 2.0 音色
xiaoai-tts voices -v 1.0     # 仅 1.0 音色

常用音色推荐

用户自定义声音复刻（S_ 前缀）

如果用户想使用自定义复刻音色，引导用户前往 火山引擎声音复刻控制台 上传声音训练专属音色，训练完成后在 音色库 的「我的音色」中复制音色 ID（格式为 S_xxxxxxxx），填入 -s 参数即可使用。

xiaoai-tts tts "你好，我是你的专属语音助手" -s S_xxxxxxxx

注意：声音复刻音色 ID 通常以 S_ 开头，传入时无需通过 xiaoai-tts voices 列表验证，直接使用即可。

工作流：

1. 用户想使用自定义复刻音色时，引导用户前往火山引擎完成声音训练并获取音色 ID
2. 用户拿到音色 ID 后，引导用户将音色昵称和 ID 填入下方表格
3. 后续用户提到音色昵称时，直接从表格中查找对应 ID 使用

用户已保存的自定义音色

2.0 音色（推荐）

1.0 音色（多情感）

情感参数（仅多情感音色）

完整情感列表参考：xiaoai-tts voices

API 端点

• Base URL: http://{host}:9092
• Content-Type: application/json