Voice Quality Metrics

Calculate AVQI metrics from connected speech and sustained vowel audio recordings

get/api/calculate-avqi

Request

  • Base URL: https://platform.vocametrix.com
  • URL: https://platform.vocametrix.com/api/calculate-avqi
  • Auth: API key in header X-API-Key

Query parameters

csFileIdstring required

ID of the connected speech audio file (previously uploaded) - REQUIRED

svFileIdstring required

ID of the sustained vowel audio file (previously uploaded) - REQUIRED

versionstring required

AVQI algorithm version: "v02.03" or "v03.01" - REQUIRED

Response

Successful response

AVQInumber

Acoustic Voice Quality Index - final composite score (0-10 scale, dimensionless). Values above the language-specific cut-off indicate probable dysphonia; to our knowledge, no validated severity bands exist

CPPSstring

Smoothed Cepstral Peak Prominence measuring harmonic structure (dB). Higher values indicate better periodicity and voice quality

HNRstring

Mean Harmonics-to-Noise Ratio across concatenated CS+SV signal (dB). Higher values indicate less noise relative to harmonic content

Shimmernumber

Period-to-period amplitude variation expressed as percentage (%). Lower values indicate more stable amplitude control

Shimmer_dBstring

Period-to-period amplitude variation in logarithmic scale (dB). Lower values indicate better amplitude stability

LTAS_slopenumber

Spectral slope between 0-1kHz and 1-10kHz frequency ranges (dB). More negative values indicate steeper spectral roll-off

LTAS_tiltstring

Spectral tilt of trend line through long-term average spectrum 1-10kHz (dB). Indicates overall spectral balance and voice quality

Changes

No recorded changes to this operation across all 1 revision of this API.