Guía de configuración de Tavo
Configure Fish Audio como un proveedor personalizado de OpenAI compatible con TTS en Tavo, luego asigne voces de Fish Audio a sus personajes.
Conecte Fish Audio TTS a Tavo
Esta guía muestra cómo configurar Fish Audio como un proveedor TTS personalizado compatible con OpenAI en Tavo y asignar una voz Fish Audio a un personaje. Después de la configuración, Tavo puede leer mensajes de caracteres con la voz seleccionada.
Lo que necesitas
- Una cuenta Fish Audio con créditos API;
- Una clave Fish Audio API;
- El ID de voz Fish Audio que desea utilizar;
- Una instalación de Tavo en funcionamiento.
Una clave API es una credencial confidencial. No lo envíes a otras personas ni lo incluyas en mensajes de chat, capturas de pantalla públicas o sitios web que no sean de confianza. Cree una clave dedicada para Tavo para que pueda monitorearla o revocarla por separado.
Paso 1: Crear una clave Fish Audio API
Inicie sesión en Fish Audio, abra la administración de API y cree una clave para Tavo. Cópielo y guárdelo inmediatamente porque es posible que la clave completa solo se muestre una vez.
Paso 2: busque una identificación de voz
Tavo necesita un Voice ID para sintetizar el habla con una voz específica. Copie uno de su lista de voces Fish Audio o consulte el API:
Para probar la conexión inmediatamente, comience con esta identificación de voz del sistema público:
00a1b221-6137-4b73-ad62-b0cbce134167Úselo para la prueba de conexión inicial, luego reemplácelo con su ID de voz preferido después de que Tavo pueda generar y reproducir audio correctamente.
GET /api/open/v1/voices
Authorization: Bearer YOUR_API_KEYNo confunda los campos de modelo y voz: el modelo selecciona el motor TTS, mientras que Voice ID selecciona el sonido del altavoz.
Paso 3: Agregar una voz API en Tavo
En Tavo, abierto:
More → Voice & Image Generation → Voice API → NewElija TTS Modelo de protocolo OpenAI personalizado y luego ingrese:
| Configuración de Tavo | Valor |
|---|---|
| URL base API | https://fishaudio.org/v1 |
| Clave API | Su clave Fish Audio API |
| Identificación del modelo | fishaudio-s21pro-flash |
| Identificación de voz | 00a1b221-6137-4b73-ad62-b0cbce134167 (reemplazar después de la prueba) |
| Formato de audio | mp3 |
La URL base debe terminar en /v1. No agregue /audio/speech; Tavo agrega la ruta /v1/audio/speech completa cuando envía una solicitud.
Guarde el proveedor. Si Tavo ofrece una prueba de conexión, genere una oración corta y confirme que se reproduce el audio.
Paso 4: Asigna la voz a un personaje
Después de crear la voz API, abra la pantalla de vinculación de voz del personaje de Tavo:
Character Voice Binding → Select Character → Select Your Voice APISi Tavo solicita una ID de voz, ingrese nuevamente la misma ID de voz Fish Audio. Guarde el enlace, vuelva al chat, envíe un mensaje corto e inicie la reproducción de voz.
Puedes asignar una voz Fish Audio diferente a cada personaje. Reutilice la configuración del proveedor y cambie solo la ID de voz en cada enlace de carácter.
Uso de crédito API
Tavo genera voz a través de Fish Audio /v1/audio/speech y consume el saldo de crédito API separado. La conversión de texto a voz comienza en 1 crédito API por carácter efectivo y algunos modelos pueden aplicar un multiplicador.
Compre créditos de precios API y vea el saldo en la administración de API. El costo real de la solicitud se devuelve en X-OpenAPI-Credits-Used.
Solución de problemas y preguntas frecuentes
Tavo informa un fallo de conexión
Confirme que la URL base sea https://fishaudio.org/v1, elimine los espacios en blanco de la clave API y verifique que la cuenta todavía tenga créditos API. No ingrese la contraseña de su cuenta Fish Audio.
La solicitud devuelve 401 o dice que la clave API no es válida
Copie la clave Fish Audio API nuevamente. Si fue revocada, cree una nueva clave y reemplace la credencial anterior almacenada en Tavo.
La solicitud devuelve 402 o dice que el saldo es insuficiente
Su saldo de crédito API es demasiado bajo. Los créditos de membresía y los créditos API son saldos separados, así que compre créditos API en la página de precios de API.
Tavo se conecta pero no reproduce audio
Verifique que el personaje esté vinculado a la voz API y que el ID de voz sea válido. Primero pruebe una oración corta con mp3, luego verifique la configuración de reproducción automática, silencio y reproducción en segundo plano de Tavo.
Tavo dice que el modelo o la voz no es válido
Utilice fishaudio-s21pro-flash como ID de modelo y un ID de voz Fish Audio como voz. Los nombres OpenAI como tts-1 y alloy no se asignan automáticamente a los modelos o voces Fish Audio.
¿Puede cada personaje usar una voz diferente?
Sí. Ingrese el ID de voz Fish Audio correspondiente para cada personaje para darles voces diferentes.