Vocametrix Plattform öffnen →

API zur Aussprachebewertung

Senden Sie eine Aufnahme und den Text, den die Person sagen sollte; Sie erhalten zurück, wie gut jedes Wort und jedes Phonem ausgesprochen wurde. Die API nutzt die Aussprachebewertung von Azure AI Speech auf Phonemebene, mit Prosodie und Erkennung von Abweichungen vom Text: kein Azure-Abonnement zu verwalten, keine Audiokonvertierung, kein Zerlegen langer Aufnahmen.

API-Dokumentation lesen →

Drei Aufrufe

Fordern Sie eine Upload-URL an, laden Sie die WAV-Datei dorthin hoch und fordern Sie dann die Bewertung an. Jeder Aufruf trägt Ihren Schlüssel im Header X-API-Key. Das Audio wird nach der Bewertung gelöscht.

# 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\"}"

Was zurückkommt

Werte von 0 bis 100 für Genauigkeit (Nähe der Phoneme zu einer Muttersprachlerin oder einem Muttersprachler), Flüssigkeit (Pausen zwischen Wörtern), Vollständigkeit (gesprochener Anteil des Referenztexts) und eine Gesamtbewertung der Aussprache, mit demselben Detail für jedes Wort und jedes Phonem. Jedes Wort trägt außerdem einen Fehlertyp: Auslassung, Einfügung, Fehlaussprache, unerwartete Pause, fehlende Pause oder monotone Intonation. Die Antwort folgt dem JSON-Format von Azure.

Sprachen und Aufnahmedauer

Das Feld locale akzeptiert jede Sprache, die die Azure-Aussprachebewertung unterstützt, etwa de-DE, en-US, en-GB, fr-FR, es-ES oder pt-BR. Die Prosodiebewertung (Betonung, Intonation, Rhythmus) gibt es nur für en-US. Aufnahmen über 30 Sekunden werden abschnittsweise bewertet; die Antwort enthält dann die Gesamtwerte und einen Wert pro Wort, ohne Phonemdetail.

Preise

Sie zahlen die gesendeten Sekunden Audio, 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

Offizielle Clients kapseln dieselben Aufrufe: npm install vocametrix für JavaScript und TypeScript, pip install vocametrix für Python.

Auch die Stimme messen

Derselbe Schlüssel öffnet die akustischen Stimmmaße: AVQI, CPP, Jitter, Shimmer, HNR und weitere.

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.

Wo finde ich meinen API-Schlüssel?

Auf Ihrer Profilseite, sobald Sie bei Vocametrix angemeldet sind.

Wird die Aufnahme gespeichert?

Nein. Die hochgeladene Datei wird gelöscht, sobald die Bewertung zurückgegeben wurde.

API-Dokumentation lesen →