---
title: "Calculate the Acoustic Breathiness Index (ABI) from a connected speech recording and a sustained vowel recording. The…"
method: GET
path: "/api/calculate-abi"
tags: ["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

- `csFileId` string, required
- `svFileId` string, required

## Response `200`

Successful response

- object
  - `ABI_SCORE` number: Acoustic Breathiness Index — composite multi-component score (number).
  - `CPPS` number: Cepstral Peak Prominence (Smoothed) in dB — harmonic-to-aperiodic structure indicator.
  - `JITTER_PERCENT` number: Local jitter as a percentage — period perturbation.
  - `GNE_APPROXIMATION` string: Approximate Glottal-to-Noise Excitation ratio.
  - `HNR_6KHZ` string: Harmonics-to-Noise Ratio computed in the 0–6 kHz band (dB).
  - `HNR_DEJONCKERE` string: HNR computed using De Jonckere's method (dB).
  - `H1_H2_DIFF` number: Difference between the first two harmonic amplitudes (H1 − H2) in dB — voice source quality indicator.
  - `SHIMMER_DB` string: Shimmer in logarithmic scale (dB).
  - `SHIMMER_PERCENT` number: Shimmer as a percentage.
  - `PERIOD_STD` string: Standard deviation of glottal period (period stability).
  - `CS_DURATION` number: Connected speech recording duration in seconds.
  - `SV_DURATION` number: Sustained vowel recording duration in seconds.
  - `CS_DURATION_USED` string: Portion of CS actually analyzed (after silence trimming).
  - `SV_DURATION_USED` string: Portion of SV actually analyzed.
  - `TOTAL_ANALYSIS_DURATION` string: Sum of CS_DURATION_USED + SV_DURATION_USED.
  - `ABI_REFERENCE` string: Clinical reference text emitted by the analysis script (interpretive guidance).
  - `ANALYSIS_VERSION` string: Algorithm version, e.g. "ABI_v01".

## Other responses

- `400`: Bad request — missing or invalid parameter
- `401`: Unauthorized — missing or invalid API key
- `429`: Rate limit exceeded
- `500`: Server error

---

[API](https://skmtc.dev/vocametrix/apis/vocametrix-api.md) · [All operations](https://skmtc.dev/vocametrix/apis/vocametrix-api/llms.txt) · [OpenAPI document](https://skmtc.dev/vocametrix/apis/vocametrix-api/revisions/8a54d01bcc81?raw)