集成指南第三方软件接入
Android Custom TTS 接入教程
将 Android Custom TTS Service 接入 Kitta AI，让支持 Android 系统 TTS 的应用使用克隆音色朗读。
将 Kitta AI 设置为 Android 系统 TTS 引擎
Custom TTS Service for Android 可以把 OpenAI 兼容语音端点接入 Android 系统文字转语音接口。使用系统 TTS 引擎的应用随后可以调用 Kitta AI 音色朗读文本。
注意系统 TTS 的适用边界
只有调用 Android 系统 TTS 引擎的应用会使用这个配置。自带独立语音 Provider 的应用可能忽略 Android 系统选择。
准备 API Key 和 Voice ID
首次测试使用以下系统测试音色：
00a1b221-6137-4b73-ad62-b0cbce134167安装并配置 TTS 引擎
从项目 Releases 页面安装 APK，打开应用并填写：
| 配置项 | 值 |
|---|---|
| Backend URL | https://kittaai.com/v1/audio/speech |
| API Key | 你的 Kitta AI API Key |
| TTS Model | fishaudio-s21pro-flash |
| TTS Voice | 00a1b221-6137-4b73-ad62-b0cbce134167 |
| Response Format | wav |
填写完整端点并使用 WAV
Android 服务会直接请求 Backend URL，因此必须包含 /audio/speech。当前版本只能播放 WAV 和
PCM，尚未实现 MP3、Opus 解码；接入 Kitta AI 时使用 wav。
点击 Save，再点击 Open Android TTS Settings，把 Custom TTS 设为首选引擎。使用 Android 示例播放或目标应用的朗读按钮测试一小段文本。
密钥和音色说明
- API Key 会保存在 Android 设备上，建议使用可独立撤销的设备专用 Key。
- Voice 字段必须填写 Kitta AI Voice ID，不能填写音色展示名称。
- 系统测试音色成功后，再替换为自己的克隆音色。
- Android 每次调用该引擎生成语音时都需要网络连接。
常见问题
- 没有声音：把 Response Format 设置为
wav；当前应用虽然列出 MP3 和 Opus，但尚不能解码播放。 - 404：Backend URL 必须填写完整的
https://kittaai.com/v1/audio/speech。 - 401：替换应用中保存的 API Key，建议重新创建设备专用 Key。
- 402：API 积分不足，需要补充积分后重试。
- 400 或音色无效：使用
fishaudio-s21pro-flash和有效的 Kitta AI Voice ID。 - 仍播放其他声音：在 Android 系统 TTS 设置中选择 Custom TTS，并确认目标应用使用系统 TTS。