OpenMAIC Setup Guide
Add Kitta AI as a custom OpenAI-compatible TTS provider in OpenMAIC for AI teachers, classmates, and course narration.
Connect Kitta AI TTS to OpenMAIC
OpenMAIC supports custom OpenAI-compatible TTS providers. After connecting Kitta AI, AI teachers, classmates, course narration, and generated content can use your selected voice.
Prepare an API key and Voice ID
- Create a dedicated key in API management.
- Open your cloned voice and copy its Voice ID.
- Confirm that your API credit balance is sufficient.
For a quick test, use:
00a1b221-6137-4b73-ad62-b0cbce134167Add a custom provider in Settings
Open Settings → TTS and add a custom OpenAI-compatible TTS provider. Enter:
| OpenMAIC setting | Value |
|---|---|
| Provider Name | Kitta AI |
| Base URL | https://kittaai.com/v1 |
| API Key | Your Kitta AI API key |
| Model | fishaudio-s21pro-flash |
| Voice ID | Your cloned voice's Voice ID |
| Voice Name | Any display name |
OpenMAIC appends /audio/speech to the Base URL and sends the final request to POST /v1/audio/speech. Do not put the complete endpoint in the Base URL field.
After adding the voice, make this the active TTS provider and select the new Voice ID. Use the TTS test button with a short sentence to verify the voice and authentication.
Prefer server-side keys for shared deployments
OpenMAIC can store custom providers in client settings. Enter an API key there only on a trusted self-hosted instance. For public or multi-user deployments, administrators should configure TTS server-side so the key is not exposed to browser users.
Server-side configuration
Self-hosted administrators can configure Kitta AI with OpenMAIC environment variables:
TTS_OPENAI_API_KEY=YOUR_FISH_AUDIO_API_KEY
TTS_OPENAI_BASE_URL=https://kittaai.com/v1Restart OpenMAIC after changing the environment. Then select the OpenAI provider in TTS settings and replace the model and voice with the Kitta AI Model ID and Voice ID.
Troubleshooting
- 404: the Base URL must stop at
/v1. Do not enter/v1/audio/speech, which can duplicate the path. - 401: check the active provider's API key. Restart OpenMAIC after changing a server-side key.
- 402: add API credits before trying again.
- 400: use
fishaudio-s21pro-flashas the model and a valid Voice ID. - The test works but the classroom is silent: make Kitta AI the active provider and assign its voice to the narration role.
- Browser CORS or key concerns: use OpenMAIC's server-side TTS configuration on a shared deployment.