Advanced Voice Analysis

Calculate the Acoustic Breathiness Index (ABI) from a connected speech recording and a sustained vowel recording. The…

get/api/calculate-abi

Request

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

Query parameters

csFileIdstring required

REQUIRED. fileId of the CONNECTED SPEECH recording (e.g., reading a passage).

svFileIdstring required

REQUIRED. fileId of the SUSTAINED VOWEL /a/ recording (≥ 5 s).

Response

Successful response

ABI_SCOREnumber

Acoustic Breathiness Index — composite multi-component score (number).

CPPSnumber

Cepstral Peak Prominence (Smoothed) in dB — harmonic-to-aperiodic structure indicator.

JITTER_PERCENTnumber

Local jitter as a percentage — period perturbation.

GNE_APPROXIMATIONstring

Approximate Glottal-to-Noise Excitation ratio.

HNR_6KHZstring

Harmonics-to-Noise Ratio computed in the 0–6 kHz band (dB).

HNR_DEJONCKEREstring

HNR computed using De Jonckere's method (dB).

H1_H2_DIFFnumber

Difference between the first two harmonic amplitudes (H1 − H2) in dB — voice source quality indicator.

SHIMMER_DBstring

Shimmer in logarithmic scale (dB).

SHIMMER_PERCENTnumber

Shimmer as a percentage.

PERIOD_STDstring

Standard deviation of glottal period (period stability).

CS_DURATIONnumber

Connected speech recording duration in seconds.

SV_DURATIONnumber

Sustained vowel recording duration in seconds.

CS_DURATION_USEDstring

Portion of CS actually analyzed (after silence trimming).

SV_DURATION_USEDstring

Portion of SV actually analyzed.

TOTAL_ANALYSIS_DURATIONstring

Sum of CS_DURATION_USED + SV_DURATION_USED.

ABI_REFERENCEstring

Clinical reference text emitted by the analysis script (interpretive guidance).

ANALYSIS_VERSIONstring

Algorithm version, e.g. "ABI_v01".

Changes

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