Advanced Voice Analysis

Calculate advanced spectral measures with age and gender-specific clinical interpretation

get/api/calculate-spectral-advanced

Request

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

Query parameters

svFileIdstring required

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

ageinteger required

Patient age in years (integer) - REQUIRED for age-specific adjustments

gender1 | 2 | 3 required

Patient gender: 1=Male, 2=Female, 3=Other/Unknown (integer) - REQUIRED

versionstring

Spectral analysis algorithm version (default: "v01") - OPTIONAL

Response

Successful response

SPECTRAL_MEANnumber

Weighted average frequency (center of gravity) in Hz. Example: 1847.3

SPECTRAL_SDnumber

Standard deviation of spectral distribution in Hz. Example: 623.8

SPECTRAL_SKEWNESSnumber

Third moment indicating spectral asymmetry. Example: 0.85

SPECTRAL_KURTOSISnumber

Fourth moment indicating spectral peakedness. Example: 2.34

ALPHA_RATIOnumber

Energy ratio below/above 1 kHz in dB. Example: 4.2

L1_L0number

First formant to fundamental energy difference in dB. Example: -8.5

H1_H2number

First to second harmonic amplitude difference in dB. Example: 3.8

H1_A1number

First harmonic to first formant amplitude difference in dB. Example: -5.2

H1_A3number

First harmonic to third formant amplitude difference in dB. Example: -15.7

SPECTRAL_FLUXnumber

Rate of spectral change in Hz. Example: 234.6

LTAS_SLOPEnumber

Spectral slope 0-1 kHz vs 1-4 kHz in dB. Example: -12.4

LTAS_TILTnumber

Trend line slope across 1-4 kHz in dB. Example: -8.9

LTAS_CURVEnumber

Full Long-Term Average Spectrum as freq/dB pairs, 80-4000 Hz in 100 Hz steps. Example: [{"freq":80,"db":-25.3}, ...]

MEAN_F0number

Mean fundamental frequency in Hz. Example: 195.8

F1_MEANnumber

Mean first formant frequency in Hz. Example: 685.4

F2_MEANnumber

Mean second formant frequency in Hz. Example: 1247.8

F3_MEANnumber

Mean third formant frequency in Hz. Example: 2856.1

GENDERstring

Gender classification result. Example: "Female"

VOICE_PATTERNstring

Clinical classification. Example: "Balanced voice pattern"

BREATHINESS_LEVELstring

Breathiness assessment. Example: "Minimal breathiness"

VOICE_STABILITYstring

Stability classification. Example: "Good stability"

SPECTRAL_HEALTHstring

Overall spectral assessment. Example: "Healthy spectral characteristics"

PATIENT_AGEinteger

Patient age used in analysis. Example: 35

PATIENT_GENDERstring

Patient gender classification. Example: "Female"

AGE_GROUPstring

Age group classification. Example: "Young Adult"

AGE_NOTEstring

Age-related clinical note. Example: "Age within normal vocal range"

F0_NOTEstring

F0 validation note. Example: "F0 within expected range"

F0_VALIDITYstring

F0 validation status. Example: "Valid"

GENDER_SPECTRAL_NOTEstring

Gender-specific spectral note. Example: "Female spectral characteristics confirmed"

EXPECTED_F0_MINnumber

Expected minimum F0 for age/gender. Example: 165.4

EXPECTED_F0_MAXnumber

Expected maximum F0 for age/gender. Example: 294.3

SPECTRAL_MEAN_EXPECTEDnumber

Expected spectral mean for demographics. Example: 1923.5

Changes

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