Advanced Voice Analysis

Compute intensity dynamics, pitch-intensity correlation, and projection/stability/effort/control/monotonicity scores …

get/api/calculate-voice-dynamics

Request

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

Query parameters

svFileIdstring required

REQUIRED. fileId of the sustained vowel recording.

ageinteger required

REQUIRED. Patient age in years (1–120).

genderstring required

REQUIRED. "male" | "female" | "other" (or numeric "1" | "2" | "3").

timeStepnumber

Optional, default 0.01 (must be 0 < x ≤ 0.1). Praat analysis frame step in seconds.

minPitchnumber

Optional, default 75. Lower limit of pitch tracking in Hz (range 50–200).

subtractMeanstring

Optional, default 1. 0 or 1 — whether to subtract DC offset before analysis.

windowLengthnumber

Optional, default 0.03 (must be 0 < x ≤ 1). Analysis window in seconds.

fatigueThresholdnumber

Optional, default 1.0. Threshold for severe fatigue indicator (positive number).

mildFatigueThresholdstring

Optional, default 0.5. Threshold for mild fatigue indicator.

monotonicityCVstring

Optional, default 5.0. Coefficient-of-variation threshold below which voice is flagged monotonous.

monotonicityRangestring

Optional, default 10.0. Pitch range threshold (semitones) below which voice is flagged monotonous.

Response

Successful response

INTENSITY_MEANnumber

Mean intensity in dB.

INTENSITY_STDnumber

Intensity standard deviation in dB.

INTENSITY_CVstring

Intensity coefficient of variation (%).

INTENSITY_MINnumber

Minimum intensity in dB.

INTENSITY_MAXnumber

Maximum intensity in dB.

INTENSITY_RANGEnumber

Intensity range (max − min) in dB.

INTENSITY_MEDIANnumber

Median intensity in dB.

INTENSITY_Q25number

25th percentile of intensity in dB.

INTENSITY_Q75number

75th percentile of intensity in dB.

INTENSITY_IQRnumber

Inter-quartile range of intensity in dB.

INTENSITY_SLOPEstring

Slope of intensity over time (dB/sec) — fatigue indicator if strongly negative.

PITCH_SLOPEstring

Slope of pitch over time (Hz/sec).

PITCH_INTENSITY_CORRELATIONstring

Correlation between pitch and intensity contours.

MEAN_F0number

Mean fundamental frequency in Hz.

F0_STDnumber

F0 standard deviation in Hz.

ANALYSIS_DURATIONnumber

Analyzed duration in seconds.

N_FRAMESnumber

Number of frames analyzed.

TIME_STEPstring

Echo of the timeStep parameter used.

WINDOW_LENGTHstring

Echo of the windowLength parameter used.

FATIGUE_THRESHOLDstring

Echo of the fatigueThreshold parameter used.

MILD_FATIGUE_THRESHOLDstring

Echo of the mildFatigueThreshold parameter used.

MONOTONICITY_CV_THRESHOLDstring

Echo of monotonicityCV.

MONOTONICITY_RANGE_THRESHOLDstring

Echo of monotonicityRange.

PROJECTION_SCOREinteger

Integer score (0–N) — vocal projection capability.

STABILITY_SCOREinteger

Integer score — intensity stability.

EFFORT_SCOREinteger

Integer score — vocal effort level.

CONTROL_SCOREinteger

Integer score — pitch/intensity coordination.

MONOTONICITY_SCOREinteger

Integer score — monotonicity (lower is better).

RELIABILITY_FLAGinteger

Integer flag indicating whether the analysis is reliable.

RELATIVE_MAX_THRESHOLD_HIGHstring

Computed reference threshold (high).

RELATIVE_MAX_THRESHOLD_MODERATEstring

Computed reference threshold (moderate).

GENDER_DETECTEDstring

Gender inferred from F0 statistics.

GENDER_PROVIDEDstring

Echo of the gender parameter as supplied.

PROJECTION_CAPABILITYstring

Categorical: e.g. "Strong", "Adequate", "Reduced".

INTENSITY_STABILITYstring

Categorical clinical label for intensity stability.

VOCAL_EFFORTstring

Categorical: e.g. "Normal", "Increased", "Reduced".

COORDINATIONstring

Categorical: how well pitch and intensity co-vary.

FATIGUE_INDICATORstring

Categorical: "None" | "Mild" | "Severe".

FATIGUE_RISKstring

Categorical risk level.

MONOTONICITYstring

Categorical: "Monotonous" | "Normal variation" | etc.

MONOTONICITY_LEVELstring

Categorical severity of monotonicity.

MONOTONICITY_CONFIDENCEstring

Categorical confidence: "High" | "Moderate" | "Low".

INTENSITY_CONTROLstring

Categorical assessment of intensity control.

CLINICAL_INTERPRETATIONstring

Free-form clinical text summary.

CLINICAL_RECOMMENDATIONstring

Free-form clinical recommendation text.

PROFESSIONAL_VOICEstring

Categorical: assessment of professional-voice readiness.

CALIBRATION_NOTEnumber

Note about absolute dB calibration (recordings are typically uncalibrated).

VISUALIZATION_NOTEstring

Hint for downstream visualizers.

PATIENT_AGEstring

Echo of the input age.

AGE_GROUPstring

Categorical age group (Child / Adolescent / Adult / Older Adult).

PRESBYLARYNGIS_RISKstring

Categorical age flag, informational only: to our knowledge, no validated presbylaryngis cut-off on these measures.

PRESBYLARYNGIS_AGE_THRESHOLDstring

Age above which the flag is set (internal setting, not a validated cut-off).

EXPECTED_INTENSITY_RANGEstring

Expected intensity range string for this demographic.

Changes

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