Apunta el proveedor Fish Audio de RikkaHub al endpoint compatible /v1/tts y configura Voice ID y modelo.

Conecta Fish Audio TTS a RikkaHub

En RikkaHub, elige el proveedor de voz Fish Audio y apunta la base API a Fish Audio en lugar de api.fish.audio. Luego configura tu clave API, Voice ID y modelo con /v1/tts.

Después de la configuración, las solicitudes de voz RikkaHub consumen su saldo de crédito Fish Audio API y reproducen audio a través del ID de voz seleccionado.

Lo que necesitas

Una cuenta Fish Audio con créditos API;
Una clave Fish Audio API;
Una identificación de voz Fish Audio (reference_id);
RikkaHub con el proveedor de voz Fish Audio disponible.

Una clave API es una credencial confidencial. No lo compartas en chats, capturas de pantalla o sitios web que no sean de confianza. Cree una clave dedicada para RikkaHub 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 RikkaHub. 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

RikkaHub envía el ID de voz como reference_id. Copie uno de su lista de voces Fish Audio o consulte el API:

GET /api/open/v1/voices
Authorization: Bearer YOUR_API_KEY

Para probar la conexión inmediatamente, comience con esta identificación de voz del sistema público:

00a1b221-6137-4b73-ad62-b0cbce134167

Reemplácelo con su ID de voz preferido después de que RikkaHub pueda generar y reproducir audio correctamente.

No confundas modelo y voz:

El encabezado del modelo selecciona la versión del motor TTS;
reference_id selecciona la voz del hablante.
Lista de voces disponibles
Crear una voz personalizada

Paso 3: Configurar el proveedor Fish Audio en RikkaHub

En RikkaHub, abra la configuración del proveedor Fish Audio / TTS e ingrese:

Configuración RikkaHub	Valor
API Host base/punto final	`https://fishaudio.org`
Punto final completo (si es necesario)	`https://fishaudio.org/v1/tts`
Clave API	Su clave Fish Audio API
Modelo	`s2.1-pro` o `s2.1-pro-flash`
Voz / `reference_id`	`00a1b221-6137-4b73-ad62-b0cbce134167` (reemplazar después de la prueba)
Formato	`mp3`

Utilice cualquier nombre de campo que muestre su compilación RikkaHub. Lo importante es que la solicitud llegue a POST https://fishaudio.org/v1/tts con:

Authorization: Bearer YOUR_API_KEY
model: s2.1-pro
Content-Type: application/json

y un cuerpo JSON que incluye text más un reference_id no vacío.

Si RikkaHub completa previamente https://api.fish.audio, reemplace el host con https://fishaudio.org y conserve /v1/tts.

Guarde el proveedor, genere una oración corta y confirme que RikkaHub puede reproducir el audio devuelto.

Paso 4: Asigne la voz donde sea necesario

Si RikkaHub te permite elegir una voz por personaje, chat o asistente, pega el mismo ID de voz Fish Audio en ese campo. Puede reutilizar la configuración de un proveedor y solo cambiar reference_id por carácter.

Uso de crédito API

RikkaHub llama a Fish Audio /v1/tts y consume el saldo de crédito separado de API. 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. Las respuestas exitosas pueden incluir X-OpenAPI-Credits-Used.

Solución de problemas y preguntas frecuentes

RikkaHub informa un error de conexión

Confirme que el host sea https://fishaudio.org, 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 400 y menciona `reference_id`

Fish Audio requiere una identificación de voz explícita. Introduzca un reference_id válido; el servidor no elegirá silenciosamente una voz predeterminada.

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 almacenada en RikkaHub.

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.

RikkaHub se conecta pero no reproduce audio

Pruebe primero con mp3. Si el cliente solicitó opus, Fish Audio recurre a mp3 para que los reproductores Android comunes puedan decodificar la respuesta. También confirme que la identificación de voz sea válida y que la reproducción automática o la configuración de silencio de RikkaHub no bloqueen la reproducción.

¿Qué modelo debo elegir?

Comience con s2.1-pro o s2.1-pro-flash. Fish Audio asigna estas etiquetas fish.audio a los identificadores del modelo de motor coincidentes. Los identificadores nativos como fishaudio-s21pro-flash también funcionan en el encabezado model.

Guía de configuración de RikkaHub