API d'évaluation de la prononciation
Envoyez un enregistrement et le texte que la personne devait dire ; recevez la qualité de prononciation de chaque mot et de chaque phonème. L'API utilise l'évaluation de la prononciation d'Azure AI Speech, au niveau du phonème, avec la prosodie et la détection des écarts au texte activées : pas d'abonnement Azure à gérer, ni de conversion audio, ni de découpage des longs enregistrements.
Lire la documentation de l'API →Trois appels
Demandez une URL d'envoi, déposez-y le fichier WAV, puis demandez l'évaluation. Chaque appel porte votre clé dans l'en-tête X-API-Key. L'audio est supprimé une fois noté.
# 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\"}"Ce que renvoie l'API
Des scores de 0 à 100 pour la précision (proximité des phonèmes avec un locuteur natif), la fluidité (pauses entre les mots), la complétude (part du texte de référence prononcée) et un score global de prononciation, avec le même détail pour chaque mot et chaque phonème. Chaque mot porte aussi un type d'erreur : omission, insertion, mauvaise prononciation, pause inattendue, pause manquante ou intonation monotone. La réponse suit le format JSON d'Azure.
Langues et durée des enregistrements
Le champ locale accepte toute langue prise en charge par l'évaluation de la prononciation d'Azure, par exemple fr-FR, en-US, en-GB, es-ES, de-DE ou pt-BR. Le score de prosodie (accentuation, intonation, rythme) n'existe qu'en en-US. Au-delà de 30 secondes, l'enregistrement est noté par segments ; la réponse donne alors les scores globaux et un score par mot, sans le détail par phonème.
Tarifs
Vous payez les secondes d'audio envoyées, sans arrondi. Les crédits s'achètent en packs uniques, pas en abonnement : Developer Pack 40min à 5 EUR et Developer Pack 400min à 15 EUR. La création du compte est gratuite, mais l'API n'a pas d'offre gratuite : le premier appel demande déjà un pack.
SDK
Des clients officiels encapsulent ces appels : npm install vocametrix pour JavaScript et TypeScript, pip install vocametrix pour Python.
Mesurer aussi la voix
La même clé donne accès aux mesures acoustiques de la voix : AVQI, CPP, jitter, shimmer, HNR et d'autres.
Questions fréquentes
Existe-t-il une offre gratuite ?
Non. Le compte est gratuit et le site s'accompagne d'un essai de 7 jours, mais les appels à l'API sont payés sur un pack de crédits dès le premier.
Où trouver ma clé d'API ?
Sur votre page de profil, une fois connecté à Vocametrix.
L'enregistrement est-il conservé ?
Non. Le fichier envoyé est supprimé dès que l'évaluation a été renvoyée.