Stimmanalyse-API
Die Vocametrix-API bringt die akustischen Stimmmaße der Logopädie in Ihre Anwendung: AVQI, ABI, CPP, Jitter, Shimmer, HNR, DSI, CSID, GNE, H1-H2, Formanten, den S/Z-Quotienten und mehr. Die zentralen Maße werden mit Praat 6.4.60 und denselben Einstellungen wie auf der Vocametrix-Website berechnet, sodass Ihre Werte mit denen übereinstimmen, die Fachleute dort sehen.
API-Dokumentation lesen →Zwei Aufrufe
Laden Sie eine Aufnahme hoch, um eine Datei-ID zu erhalten, und fordern Sie dann ein Maß für diese ID an. Jeder Aufruf trägt Ihren Schlüssel im Header X-API-Key. Dateien dürfen bis zu 50 MB groß sein.
# 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"Verfügbare Maße
Die meisten Maße verwenden einen gehaltenen Vokal (svFileId): calculate-cpp, jitter-shimmer, calculate-hnr-multiband (mit optionalem Alter und Geschlecht), calculate-gne, calculate-h1-h2, calculate-dsi, calculate-formant-statistics, calculate-voice-dynamics und calculate-spectral-advanced. calculate-avqi (Versionen 02.03 und 03.01) und calculate-abi verwenden zusätzlich Spontansprache bzw. Lesetext (csFileId), calculate-csid nur diese. POST /api/voice-assessment führt eine kombinierte Bewertung aus Vokal und Sprachprobe in einem Aufruf durch.
Wie die Maße berechnet werden
Die Methodenseite nennt die Praat-Befehle, die Einstellungen und die veröffentlichten Referenzen hinter jedem Maß. Die Jitter-Shimmer-Antwort meldet außerdem die Aufnahmequalität, damit Sie eine zu kurze oder zu verrauschte Aufnahme verwerfen können, bevor Sie den Werten trauen.
Preise
Sie zahlen die Sekunden Audio, die jeder Aufruf analysiert, ohne Aufrundung. Guthaben gibt es als einmalige Pakete, nicht als Abonnement: Developer Pack 40min für 5 EUR und Developer Pack 400min für 15 EUR. Das Konto ist kostenlos, die API hat aber keine Gratisstufe: Schon der erste Aufruf braucht ein Paket.
SDKs und Assistenten
Offizielle Clients kapseln dieselben Aufrufe: npm install vocametrix für JavaScript und TypeScript, pip install vocametrix für Python. Die Maße stehen auch Claude und anderen Assistenten über den Vocametrix-MCP-Server zur Verfügung.
Siehe auch
Bewerten Sie mit demselben Schlüssel die Aussprache gegen einen Referenztext, oder nutzen Sie die Maße ohne Code auf der Website.
Häufige Fragen
Gibt es eine Gratisstufe?
Nein. Das Konto ist kostenlos und die Website hat eine 7-tägige Testphase, aber API-Aufrufe werden ab dem ersten aus einem Guthabenpaket bezahlt.
Muss ich Praat installieren?
Nein. Praat läuft auf dem Vocametrix-Server; Sie senden nur Audio und lesen JSON.
Enthält das Website-Abonnement den API-Zugang?
Nein. Website-Abonnement und API-Guthabenpakete sind getrennte Produkte.