OpenAI compatível com TTS

Use este endpoint quando um cliente espera o contrato OpenAI POST /v1/audio/speech. Destina-se a integrações como o provedor Custom OpenAI Protocol TTS da Tavo.

Para uma integração nativa do Fish Audio com o contrato de solicitação completo, use Sync HTTP.

Ponto final

POST /v1/audio/speech
Authorization: Bearer YOUR_API_KEY
Content-Type: application/json

URL completo:

https://fishaudio.org/v1/audio/speech

Mantenha a chave API em um servidor confiável ou no campo de credencial API protegido do provedor terceirizado. Crie uma chave separada para cada cliente ou integração para que ela possa ser monitorada e revogada de forma independente.

Solicitar

{
  "model": "fishaudio-s21pro-flash",
  "input": "Hello from Fish Audio.",
  "voice": "00a1b221-6137-4b73-ad62-b0cbce134167",
  "response_format": "mp3",
  "speed": 1
}

Obtenha identificações 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. Use um ID de modelo Fish Audio TTS compatível; Nomes de modelos OpenAI como tts-1 não são apelidos para modelos Fish Audio.

Alguns clientes de terceiros descobrem vozes por meio de uma lista de vozes compatível com OpenAI. Eles podem ligar:

GET /v1/audio/voices
Authorization: Bearer YOUR_API_KEY

Use um valor voices[].id retornado como voice em uma solicitação de fala.

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>

O cliente deve salvar ou reproduzir a resposta de acordo com Content-Type. Os erros são respostas JSON e usam a mesma autenticação, cota e comportamento de geração que o ponto final de sincronização nativo.

Exemplo curl

curl -X POST "https://fishaudio.org/v1/audio/speech" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "fishaudio-s21pro-flash",
    "input": "Hello from Fish Audio.",
    "voice": "00a1b221-6137-4b73-ad62-b0cbce134167",
    "response_format": "mp3",
    "speed": 1
  }' \
  --output speech.mp3

Conecte Tavo

Para configuração de chave API, URL base, modelo, voz e vinculação de caracteres, siga o guia Fish Audio TTS para Tavo dedicado.

Erros