Voice Quality Metrics

Calculate DSI from a previously uploaded sustained vowel (SV) recording and required voice-range parameters. All para…

get/api/calculate-dsi

Request

svFileIdstring required

ID of the sustained vowel audio file (returned by /api/assignFileId) - REQUIRED

mptnumber required

Maximum Phonation Time in seconds (MPT). Must be a positive number > 0 - REQUIRED

maximumF0number required

Highest fundamental frequency in Hz (F0-High). Must be a positive number > 0 - REQUIRED

minimumIntensitynumber required

Softest intensity level in dB SPL (I_low). Numeric value - REQUIRED

ageinteger required

Patient age in years (1-120). Used for clinical interpretation - REQUIRED

genderinteger required

Patient gender code: 1=Male, 2=Female, 3=Other/Unknown. Used for F0 validation/context - REQUIRED

versionstring

Optional DSI algorithm version (example: "v02.01") - OPTIONAL

Successful response

DSInumber

number - Dysphonia Severity Index score (approx range -5 to +5). Example: 1.85

JITTERnumber

number - Jitter PPQ5 (Praat, %) entering the DSIbeta formula. Example: 0.45

MPTnumber

number - Maximum Phonation Time in seconds (echoes input MPT or measured). Example: 15.2

MINLEVELnumber

number - Minimum intensity level in dB SPL. Example: 45.5

MAXF0number

number - Maximum fundamental frequency in Hz. Example: 440.0

PATIENT_AGEnumber

number - Patient age (integer). Example: 35

PATIENT_GENDERstring

string - Human-readable gender label (e.g. "Female")

AGE_GROUPstring

string - Age group label, informational only (e.g. "Young adult / Middle-aged")

PRESBYLARYNGIS_RISKnumber

number - Flag set to 1 when age ≥ 65, informational only: the DSI is not adjusted for age. Example: 0

EXPECTED_F0_RANGEstring

string - Gender-specific expected F0 range. Example: "150-350 Hz"

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