整合指南第三方集成
語音模式 MCP 設定
將 Fish Audio 配置為 OpenAI 相容的 TTS 服務，用於語音模式和 MCP 用戶端（例如 Claude Code）。
將 Fish Audio TTS 連接到語音模式 MCP
語音模式為 Claude Code 和其他 MCP 用戶端添加了雙向語音對話。將 Fish Audio OpenAI 相容端點新增至其 TTS 服務清單。
配置環境變數
將這些值新增至 MCP 伺服器的 env 區塊：
{
"OPENAI_API_KEY": "YOUR_API_KEY",
"VOICEMODE_TTS_BASE_URLS": "https://fishaudio.org/v1",
"VOICEMODE_TTS_MODEL": "fishaudio-s21pro-flash",
"VOICEMODE_TTS_VOICE": "00a1b221-6137-4b73-ad62-b0cbce134167"
}或者，將它們放入 ~/.voicemode/voicemode.env 中：
export OPENAI_API_KEY="YOUR_API_KEY"
export VOICEMODE_TTS_BASE_URLS="https://fishaudio.org/v1"
export VOICEMODE_TTS_MODEL="fishaudio-s21pro-flash"
export VOICEMODE_TTS_VOICE="00a1b221-6137-4b73-ad62-b0cbce134167"舊版 TTS_BASE_URL、TTS_MODEL 和 TTS_VOICE 變數仍受支持，但新配置應使用 VOICEMODE_ 名稱。
測試並改變聲音
重新啟動 MCP 用戶端，以便語音模式伺服器重新載入其環境。開始簡短的語音對話，然後用您喜歡的語音 ID 取代測試語音。
配置多個 TTS URL 時，語音模式可以依序嘗試回退服務。故障排除時僅保留 https://fishaudio.org/v1。
故障排除
- 使用另一個服務：在測試期間從
VOICEMODE_TTS_BASE_URLS中刪除其他條目。 - API 金鑰遺失：確保變數可用於啟動 MCP 伺服器的進程。
- 無效的模型或語音：使用 Fish Audio ID 而不是 OpenAI 預設值。
- 401/402：驗證金鑰和API信用餘額。