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/jsonURL completo:
https://fishaudio.org/v1/audio/speechMantenha 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
}| Campo | Tipo | Obrigatório | Notas |
|---|---|---|---|
model | corda | Sim | ID do modelo do mecanismo Kitta Audio, como fishaudio-s21pro-flash |
input | corda | Sim | Texto para sintetizar |
voice | string ou objeto | Sim | String de identificação de voz ou um objeto como { "id": "00a1b221-6137-4b73-ad62-b0cbce134167" } |
response_format | corda | Não | mp3, wav ou pcm; o padrão é mp3 |
speed | número | Não | Velocidade 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_KEYUse 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.mp3Conecte 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
| Estado | Significado | Ação |
|---|---|---|
400 | Entrada, voz, modelo, formato ou velocidade inválidos | Corrija a solicitação antes de tentar novamente |
401 | A chave API está ausente ou é inválida | Verifique ou substitua a chave de integração |
402 | A cota API é insuficiente | Adicione cota antes de gerar mais áudio |
429 | Limite de taxa de solicitação excedido | Tentar novamente com espera exponencial |
500 | Falha na geração de TTS | Tente novamente apenas com reconhecimento de cobrança duplicada |