整合指南第三方集成
OpenMAIC 設定指南
在 OpenMAIC 中新增 Kitta AI 作為自訂 OpenAI 相容的 TTS 提供程序，用於 AI 教師、同學和課程旁白。
將 Kitta AI TTS 連接到 OpenMAIC
OpenMAIC 支援自訂 OpenAI 相容的 TTS 提供者。連結Kitta AI後，AI老師、同學、課程旁白、產生的內容都可以使用您選擇的聲音。
準備 API 金鑰和語音 ID
要進行快速測試，請使用：
00a1b221-6137-4b73-ad62-b0cbce134167在設定中新增自訂提供者
進入 Settings → TTS，新增自訂的 OpenAI 相容 TTS Provider。填寫：
| OpenMAIC設定 | 價值 |
|---|---|
| 提供者名稱 | Kitta AI |
| 基本網址 | https://kittaai.com/v1 |
| API 鑰匙 | 您的 Kitta AI API 鑰匙 |
| 型號 | fishaudio-s21pro-flash |
| 語音辨識 | 您複製聲音的語音 ID |
| 語音名稱 | 任何顯示名稱 |
OpenMAIC 將 /audio/speech 附加到基本 URL 並將最終請求傳送至 POST /v1/audio/speech。不要將完整的端點放在基本 URL 欄位中。
新增語音後，使其成為活動的 TTS 提供者並選擇新的語音 ID。使用帶有短句的TTS測試按鈕來驗證語音和身份驗證。
共用部署優先使用服務端金鑰
OpenMAIC 可以在客戶端設定中儲存自訂 Provider。只應在信任的自託管執行個體中直接填寫 API Key；多人共用或公開部署應由管理員設定服務端 TTS，避免向瀏覽器使用者暴露金鑰。
伺服器端配置
自託管管理員可以使用 OpenMAIC 環境變數設定 Kitta AI：
TTS_OPENAI_API_KEY=YOUR_FISH_AUDIO_API_KEY
TTS_OPENAI_BASE_URL=https://kittaai.com/v1更改環境後重新啟動OpenMAIC。然後在TTS設定中選擇OpenAI供應商，並將模型和語音替換為Kitta AI模型ID和語音ID。
故障排除
- 404：基本 URL 必須停止於
/v1。請勿輸入/v1/audio/speech，這可能會導致路徑重複。 - 401：檢查活動提供者的 API 金鑰。更改伺服器端密鑰後重新啟動 OpenMAIC。
- 402：在重試之前加入 API 積分。
- 400：使用
fishaudio-s21pro-flash作為模型和有效的語音 ID。 - 測試有效，但教室安靜：使 Kitta AI 成為主動提供者，並將其聲音分配給旁白角色。
- 瀏覽器 CORS 或關鍵問題：在共用部署上使用 OpenMAIC 的伺服器端 TTS 設定。