API d'analyse de la voix
L'API Vocametrix apporte à votre application les mesures acoustiques de la voix utilisées en orthophonie : AVQI, ABI, CPP, jitter, shimmer, HNR, DSI, CSID, GNE, H1-H2, formants, rapport S/Z et d'autres. Les mesures principales sont calculées avec Praat 6.4.60 et les mêmes réglages que sur le site Vocametrix : vos valeurs sont celles que voient les cliniciens.
Lire la documentation de l'API →Deux appels
Envoyez un enregistrement pour obtenir un identifiant de fichier, puis demandez une mesure sur cet identifiant. Chaque appel porte votre clé dans l'en-tête X-API-Key. Les fichiers peuvent atteindre 50 Mo.
# 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"Mesures disponibles
La plupart des mesures prennent une voyelle tenue (svFileId) : calculate-cpp, jitter-shimmer, calculate-hnr-multiband (âge et sexe facultatifs), calculate-gne, calculate-h1-h2, calculate-dsi, calculate-formant-statistics, calculate-voice-dynamics et calculate-spectral-advanced. calculate-avqi (versions 02.03 et 03.01) et calculate-abi prennent aussi de la parole enchaînée (csFileId), et calculate-csid uniquement de la parole enchaînée. POST /api/voice-assessment réalise un bilan combiné à partir d'une voyelle et d'un extrait de parole en un seul appel.
Comment les mesures sont calculées
La page méthodes détaille les commandes Praat, les réglages et les références publiées derrière chaque mesure. La réponse jitter-shimmer indique aussi la qualité de l'enregistrement, pour écarter une prise trop courte ou trop bruitée avant de se fier aux valeurs.
Tarifs
Vous payez les secondes d'audio analysées par chaque appel, 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 et assistants
Des clients officiels encapsulent ces appels : npm install vocametrix pour JavaScript et TypeScript, pip install vocametrix pour Python. Les mesures sont aussi accessibles à Claude et à d'autres assistants via le serveur MCP Vocametrix.
Voir aussi
Notez la prononciation par rapport à un texte de référence avec la même clé, ou utilisez les mesures sans code sur le site.
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.
Faut-il installer Praat ?
Non. Praat tourne sur le serveur Vocametrix ; vous envoyez seulement de l'audio et lisez du JSON.
L'abonnement au site donne-t-il accès à l'API ?
Non. L'abonnement au site et les packs de crédits API sont deux produits distincts.