整合指南第三方集成
AstrBot 串接教學
透過 OpenAI TTS Provider 將 AstrBot 串接至 Kitta Audio，讓智慧體使用你的複製音色回覆。
將 Kitta Audio TTS 串接至 AstrBot
AstrBot 可透過 OpenAI 相容語音端點呼叫 Kitta Audio。設定完成後，智慧體的文字回覆會使用指定的複製音色轉成語音。
AstrBot 會分開管理人格與 TTS Provider，因此需要先新增 Provider，再將它指派給預設設定或自訂規則。
準備 API Key 與 Voice ID
在 API 管理頁面建立 API Key，開啟自己的複製音色並複製 Voice ID，同時確認 API 點數充足。首次測試可使用：
00a1b221-6137-4b73-ad62-b0cbce134167新增 TTS Provider
在 AstrBot 管理面板新增文字轉語音服務商，選擇 OpenAI TTS (API)，並填寫：
| 設定 | 值 |
|---|---|
| API Key | Kitta Audio API Key |
| API Base URL | https://fishaudio.org/v1 |
| Model | fishaudio-s21pro-flash |
| Voice | 複製音色的 Voice ID |
| Timeout | 建議 60 秒 |
Base URL 只填到 /v1，AstrBot 會自行呼叫 /v1/audio/speech。
不要選擇 FishAudio TTS (API)
該 Provider 使用另一套原生介面與 32 位十六進位 reference ID。fishaudio.org 的音色必須透過 OpenAI TTS Provider 使用平台 Voice ID。
啟用語音回覆
在 AstrBot 設定中啟用 TTS，選擇剛建立的 Provider；如需同時傳送文字與語音，可開啟雙輸出。多個智慧體若要使用不同音色，請為每個 Voice ID 建立一個 Provider，再用自訂規則同時指定人格與 TTS Provider。
疑難排解
- Voice 無效：請填寫 Voice ID，不要填顯示名稱。
- 404：Base URL 應為
https://fishaudio.org/v1，不要重複加入/audio/speech。 - 401/402：檢查 API Key 與獨立 API 點數餘額。
- 呼叫錯誤介面：確認選擇 OpenAI TTS (API)，不是 FishAudio TTS (API)。
- 逾時：將 Timeout 設為
60秒，並先用短文字測試。