OpenAI-Compatible con TTS

Utilice este punto final cuando un cliente espere el contrato OpenAI POST /v1/audio/speech. Está destinado a integraciones como el proveedor Protocolo OpenAI personalizado TTS de Tavo.

Para una integración nativa de Kitta Audio con el contrato de solicitud completo, utilice Sync HTTP.

Punto final

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

URL completa:

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

Mantenga la clave API en un servidor confiable o en el campo de credencial API protegido del proveedor externo. Cree una clave separada para cada cliente o integración para que pueda monitorearse y revocarse de forma independiente.

Pedido

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

Campo	Tipo	Requerido	Notas
`model`	cadena	Sí	ID del modelo de motor Kitta Audio, como `fishaudio-s21pro-flash`
`input`	cadena	Sí	Texto a sintetizar
`voice`	cadena u objeto	Sí	Cadena de identificación de voz o un objeto como `{ "id": "00a1b221-6137-4b73-ad62-b0cbce134167" }`
`response_format`	cadena	No	`mp3`, `wav` o `pcm`; por defecto es `mp3`
`speed`	número	No	Velocidad de conversación de `0.5` a `2`; por defecto es `1`

Obtenga identificaciones de voz de GET /api/open/v1/voices. Para una prueba de conexión rápida, utilice la voz del sistema público 00a1b221-6137-4b73-ad62-b0cbce134167. Utilice una identificación de modelo Kitta Audio TTS compatible; Los nombres de modelos OpenAI, como tts-1, no son alias para los modelos Kitta Audio.

Algunos clientes de terceros descubren voces a través de una lista de voces compatible con OpenAI. Pueden llamar:

GET /v1/audio/voices
Authorization: Bearer YOUR_API_KEY

Utilice un valor voices[].id devuelto como voice en una solicitud de voz.

Respuesta

Una solicitud exitosa devuelve audio binario:

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

<binary audio data>

El cliente debe guardar o reproducir la respuesta según Content-Type. Los errores son respuestas JSON y utilizan el mismo comportamiento de autenticación, cuota y generación que el punto final de sincronización nativo.

Ejemplo 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

Conecta Tavo

Para configurar la clave API, la URL base, el modelo, la voz y el enlace de caracteres, siga la [Kitta Audio TTS para la guía Tavo] dedicada (/es/docs/integration-guides/third-party/tavo).

Errores

Estado	Significado	Acción
`400`	Entrada, voz, modelo, formato o velocidad no válidos	Corrija la solicitud antes de volver a intentarlo
`401`	Falta la clave API o no es válida	Verifique o reemplace la clave de integración
`402`	La cuota API es insuficiente	Añade cuota antes de generar más audio
`429`	Se superó el límite de tasa de solicitud	Reintentar con retroceso exponencial
`500`	Error en la generación de TTS	Reintentar sólo con reconocimiento de cargos duplicados

Compatible con OpenAI TTS