整合指南第三方集成
語音模式 MCP 設定
將 Kitta Audio 配置為 OpenAI 相容的 TTS 服務,用於語音模式和 MCP 用戶端(例如 Claude Code)。
將 Kitta Audio TTS 連接到語音模式 MCP
語音模式為 Claude Code 和其他 MCP 用戶端添加了雙向語音對話。將 Kitta 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 伺服器的進程。
- 無效的模型或語音:使用 Kitta Audio ID 而不是 OpenAI 預設值。
- 401/402:驗證金鑰和API信用餘額。