Fish Audio Docs
Guías de integraciónIntegraciones de terceros
Back to site

Configurar RimTalk TTS

Añade Fish Audio como proveedor compatible con OpenAI en RimTalk TTS y asigna voces distintas a los colonos de RimWorld.

Conectar Fish Audio TTS con RimTalk

RimTalk TTS puede llamar a Fish Audio mediante un proveedor personalizado compatible con OpenAI para leer los diálogos de cada colono con una voz asignada.

Comprueba la versión de RimTalk

La configuración debe mostrar Custom TTS Providers (Untested!) y la opción para añadir un proveedor. Esta función pertenece actualmente a la versión de desarrollo del proyecto. Si no aparece, comprueba primero el origen y la versión del mod.

Preparación

Crea una clave API exclusiva para RimTalk y consigue un Voice ID de Fish Audio. No publiques la clave completa en capturas, chats ni archivos del mod. Revoca cualquier clave que ya haya quedado expuesta.

Para la primera prueba puedes usar esta voz del sistema:

00a1b221-6137-4b73-ad62-b0cbce134167

Añadir el proveedor

Abre TTS Configuration → Custom TTS Providers → Add New Custom Provider e introduce:

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 un espacio
Timeout60 segundos

La URL completa debe ser https://fishaudio.org/v1/audio/speech. Activa speed y deja desactivados streaming, temperature, top_p, campos de emoción y el cuerpo personalizado.

No uses tts-1, alloy ni el valor antiguo s2.1-pro. El modelo del motor y el UUID de voz son campos diferentes.

Asignar voces a los colonos

Guarda y selecciona el nuevo proveedor. En la lista de modelos de voz, añade un nombre reconocible y pega el UUID de Fish Audio en Model ID. Elige una voz predeterminada y asigna después una voz a cada Pawn.

Probar y solucionar problemas

Empieza con una frase corta de un solo colono. Comprueba que la respuesta sea HTTP 200, que el MP3 se reproduzca completo y que el uso aparezca en la administración de la API.

  • 401: revisa la clave y el espacio después de Bearer.
  • 402: añade créditos de API.
  • 404: Base URL termina en /v1 y Endpoint path debe ser /audio/speech.
  • 400: comprueba el modelo y el UUID de voz.
  • Tiempo agotado: usa el modelo flash, 60 segundos y texto corto.
  • 429: conserva el intervalo de generación y reduce las solicitudes simultáneas.

RimTalk espera una respuesta de audio síncrona y no consulta trabajos asíncronos; acorta las entradas demasiado largas.

Documentación relacionada