Fish Audio Docs
Guias de integraçãoIntegrações de terceiros
Back to site

Configurar o RimTalk TTS

Adicione o Fish Audio como provedor compatível com OpenAI no RimTalk TTS e atribua vozes diferentes aos colonos do RimWorld.

Conectar o Fish Audio TTS ao RimTalk

O RimTalk TTS pode chamar o Fish Audio por meio de um provedor personalizado compatível com OpenAI e ler o diálogo de cada colono com a voz escolhida.

Confira primeiro a versão do RimTalk

A tela de configurações precisa mostrar Custom TTS Providers (Untested!) e a opção de adicionar um provedor. Esse recurso está atualmente na versão de desenvolvimento do projeto. Se ele não aparecer, confira a origem e a versão do mod.

Preparação

Crie uma chave de API exclusiva para o RimTalk e obtenha um Voice ID do Fish Audio. Não publique a chave completa em capturas, conversas ou arquivos do mod. Revogue imediatamente qualquer chave já exposta.

Use esta voz do sistema no primeiro teste:

00a1b221-6137-4b73-ad62-b0cbce134167

Adicionar o provedor

Abra TTS Configuration → Custom TTS Providers → Add New Custom Provider e informe:

CampoValor
Provider nameFish Audio
Base URLhttps://fishaudio.org/v1
Endpoint path/audio/speech
Modelfishaudio-s21pro-flash
Default voice00a1b221-6137-4b73-ad62-b0cbce134167
Response formatmp3
Auth header nameAuthorization
Auth header prefixBearer seguido de um espaço
Timeout60 segundos

A URL completa deve ser https://fishaudio.org/v1/audio/speech. Ative speed e deixe streaming, temperature, top_p, campos de emoção e corpo personalizado desativados.

Não use tts-1, alloy nem o valor antigo s2.1-pro. O modelo do mecanismo e o UUID da voz são campos diferentes.

Atribuir vozes aos colonos

Salve e selecione o novo provedor. Na lista de modelos de voz, adicione um nome reconhecível e cole o UUID da voz do Fish Audio em Model ID. Escolha a voz padrão e atribua uma voz adequada a cada Pawn.

Teste e solução de problemas

Comece com uma frase curta de um único colono. Confirme a resposta HTTP 200, a reprodução completa do MP3 e o uso exibido no gerenciamento da API.

  • 401: confira a chave e o espaço depois de Bearer.
  • 402: adicione créditos de API.
  • 404: a Base URL termina em /v1 e o caminho é apenas /audio/speech.
  • 400: confira o modelo e o UUID da voz.
  • Tempo esgotado: use o modelo flash, 60 segundos e texto curto.
  • 429: mantenha o intervalo entre gerações e reduza solicitações simultâneas.

O RimTalk aguarda uma resposta de áudio síncrona e não consulta tarefas assíncronas; reduza entradas longas demais.

Documentação relacionada