Aponte o provedor Fish Audio do RikkaHub para o endpoint compatível /v1/tts e defina Voice ID e modelo.

Conecte Fish Audio TTS a RikkaHub

No RikkaHub, escolha o provedor de voz Fish Audio e aponte a base da API para Fish Audio em vez de api.fish.audio. Em seguida, configure sua chave API, Voice ID e modelo em /v1/tts.

Após a configuração, as solicitações de voz RikkaHub consomem seu saldo de créditos Fish Audio API e reproduzem áudio por meio do ID de voz selecionado.

O que você precisa

Uma conta Fish Audio com créditos API;
Uma chave Fish Audio API;
Um ID de voz Fish Audio (reference_id);
RikkaHub com o provedor de voz Fish Audio disponível.

Uma chave API é uma credencial confidencial. Não compartilhe em bate-papos, capturas de tela ou sites não confiáveis. Crie uma chave dedicada para RikkaHub para que você possa monitorá-la ou revogá-la separadamente.

Etapa 1: Crie uma chave Fish Audio API

Faça login em Fish Audio, abra o gerenciamento API e crie uma chave para RikkaHub. Copie e armazene-o imediatamente porque a chave completa só pode ser mostrada uma vez.

Etapa 2: Encontre um ID de voz

RikkaHub envia o ID de voz como reference_id. Copie um da sua lista de vozes Fish Audio ou consulte o API:

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

Para testar a conexão imediatamente, comece com este ID de voz do sistema público:

00a1b221-6137-4b73-ad62-b0cbce134167

Substitua-o pelo seu ID de voz preferido depois que RikkaHub puder gerar e reproduzir áudio com sucesso.

Não confunda modelo e voz:

O cabeçalho do modelo seleciona a versão do motor TTS;
reference_id seleciona a voz do locutor.
Listar vozes disponíveis
Crie uma voz personalizada

Etapa 3: Configurar o provedor Fish Audio em RikkaHub

Em RikkaHub, abra as configurações do provedor Fish Audio / TTS e digite:

Configuração RikkaHub	Valor
API Host base/endpoint	`https://fishaudio.org`
Ponto final completo (se necessário)	`https://fishaudio.org/v1/tts`
Chave API	Sua chave Fish Audio API
Modelo	`s2.1-pro` ou `s2.1-pro-flash`
Voz / `reference_id`	`00a1b221-6137-4b73-ad62-b0cbce134167` (substituir após teste)
Formato	`mp3`

Use os nomes de campo que sua compilação RikkaHub mostrar. O importante é que a solicitação chegue a POST https://fishaudio.org/v1/tts com:

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

e um corpo JSON que inclui text mais um reference_id não vazio.

Se RikkaHub preencher previamente https://api.fish.audio, substitua o host por https://fishaudio.org e mantenha /v1/tts.

Salve o provedor, gere uma frase curta e confirme se RikkaHub pode reproduzir o áudio retornado.

Etapa 4: atribua a voz onde necessário

Se RikkaHub permitir que você escolha uma voz por personagem, chat ou assistente, cole o mesmo ID de voz Fish Audio nesse campo. Você pode reutilizar uma configuração de provedor e alterar apenas reference_id por caractere.

Uso de crédito API

RikkaHub chama Fish Audio /v1/tts e consome o saldo de crédito API separado. A conversão de texto em fala começa com 1 crédito API por caractere efetivo e alguns modelos podem aplicar um multiplicador.

Compre créditos em preço API e visualize o saldo no gerenciamento API. As respostas bem-sucedidas podem incluir X-OpenAPI-Credits-Used.

Solução de problemas e perguntas frequentes

RikkaHub relata uma falha de conexão

Confirme se o host é https://fishaudio.org, remova os espaços em branco da chave API e verifique se a conta ainda possui créditos API. Não insira a senha da sua conta Fish Audio.

A solicitação retorna 400 e menciona `reference_id`

Fish Audio requer um ID de voz explícito. Insira um reference_id válido; o servidor não escolherá silenciosamente uma voz padrão.

A solicitação retorna 401 ou diz que a chave API é inválida

Copie a chave Fish Audio API novamente. Caso tenha sido revogada, crie uma nova chave e substitua a credencial armazenada em RikkaHub.

A solicitação retorna 402 ou diz que o saldo é insuficiente

Seu saldo de crédito API está muito baixo. Os créditos de associação e os créditos API são saldos separados, portanto, compre créditos API na página de preços API.

RikkaHub conecta mas não reproduz áudio

Teste primeiro com mp3. Se o cliente solicitou opus, Fish Audio volta para mp3 para que jogadores Android comuns possam decodificar a resposta. Confirme também se o ID de voz é válido e se as configurações de reprodução automática ou mudo do RikkaHub não estão bloqueando a reprodução.

Qual modelo devo escolher?

Comece com s2.1-pro ou s2.1-pro-flash. Fish Audio mapeia esses rótulos fish.audio para os ids de modelo de mecanismo correspondentes. IDs nativos como fishaudio-s21pro-flash também funcionam no cabeçalho model.

Guia de configuração do RikkaHub