API Referencia
Referencia del punto final Kitta Audio Open API.
API Referencia
Kitta Audio Open API es la interfaz del lado del servidor para flujos de trabajo de producción de audio. Úselo cuando su producto necesite texto a voz, voz a texto, administración de voz o automatización de sincronización de labios sin depender de la consola web.
URL básica:
https://kittaai.com/api/open/v1Autenticación:
Authorization: Bearer KITTA_API_KEYEsquema legible por máquina:
GET /api/openapi.jsonSuperficies públicas actuales
| Superficie | Estado actual de API en el extranjero | Documentos |
|---|---|---|
| Perfil | Punto final público v1 para verificaciones de cuentas, niveles, créditos y cuotas | Perfil |
| Texto a voz | Sincronización pública HTTP y puntos finales de trabajos asíncronos | Sincronización HTTP, Trabajos asíncronos |
| En tiempo real TTS | La disponibilidad está controlada por la cuenta y el lanzamiento del producto | TTS en tiempo real |
| Voz a Texto | Punto final de transcripción público HTTP | Voz a texto |
| En tiempo real ASR | La disponibilidad está controlada por la cuenta y el lanzamiento del producto | ASR en tiempo real |
| Imágenes | Página de capacidad del producto; la disponibilidad de los puntos finales públicos está basada en esquemas | Imágenes |
| Vídeos | Página de capacidad del producto; la disponibilidad de los puntos finales públicos está basada en esquemas | Vídeos |
| Gestión de voz | Abra los puntos finales API para enumerar, crear y eliminar modelos de voz | Gestión de voz |
| Sincronización de labios | Puntos finales de trabajos asíncronos públicos para flujos de trabajo de audio y vídeo de origen | Sincronización de labios |
| Uso | Orientación sobre el uso de la cuenta; utilizar perfil hoy y esquema para nuevos puntos finales de uso | Uso |
Solicitar modelo
Todas las solicitudes deben realizarse desde su servidor. Los clientes del navegador y las aplicaciones móviles deben llamar primero a su propio backend, luego su backend llama a Open API con la clave API.
curl https://kittaai.com/api/open/v1/profile \
-H "Authorization: Bearer KITTA_API_KEY"Utilice JSON para la mayoría de los puntos finales. La creación de voz puede utilizar datos de formularios de varias partes cuando el proveedor habilitado requiere audio de referencia. La sincronización TTS utiliza respuestas de audio binarias cuando solicita audio directo en lugar de metadatos almacenados en caché.
Modelo de respuesta
Las respuestas exitosas son específicas de cada punto final. Los puntos finales asíncronos devuelven objetos de trabajo o tarea que su aplicación debe sondear hasta que se alcance el estado de una terminal. Los puntos finales de medios de sincronización pueden devolver datos binarios o metadatos JSON según las opciones de solicitud.
Los errores utilizan un cuerpo JSON:
{
"code": "invalid_request",
"message": "The request payload is invalid.",
"requestId": "req_xxx"
}Registre requestId cuando esté presente. Es la forma más rápida de que el soporte rastree una solicitud fallida.
Facturación y créditos
Las llamadas abiertas API consumen créditos de cuenta o cuota API según el terminal y el modelo habilitado. Algunos puntos finales cobran cuando se acepta una tarea; otros cobran cuando la generación de medios tiene éxito. Su integración debe mostrar un estado de reintento claro y no debe asumir que cada solicitud fallida cuesta créditos.
Para flujos de trabajo sensibles al equilibrio, llame a Perfil antes de iniciar lotes grandes y después de completar trabajos importantes. Los trabajos de ejecución prolongada también deben conservar la identificación de la tarea devuelta para que pueda recuperarse de los reinicios del cliente sin crear trabajo duplicado.
Compatibilidad
Las rutas Legacy Open API permanecen disponibles durante la ventana de compatibilidad, pero las nuevas integraciones deben usar /api/open/v1. La guía de migración enumera los reemplazos de rutas conocidas y el orden de implementación.
Los médicos extranjeros utilizan intencionalmente sus propios caminos actuales. Si está integrando el sitio global, siga las rutas en https://kittaai.com/api/open/v1 y confirme nuevas superficies con GET /api/openapi.json.