整合指南第三方集成
Android Custom TTS 接入教學
將適用於 Android 的自訂 TTS 服務連接到 Kitta AI，並在支援 Android 系統 TTS 引擎的應用程式中使用複製語音。
使用Kitta AI作為Android系統TTS引擎
適用於 Android 的自訂 TTS 服務 將 OpenAI 相容的語音端點連接到 Android 的系統文字轉語音介面。使用所選 Android TTS 引擎的應用程式可以使用 Kitta AI 語音讀取文字。
System TTS boundary
這僅適用於使用作業系統 TTS 引擎的 Android 應用程式。一個有自己的應用程式 內建語音提供者可能會忽略 Android 系統選擇。
準備 API Key 和 Voice ID
使用此系統語音進行第一次測試：
00a1b221-6137-4b73-ad62-b0cbce134167安裝並設定引擎
從專案的發布頁面安裝 APK，打開應用程序，然後輸入：
| 設定 | 價值 |
|---|---|
| 後台網址 | https://kittaai.com/v1/audio/speech |
| API 鑰匙 | 您的 Kitta AI API 鑰匙 |
| TTS 型號 | fishaudio-s21pro-flash |
| TTS 語音 | 00a1b221-6137-4b73-ad62-b0cbce134167 |
| 回覆格式 | wav |
填寫完整端點並使用 WAV
Android 服務會直接請求 Backend URL，因此必須包含 /audio/speech。目前版本支援 WAV 和 PCM
播放，但尚未實作 MP3、Opus 解碼；接入 Kitta AI 時使用 wav。
點擊 儲存，然後點擊 開啟 Android TTS 設定，並選擇 自訂 TTS 作為首選引擎。使用 Android 的範例播放或應用程式的朗讀按鈕來測試短句子。
安全性與語音註釋
- API 金鑰儲存在 Android 裝置上。使用可以撤銷而不影響其他整合的專用金鑰。
- 語音欄位需要 Kitta AI 語音 ID，而不是語音的顯示名稱。
- 只有在第一次測試成功後，才用您的複製語音取代系統測試語音。
- 每當 Android 要求引擎合成語音時，都需要網路存取。
故障排除
- 無音訊：將回應格式設為
wav； MP3 和 Opus 已列出，但目前應用程式無法解碼。 - 404：後端URL必須是完整的
https://kittaai.com/v1/audio/speech位址。 - 401：以有效的專用金鑰取代已儲存的 API 金鑰。
- 402：在重試之前加入 API 積分。
- 400 或無效語音：使用
fishaudio-s21pro-flash和有效的 Kitta AI 語音 ID。 - 播放另一個聲音：在Android系統TTS設定中選擇自訂TTS，並檢查目標應用程式是否使用系統TTS。