Kitta AI Docs
Guias de integraçãoIntegrações de terceiros
Back to site

Guia de configuração do OpenMAIC

Adicione Kitta AI como um provedor TTS compatível com OpenAI personalizado no OpenMAIC para professores de IA, colegas de classe e narração de cursos.

#Conecte Kitta AI TTS ao OpenMAIC

OpenMAIC oferece suporte a provedores TTS personalizados compatíveis com OpenAI. Depois de conectar o Kitta AI, professores de IA, colegas, narração do curso e conteúdo gerado podem usar a voz selecionada.

Prepare uma chave API e um ID de voz

  1. Crie uma chave dedicada em gerenciamento API.
  2. Abra sua voz clonada e copie seu ID de voz.
  3. Confirme se seu saldo de crédito API é suficiente.

Para um teste rápido, use:

00a1b221-6137-4b73-ad62-b0cbce134167

Adicione um provedor personalizado em Configurações

Abra Settings → TTS e adicione um provedor TTS personalizado compatível com OpenAI. Digitar:

Configuração OpenMAICValor
Nome do provedorKitta AI
URL basehttps://kittaai.com/v1
Chave APISua chave Kitta AI API
Modelofishaudio-s21pro-flash
ID de vozID de voz da sua voz clonada
Nome da vozQualquer nome de exibição

OpenMAIC anexa /audio/speech ao URL base e envia a solicitação final para POST /v1/audio/speech. Não coloque o endpoint completo no campo URL base.

Depois de adicionar a voz, torne-o o provedor TTS ativo e selecione o novo ID de voz. Use o botão de teste TTS com uma frase curta para verificar a voz e a autenticação.

Prefer server-side keys for shared deployments

OpenMAIC pode armazenar provedores personalizados nas configurações do cliente. Insira uma chave API apenas em um confiável instância auto-hospedada. Para implantações públicas ou multiusuário, os administradores devem configurar TTS lado do servidor para que a chave não seja exposta aos usuários do navegador.

Configuração do lado do servidor

Administradores auto-hospedados podem configurar Kitta AI com variáveis ​​de ambiente OpenMAIC:

TTS_OPENAI_API_KEY=YOUR_FISH_AUDIO_API_KEY
TTS_OPENAI_BASE_URL=https://kittaai.com/v1

Reinicie o OpenMAIC após alterar o ambiente. Em seguida, selecione o provedor OpenAI nas configurações de TTS e substitua o modelo e a voz pelo ID do modelo e ID de voz Kitta AI.

Solução de problemas

  • 404: o URL base deve parar em /v1. Não insira /v1/audio/speech, pois pode duplicar o caminho.
  • 401: verifique a chave API do provedor ativo. Reinicie o OpenMAIC após alterar uma chave do lado do servidor.
  • 402: adicione créditos API antes de tentar novamente.
  • 400: use fishaudio-s21pro-flash como modelo e um ID de voz válido.
  • O teste funciona, mas a sala de aula fica em silêncio: torne Kitta AI o provedor ativo e atribua sua voz à função de narração.
  • CORS do navegador ou principais preocupações: use a configuração TTS do lado do servidor do OpenMAIC em uma implantação compartilhada.

Documentação relacionada