集成指南第三方软件接入
OpenMAIC 接入教程
在 OpenMAIC 中添加 Kitta AI 自定义 OpenAI 兼容 TTS，为 AI 教师、同学和课程内容配置克隆音色。
OpenMAIC 接入 Kitta AI TTS
OpenMAIC 支持自定义 OpenAI 兼容 TTS Provider。接入后，可以让 AI 教师、AI 同学、课程讲解和导出内容使用 Kitta AI 音色。
准备 API Key 和音色 ID
快速测试可以使用：
00a1b221-6137-4b73-ad62-b0cbce134167在设置页面添加自定义 Provider
进入 Settings → TTS，添加一个自定义 OpenAI 兼容 TTS Provider。填写：
| OpenMAIC 配置项 | 值 |
|---|---|
| Provider Name | Kitta AI |
| Base URL | https://kittaai.com/v1 |
| API Key | 你的 Kitta AI API Key |
| Model | fishaudio-s21pro-flash |
| Voice ID | 你的克隆音色 Voice ID |
| Voice Name | 自定义显示名称 |
OpenMAIC 会在 Base URL 后追加 /audio/speech，最终请求 POST /v1/audio/speech。Base URL 不要填写完整端点。
添加音色后，把这个 Provider 设为当前 TTS Provider，并选择刚添加的 Voice 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 Provider，并把模型和音色改为 Kitta AI 的 Model ID 与 Voice ID。
常见问题
- 404：Base URL 只填写到
/v1；不要填写/v1/audio/speech，否则可能重复路径。 - 401：检查当前 Provider 使用的 API Key，服务端修改后需要重启 OpenMAIC。
- 402：API 积分余额不足，需要补充积分。
- 400：确认模型为
fishaudio-s21pro-flash，音色为有效 Voice ID。 - 测试成功但课堂没有声音：确认 Kitta AI Provider 已设为当前 Provider，并为讲解角色选择了对应音色。
- 浏览器中出现跨域或密钥问题：在共享部署中改用 OpenMAIC 服务端 TTS 配置。