TTS compatível com Fish Audio

Use esse ponto de extremidade quando um cliente codificar o formato de solicitação fish.audio POST /v1/tts. Ele mapeia essa carga útil no pipeline Fish Audio Open TTS enquanto mantém a autenticação, a cota e o faturamento da chave API em sua conta Fish Audio.

Para uma integração Open API nativa, prefira Sync HTTP. Para clientes OpenAI POST /v1/audio/speech, use OpenAI compatível com TTS.

Ponto final

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

URL completo:

https://fishaudio.org/v1/tts

Se o aplicativo de terceiros solicitar uma base Fish Audio API, como https://api.fish.audio, defina-a como https://fishaudio.org e deixe o caminho como /v1/tts.

Mantenha a chave API no campo de credencial protegida do cliente. Crie uma chave dedicada para cada aplicativo para que você possa monitorá-la ou revogá-la de forma independente.

Solicitar

{
  "text": "Hello from Fish Audio.",
  "reference_id": "00a1b221-6137-4b73-ad62-b0cbce134167",
  "format": "mp3",
  "temperature": 0.7,
  "top_p": 0.7,
  "normalize": true,
  "prosody": {
    "speed": 1
  }
}

Mapeamento de cabeçalho do modelo

Valores de cabeçalho desconhecidos são ignorados e o mecanismo padrão do servidor é aplicado. Você também pode enviar um ID de mecanismo nativo, como fishaudio-s21pro-flash, no cabeçalho.

Obtenha IDs de voz de GET /api/open/v1/voices. Para um teste rápido de conexão, use a voz do sistema público 00a1b221-6137-4b73-ad62-b0cbce134167.

Resposta

Uma solicitação bem-sucedida retorna áudio binário:

HTTP/1.1 200 OK
Content-Type: audio/mpeg
X-OpenAPI-Quota-Remaining: 987988
X-OpenAPI-Credits-Used: 12

<binary audio data>

Os erros são JSON e compartilham autenticação, cota e comportamento de geração com Sincronizar HTTP.

Exemplo curl

curl -X POST "https://fishaudio.org/v1/tts" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -H "model: s2.1-pro" \
  -d '{
    "text": "Hello from Fish Audio.",
    "reference_id": "00a1b221-6137-4b73-ad62-b0cbce134167",
    "format": "mp3",
    "prosody": { "speed": 1 }
  }' \
  --output speech.mp3

Conecte RikkaHub

Para chave API, URL base, modelo e configuração de voz em RikkaHub, siga o [guia de configuração RikkaHub] dedicado (/pt/docs/integration-guides/third-party/rikkahub).

Erros