Een respons lezen: wat elk veld betekent en hoe ver je het kunt vertrouwen

Een echt antwoord, toegelicht

Dit is een echt antwoord van POST /v1/voicelab/qa met "round": true en "measureStatus": true. Het bestand is een synthetische stem die je zelf kunt analyseren: https://audiolab.tools/samples/voice/speech-male-plain.mp3.

{
  "durationSec": 32.193,
  "speechRatio": 0.644,
  "longSilences": 2,
  "averageSpeechRmsDb": -30.75,
  "noiseFloorDb": -76.33,
  "signalToNoiseDb": 45.58,
  "clipping": { "count": 0, "severity": "None" },
  "sceneBackground": "unsteady",
  "activeKind": "music",
  "roomEchoScore": 0.223,
  "sibilanceRisk": "Low",
  "measureStatus": {
    "legend": "https://audiolab.tools/docs/start/read-a-response#the-five-statuses",
    "measures": {
      "roomEchoScore": {
        "status": "withdrawn",
        "method": "dsp",
        "lens": "voice.roomEcho"
      },
      "signalToNoiseDb": {
        "status": "validated",
        "basis": "analytic",
        "method": "dsp",
        "lens": "voice.snr",
        "margin": {
          "plusMinus": 6,
          "unit": "dB",
          "note": "Holds for read speech with steady background noise at..."
        }
      },
      "speechRatio": {
        "status": "proxy",
        "method": "dsp",
        "lens": "voice.speechRatio"
      }
    }
  }
}

Een ingekort antwoord: 11 van zijn 50 velden, en 3 van de vermeldingen in measureStatus. De toelichting bij de marge is hier ingekort en staat hieronder voluit.

1. speechRatio 0.644 Proxy

   Het aandeel van de opname waarin de stem luid genoeg is om als spraak te tellen. Het leest ongeveer 12 punten te laag op schone spraak: zachte woordbegins en -einden tellen als pauze.

2. longSilences 2 Proxy

   Pauzes langer dan 1,5 s tussen stukken spraak. Vergelijk vendors op dezelfde tekst.

3. averageSpeechRmsDb -30.75 Gevalideerd

   Hoe luid de stem is terwijl ze spreekt, in dBFS.

4. noiseFloorDb -76.33 Gevalideerd

   Het niveau van het stilste tiende van de opname: de achtergrond.

5. signalToNoiseDb 45.58 Gevalideerd

   Klopt binnen de marge als de werkelijke verhouding 10 tot 30 dB is bij stabiele ruis. Boven ongeveer 50 dB zegt het alleen dat de pauzes heel stil zijn, vaak digitale stilte. Dit voorbeeld ligt ver boven het bereik waarin de marge geldt, dus lees het als "heel schoon", niet als een precies getal.

   Marge ±6 dB. Geldt voor voorgelezen spraak met een stabiele achtergrondruis bij een werkelijke verhouding van 10 tot 30 dB (90 procent van de gevallen). Onder 10 dB leest het te hoog, met 3 dB of meer. Met de K2-detector geldt het vanaf 5 dB voor een stadsplein en voor straatverkeer, en gepoold over keuken, woonkamer, gang en kantine (90e percentiel 4,4 dB bij 5 dB); bij 10 dB is de gepoolde waarde over die vier 6,25 dB en haalt een metro 7,3 dB; bij 0 dB leest het nog steeds ongeveer 6 dB te hoog.

6. clipping { "count": 0, "severity": "None" } Gevalideerd

   Er zijn geen samples afgevlakt.

7. sceneBackground "unsteady" Proxy

   Eén woord voor wat de pauzes vult. Alleen getoetst op synthetische scènes, niet op echte opnames. Op deze schone synthetische stem zegt het "unsteady": lees dat niet als een feit over de ruimte.

8. activeKind "music" Proxy

   Een gok naar het soort geluid. Het zegt "music" voor deze stem: nog een reden om gokken als gokken te behandelen.

9. roomEchoScore 0.223 Ingetrokken

   Geen galmmaat: het volgde gemeten nagalmtijden met Spearman 0,06. Het blijft in het antwoord zodat niets breekt. Hooguit zegt het hoeveel energie er in de pauzes overblijft.

10. sibilanceRisk "Low" Proxy

    Low, Medium of High. Alleen de richting is getoetst: meer energie rond 7 kHz zet het hoger.

Reproduceer het:

curl -s https://audiolab.tools/v1/voicelab/qa \
  -H "Authorization: Bearer $AUDIOLAB_KEY" \
  -H "Content-Type: application/json" \
  -d '{"url":"https://audiolab.tools/samples/voice/speech-male-plain.mp3","round":true,"measureStatus":true}'

Zonder sleutel krijg je een proefperiode van 20 aanroepen per maand, 3 per minuut.

De vijf statussen

Elke maat draagt een van vijf woorden. Het zijn dezelfde woorden en kleuren als op /lenses, in het OpenAPI-document, in de labs en in de measureStatus van een antwoord.

Wat je mag concluderen

Je ziet	Je mag zeggen	Je mag niet zeggen
Gevalideerd, met een marge	Het getal, met zijn marge: “22 dB, plus of min 6”	Dat een verschil tussen twee opnames dat kleiner is dan de marge een echt verschil is
Gevalideerd, zonder marge	Het getal klopt voor wat het meet	Dat het meer betekent dan zijn beschrijving: lees “Wat het niet is” op /lenses
Proxy	”Vendor A laat meer pauzes vallen dan vendor B op dezelfde tekst"	"A praat 64% van de tijd”, “de ruimte is onrustig”
Ingetrokken	Alleen wat de vermelding op /lenses nog steunt	Wat de oude naam beloofde: roomEchoScore is geen ruimtemaat

Een marge is hoe ver het getal ernaast kan zitten. Ze komt uit de norm waartegen de maat is getoetst, of uit onze eigen metingen op echte opnames, en het antwoord zegt voor welke omstandigheden ze geldt.

Waar de getallen vandaan komen

De API, de labs, de MCP-servers en /lenses lezen allemaal dezelfde lijst met maten, dus een status kan nergens verschillen. Als een maat opnieuw is getoetst en verschuift, staat de wijziging in de changelog en toont het antwoord de nieuwe status de volgende keer dat je het vraagt. Hoe wijzigingen worden aangekondigd: wijzigingen en deprecation.