API-docs
Dit is een samenvatting. De volledige referentie, met elk veld, elke vlag en elke foutcode, staat in het Engels.
In het kort
| Basis-URL | https://api.mnemecho.com/api/v1 |
|---|---|
| Authenticatie | Authorization: Bearer <sleutel> of X-API-Key: <sleutel> |
| Beoordelen | POST /score met het formulierveld text (1 tot 12 woorden) en het bestand audio (wav, flac, ogg of mp3, maximaal 15 seconden en 4 MB) |
| Sleutel en limieten | GET /health |
| Bereikbaar? | GET /status, zonder sleutel |
curl -X POST https://api.mnemecho.com/api/v1/score \
-H "Authorization: Bearer $MNEMECHO_KEY" \
-F "text=In februari is het Valentijnsdag." \
-F "audio=@attempt.wav"Wat je terugkrijgt
score: 0 tot 100, afgezet tegen moedertaalsprekers. 90 en hoger klinkt als een moedertaalspreker.verdict:excellent(95 en hoger),pass(75 tot 94,9),marginal_fail(55 tot 74,9) ofhard_fail(onder 55).words: per woord of het goed was, of er een ander woord werd gezegd (wrong_word), en per klank wat verwacht werd, wat klonk, en een tip in het Engels.worst_word: het woord om eerst aan te werken.flags: opmerkingen over de poging.
Wat wordt beoordeeld
Alleen de uitspraak: of elke verwachte klank gezegd werd, en goed, en of elk woord het woord uit de tekst is. Ritme, toonhoogte en klinkerlengte worden hier niet beoordeeld, want daarvoor is een opname van een moedertaalspreker van dezelfde zin nodig. Stemklank wordt nooit beoordeeld.
Privacy
Audio en tekst worden in het geheugen beoordeeld en weggegooid, nooit opgeslagen.