Kitta Audio Docs
Referência APITexto para fala
Back to site

OpenAI Compatível com TTS

Conecte Tavo e outros clientes de fala compatíveis com OpenAI ao Kitta Audio TTS.

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 Kitta 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 Kitta Audio.",
  "voice": "00a1b221-6137-4b73-ad62-b0cbce134167",
  "response_format": "mp3",
  "speed": 1
}
CampoTipoObrigatórioNotas
modelcordaSimID do modelo do mecanismo Kitta Audio, como fishaudio-s21pro-flash
inputcordaSimTexto para sintetizar
voicestring ou objetoSimString de identificação de voz ou um objeto como { "id": "00a1b221-6137-4b73-ad62-b0cbce134167" }
response_formatcordaNãomp3, wav ou pcm; o padrão é mp3
speednúmeroNãoVelocidade de fala de 0.5 a 2; o padrão é 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 Kitta Audio TTS compatível; Nomes de modelos OpenAI como tts-1 não são apelidos para modelos Kitta 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 Kitta 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 Kitta Audio TTS para Tavo dedicado.

Erros

EstadoSignificadoAção
400Entrada, voz, modelo, formato ou velocidade inválidosCorrija a solicitação antes de tentar novamente
401A chave API está ausente ou é inválidaVerifique ou substitua a chave de integração
402A cota API é insuficienteAdicione cota antes de gerar mais áudio
429Limite de taxa de solicitação excedidoTentar novamente com espera exponencial
500Falha na geração de TTSTente novamente apenas com reconhecimento de cobrança duplicada