Advanced Voice Analysis

Calculate comprehensive formant statistics with gender-specific validation and clinical interpretation

get/api/calculate-formant-statistics

Request

  • Base URL: https://platform.vocametrix.com
  • URL: https://platform.vocametrix.com/api/calculate-formant-statistics
  • 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 clinical context

gender1 | 2 | 3 required

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

versionstring

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

Response

Successful response

F1_MEANnumber

Mean first formant frequency in Hz. Example: 685.4

F1_STDnumber

F1 standard deviation in Hz. Example: 45.2

F1_CVnumber

F1 coefficient of variation in %. Example: 6.6

F1_MEDIANnumber

F1 median frequency in Hz. Example: 682.1

F1_IQRnumber

F1 interquartile range in Hz. Example: 38.7

F1_RANGEnumber

F1 frequency range in Hz. Example: 142.5

F2_MEANnumber

Mean second formant frequency in Hz. Example: 1247.8

F2_STDnumber

F2 standard deviation in Hz. Example: 78.3

F2_CVnumber

F2 coefficient of variation in %. Example: 6.3

F2_MEDIANnumber

F2 median frequency in Hz. Example: 1245.6

F2_IQRnumber

F2 interquartile range in Hz. Example: 65.1

F2_RANGEnumber

F2 frequency range in Hz. Example: 234.8

F3_MEANnumber

Mean third formant frequency in Hz. Example: 2856.1

F3_STDnumber

F3 standard deviation in Hz. Example: 112.4

F3_CVnumber

F3 coefficient of variation in %. Example: 3.9

F3_MEDIANnumber

F3 median frequency in Hz. Example: 2851.7

F3_IQRnumber

F3 interquartile range in Hz. Example: 89.3

F3_RANGEnumber

F3 frequency range in Hz. Example: 387.2

F4_MEANnumber

Mean fourth formant frequency in Hz. Example: 3847.5

F4_STDnumber

F4 standard deviation in Hz. Example: 145.7

F4_CVnumber

F4 coefficient of variation in %. Example: 3.8

F4_MEDIANnumber

F4 median frequency in Hz. Example: 3842.9

F4_IQRnumber

F4 interquartile range in Hz. Example: 123.8

F4_RANGEnumber

F4 frequency range in Hz. Example: 512.6

F2_F1_DIFFnumber

F2-F1 frequency difference in Hz. Example: 562.4

F3_F2_DIFFnumber

F3-F2 frequency difference in Hz. Example: 1608.3

F4_F3_DIFFnumber

F4-F3 frequency difference in Hz. Example: 991.4

VOWEL_SPACE_DISTANCEnumber

Distance from neutral vowel in Hz. Example: 234.6

FORMANT_STABILITY_INDEXnumber

Mean coefficient of variation of F1-F3, in %; lower means more stable. Example: 5.8

ARTICULATORY_PRECISIONstring

Clinical precision level. Example: "Good articulatory precision"

PRECISION_LEVELstring

Severity classification. Example: "Normal precision"

VOWEL_QUALITYstring

Gender-specific assessment. Example: "Normal female vowel production"

GENDERstring

Gender classification. Example: "Female"

VOICE_PATTERNstring

Clinical pattern assessment. Example: "Normal formant pattern"

PATIENT_AGEinteger

Patient age in years. Example: 35

PATIENT_GENDERstring

Patient gender classification. Example: "Female"

AGE_GROUPstring

Age-based grouping. Example: "Young Adult"

AGE_NOTEstring

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

GENDER_FORMANT_NOTEstring

Gender-specific formant note. Example: "Formant frequencies consistent with female anatomy"

EXPECTED_F1_RANGEstring

Expected F1 range for demographics. Example: "650-720 Hz"

EXPECTED_F2_RANGEstring

Expected F2 range for demographics. Example: "1200-1300 Hz"

EXPECTED_F3_RANGEstring

Expected F3 range for demographics. Example: "2800-2900 Hz"

Changes

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