集成指南第三方软件接入
Open WebUI 接入教程
在 Open WebUI 中配置 Fish Audio OpenAI 兼容 TTS Base URL、API Key、模型和音色。
Open WebUI 接入 Fish Audio TTS
Open WebUI 支持把 OpenAI 兼容接口设为文字转语音服务。配置完成后，可以点击 AI 回复旁的扬声器按钮，用 Fish Audio 音色朗读内容。
准备 API 配置
先创建一个专用于 Open WebUI 的 API Key。首次测试使用：
| 配置项 | 值 |
|---|---|
| API Base URL | https://fishaudio.org/v1 |
| Model | fishaudio-s21pro-flash |
| Voice | 00a1b221-6137-4b73-ad62-b0cbce134167 |
通过管理界面配置
使用管理员账号进入：
Admin Panel → Settings → Audio → Text-to-Speech选择 OpenAI 引擎，填写 Base URL、API Key、模型和音色，然后保存。Base URL 不要附加 /audio/speech。
通过环境变量配置
如果使用 Docker 或服务器部署，可以设置：
AUDIO_TTS_ENGINE=openai
AUDIO_TTS_OPENAI_API_BASE_URL=https://fishaudio.org/v1
AUDIO_TTS_OPENAI_API_KEY=YOUR_API_KEY
AUDIO_TTS_MODEL=fishaudio-s21pro-flash
AUDIO_TTS_VOICE=00a1b221-6137-4b73-ad62-b0cbce134167更新环境变量后重启 Open WebUI。环境变量属于持久配置；如果管理界面已经保存过设置，请再次检查界面中的值是否覆盖了启动配置。
测试语音
新建聊天并让模型回复一句短文本，点击回复旁的扬声器图标。如果短句能够正常播放，再把测试音色替换为自己的 Fish Audio 音色 ID。
常见问题
- 401：API Key 缺失、包含空格或已经撤销。
- 402：API 积分不足；会员积分不能代替 API 积分。
- 模型或音色无效：不要填写
tts-1或alloy，应使用 Fish Audio 模型和音色 ID。 - 没有扬声器按钮：确认 TTS Engine 已启用，并重新加载聊天页面。
- 长回复中途停止：在 Audio 设置中启用按标点或段落切分。