API de evaluación de la pronunciación
Envíe una grabación y el texto que la persona debía decir; reciba la calidad de pronunciación de cada palabra y cada fonema. La API usa la evaluación de la pronunciación de Azure AI Speech a nivel de fonema, con la prosodia y la detección de desviaciones del texto activadas: sin suscripción de Azure que gestionar, sin conversión de audio y sin dividir las grabaciones largas.
Leer la documentación de la API →Tres llamadas
Pida una URL de subida, suba allí el archivo WAV y luego pida la evaluación. Cada llamada lleva su clave en la cabecera X-API-Key. El audio se elimina una vez puntuado.
# 1. Ask for an upload URL
curl -X POST https://platform.vocametrix.com/api/get-blob-url \
-H "X-API-Key: $VOCAMETRIX_API_KEY"
# {"uploadURL": "...", "blobURL": "..."}
# 2. Upload the recording
curl -X PUT "$UPLOAD_URL" -H "x-ms-blob-type: BlockBlob" --data-binary @reading.wav
# 3. Score it against the reference text
curl -X POST https://platform.vocametrix.com/api/pronunciation-assessment \
-H "X-API-Key: $VOCAMETRIX_API_KEY" -H "Content-Type: application/json" \
-d "{\"blobURL\": \"$BLOB_URL\", \"referenceText\": \"The weather is nice today\", \"locale\": \"en-US\"}"Qué devuelve
Puntuaciones de 0 a 100 de precisión (cercanía de los fonemas a un hablante nativo), fluidez (pausas entre palabras), integridad (parte del texto de referencia pronunciada) y una puntuación global de pronunciación, con el mismo detalle por palabra y por fonema. Cada palabra indica además un tipo de error: omisión, inserción, mala pronunciación, pausa inesperada, pausa ausente o entonación monótona. La respuesta sigue el formato JSON de Azure.
Idiomas y duración de las grabaciones
El campo locale acepta cualquier idioma compatible con la evaluación de la pronunciación de Azure, por ejemplo es-ES, es-MX, en-US, fr-FR, de-DE o pt-BR. La puntuación de prosodia (acento, entonación, ritmo) solo existe en en-US. Las grabaciones de más de 30 segundos se puntúan por segmentos; la respuesta da entonces las puntuaciones globales y una por palabra, sin el detalle por fonema.
Precios
Paga los segundos de audio que envía, 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
Los clientes oficiales envuelven estas llamadas: npm install vocametrix para JavaScript y TypeScript, pip install vocametrix para Python.
Medir también la voz
La misma clave da acceso a las medidas acústicas de la voz: AVQI, CPP, jitter, shimmer, HNR y más.
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.
¿Dónde encuentro mi clave de API?
En su página de perfil, una vez que haya iniciado sesión en Vocametrix.
¿Se conserva la grabación?
No. El archivo subido se elimina en cuanto se devuelve la evaluación.