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

Guía de configuración de AstrBot

Conecta AstrBot a Kitta Audio mediante OpenAI TTS Provider y usa tu voz clonada en las respuestas del agente.

Conectar Kitta Audio TTS a AstrBot

AstrBot puede llamar a Kitta Audio mediante un endpoint de voz compatible con OpenAI. Las personas y los proveedores TTS se administran por separado: crea primero el proveedor y asígnalo mediante la configuración predeterminada o una regla personalizada.

Preparar API Key y Voice ID

Crea una clave en la gestión de API, copia el Voice ID de tu voz clonada y revisa los créditos API. Para la primera prueba puedes usar:

00a1b221-6137-4b73-ad62-b0cbce134167

Añadir el proveedor TTS

En el panel de AstrBot, añade un proveedor de texto a voz y elige OpenAI TTS (API).

AjusteValor
API KeyTu API Key de Kitta Audio
API Base URLhttps://fishaudio.org/v1
Modelfishaudio-s21pro-flash
VoiceVoice ID de la voz clonada
Timeout60 segundos recomendado

La Base URL debe terminar en /v1; AstrBot llama automáticamente a /v1/audio/speech.

No elijas FishAudio TTS (API)

Ese proveedor usa otra API nativa y exige un reference ID hexadecimal de 32 caracteres. Para voces de fishaudio.org usa OpenAI TTS Provider y el Voice ID de la plataforma.

Activar respuestas de voz

Activa TTS en AstrBot y selecciona el proveedor creado. Para varios agentes, crea un proveedor por Voice ID y asigna la persona y el proveedor TTS mediante reglas personalizadas.

Solución de problemas

  • Voice no válida: introduce el Voice ID, no el nombre visible.
  • 404: usa https://fishaudio.org/v1 sin duplicar /audio/speech.
  • 401/402: comprueba la clave y el saldo independiente de créditos API.
  • API incorrecta: elige OpenAI TTS (API), no FishAudio TTS (API).
  • Tiempo agotado: configura 60 segundos y prueba primero un texto corto.

Documentación relacionada