siliconflow_tts/SETUP_GUIDE.md

SiliconFlow TTS/STT 组件安装指南

安装步骤

1. 重启Home Assistant

修改了组件文件后，需要重启Home Assistant以加载新的组件。

2. 添加集成

重启后，按以下步骤添加集成：

1. 进入 设置 > 设备与服务
2. 点击右下角的 添加集成 按钮
3. 搜索 SiliconFlow
4. 你应该能看到两个集成：
   • SiliconFlow TTS
   • SiliconFlow STT

3. 配置TTS

1. 选择 SiliconFlow TTS
2. 输入你的硅基流动API密钥
3. 点击提交

4. 配置STT

1. 选择 SiliconFlow STT
2. 输入你的硅基流动API密钥
3. 点击提交

5. 配置语音助手

配置完成后：

1. 进入 设置 > 语音助手
2. 在 文本转语音 中选择 SiliconFlow TTS
3. 在 语音转文本 中选择 SiliconFlow STT

故障排除

找不到集成

如果在添加集成页面找不到SiliconFlow：

1. 确保已重启Home Assistant
2. 检查日志是否有错误信息
3. 确认文件结构正确

API密钥验证失败

如果API密钥验证失败：

1. 检查API密钥是否正确
2. 确认网络连接正常
3. 检查硅基流动服务状态

语音助手中找不到选项

如果在语音助手设置中找不到对应选项：

1. 确保两个集成都已成功配置
2. 重新加载集成
3. 重启Home Assistant

使用方法

配置完成后，你可以：

在自动化中使用TTS

action:
  - service: tts.speak
    target:
      entity_id: tts.siliconflow_tts
    data:
      message: "你能用高兴的情感说吗？<|endofprompt|>Hello World!"

在脚本中使用

script:
  test_tts:
    sequence:
      - service: tts.speak
        target:
          entity_id: tts.siliconflow_tts
        data:
          message: "测试消息"
          options:
            voice: "FunAudioLLM/CosyVoice2-0.5B:anna"

使用自定义音色

script:
  custom_voice:
    sequence:
      - service: tts.speak
        target:
          entity_id: tts.siliconflow_tts
        data:
          message: "自定义音色测试"
          options:
            reference_audio: "speech:your-voice-uri"