API de análisis de voz
La API de Vocametrix lleva a su aplicación las medidas acústicas de la voz que usan los logopedas: AVQI, ABI, CPP, jitter, shimmer, HNR, DSI, CSID, GNE, H1-H2, formantes, cociente S/Z y más. Las medidas principales se calculan con Praat 6.4.60 y los mismos ajustes que en el sitio de Vocametrix, así que sus valores coinciden con los que ven los clínicos.
Leer la documentación de la API →Dos llamadas
Suba una grabación para obtener un identificador de archivo y luego pida una medida sobre ese identificador. Cada llamada lleva su clave en la cabecera X-API-Key. Los archivos pueden tener hasta 50 MB.
# 1. Upload a sustained vowel
curl -X POST https://platform.vocametrix.com/api/assignFileId \
-H "X-API-Key: $VOCAMETRIX_API_KEY" -F "audio=@vowel_a.wav"
# {"fileId": "..."}
# 2. Compute jitter and shimmer on it
curl "https://platform.vocametrix.com/api/jitter-shimmer?svFileId=$FILE_ID" \
-H "X-API-Key: $VOCAMETRIX_API_KEY"Medidas disponibles
La mayoría de las medidas usan una vocal sostenida (svFileId): calculate-cpp, jitter-shimmer, calculate-hnr-multiband (con edad y sexo opcionales), calculate-gne, calculate-h1-h2, calculate-dsi, calculate-formant-statistics, calculate-voice-dynamics y calculate-spectral-advanced. calculate-avqi (versiones 02.03 y 03.01) y calculate-abi usan también habla continua (csFileId), y calculate-csid solo habla continua. POST /api/voice-assessment realiza una evaluación combinada a partir de una vocal y una muestra de habla en una sola llamada.
Cómo se calculan las medidas
La página de métodos detalla los comandos de Praat, los ajustes y las referencias publicadas detrás de cada medida. La respuesta de jitter-shimmer indica también la calidad de la grabación, para descartar una toma demasiado corta o ruidosa antes de fiarse de los valores.
Precios
Paga los segundos de audio que analiza cada llamada, sin redondeo. Los créditos se compran en paquetes únicos, no por suscripción: Developer Pack 40min a 5 EUR y Developer Pack 400min a 15 EUR. Crear la cuenta es gratis, pero la API no tiene nivel gratuito: la primera llamada ya requiere un paquete.
SDK y asistentes
Los clientes oficiales envuelven estas llamadas: npm install vocametrix para JavaScript y TypeScript, pip install vocametrix para Python. Las medidas también están disponibles para Claude y otros asistentes a través del servidor MCP de Vocametrix.
Ver también
Puntúe la pronunciación frente a un texto de referencia con la misma clave, o use las medidas sin código en el sitio.
Preguntas frecuentes
¿Hay un nivel gratuito?
No. La cuenta es gratuita y el sitio incluye una prueba de 7 días, pero las llamadas a la API se pagan con un paquete de créditos desde la primera.
¿Hay que instalar Praat?
No. Praat se ejecuta en el servidor de Vocametrix; usted solo envía audio y lee JSON.
¿La suscripción al sitio incluye la API?
No. La suscripción al sitio y los paquetes de créditos de la API son productos distintos.