---
title: "Compute intensity dynamics, pitch-intensity correlation, and projection/stability/effort/control/monotonicity scores …"
method: GET
path: "/api/calculate-voice-dynamics"
tags: ["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

- `svFileId` string, required
- `age` integer, required
- `gender` string, required
- `timeStep` number
- `minPitch` number
- `subtractMean` string
- `windowLength` number
- `fatigueThreshold` number
- `mildFatigueThreshold` string
- `monotonicityCV` string
- `monotonicityRange` string

## Response `200`

Successful response

- object
  - `INTENSITY_MEAN` number: Mean intensity in dB.
  - `INTENSITY_STD` number: Intensity standard deviation in dB.
  - `INTENSITY_CV` string: Intensity coefficient of variation (%).
  - `INTENSITY_MIN` number: Minimum intensity in dB.
  - `INTENSITY_MAX` number: Maximum intensity in dB.
  - `INTENSITY_RANGE` number: Intensity range (max − min) in dB.
  - `INTENSITY_MEDIAN` number: Median intensity in dB.
  - `INTENSITY_Q25` number: 25th percentile of intensity in dB.
  - `INTENSITY_Q75` number: 75th percentile of intensity in dB.
  - `INTENSITY_IQR` number: Inter-quartile range of intensity in dB.
  - `INTENSITY_SLOPE` string: Slope of intensity over time (dB/sec) — fatigue indicator if strongly negative.
  - `PITCH_SLOPE` string: Slope of pitch over time (Hz/sec).
  - `PITCH_INTENSITY_CORRELATION` string: Correlation between pitch and intensity contours.
  - `MEAN_F0` number: Mean fundamental frequency in Hz.
  - `F0_STD` number: F0 standard deviation in Hz.
  - `ANALYSIS_DURATION` number: Analyzed duration in seconds.
  - `N_FRAMES` number: Number of frames analyzed.
  - `TIME_STEP` string: Echo of the timeStep parameter used.
  - `WINDOW_LENGTH` string: Echo of the windowLength parameter used.
  - `FATIGUE_THRESHOLD` string: Echo of the fatigueThreshold parameter used.
  - `MILD_FATIGUE_THRESHOLD` string: Echo of the mildFatigueThreshold parameter used.
  - `MONOTONICITY_CV_THRESHOLD` string: Echo of monotonicityCV.
  - `MONOTONICITY_RANGE_THRESHOLD` string: Echo of monotonicityRange.
  - `PROJECTION_SCORE` integer: Integer score (0–N) — vocal projection capability.
  - `STABILITY_SCORE` integer: Integer score — intensity stability.
  - `EFFORT_SCORE` integer: Integer score — vocal effort level.
  - `CONTROL_SCORE` integer: Integer score — pitch/intensity coordination.
  - `MONOTONICITY_SCORE` integer: Integer score — monotonicity (lower is better).
  - `RELIABILITY_FLAG` integer: Integer flag indicating whether the analysis is reliable.
  - `RELATIVE_MAX_THRESHOLD_HIGH` string: Computed reference threshold (high).
  - `RELATIVE_MAX_THRESHOLD_MODERATE` string: Computed reference threshold (moderate).
  - `GENDER_DETECTED` string: Gender inferred from F0 statistics.
  - `GENDER_PROVIDED` string: Echo of the gender parameter as supplied.
  - `PROJECTION_CAPABILITY` string: Categorical: e.g. "Strong", "Adequate", "Reduced".
  - `INTENSITY_STABILITY` string: Categorical clinical label for intensity stability.
  - `VOCAL_EFFORT` string: Categorical: e.g. "Normal", "Increased", "Reduced".
  - `COORDINATION` string: Categorical: how well pitch and intensity co-vary.
  - `FATIGUE_INDICATOR` string: Categorical: "None" | "Mild" | "Severe".
  - `FATIGUE_RISK` string: Categorical risk level.
  - `MONOTONICITY` string: Categorical: "Monotonous" | "Normal variation" | etc.
  - `MONOTONICITY_LEVEL` string: Categorical severity of monotonicity.
  - `MONOTONICITY_CONFIDENCE` string: Categorical confidence: "High" | "Moderate" | "Low".
  - `INTENSITY_CONTROL` string: Categorical assessment of intensity control.
  - `CLINICAL_INTERPRETATION` string: Free-form clinical text summary.
  - `CLINICAL_RECOMMENDATION` string: Free-form clinical recommendation text.
  - `PROFESSIONAL_VOICE` string: Categorical: assessment of professional-voice readiness.
  - `CALIBRATION_NOTE` number: Note about absolute dB calibration (recordings are typically uncalibrated).
  - `VISUALIZATION_NOTE` string: Hint for downstream visualizers.
  - `PATIENT_AGE` string: Echo of the input age.
  - `AGE_GROUP` string: Categorical age group (Child / Adolescent / Adult / Older Adult).
  - `PRESBYLARYNGIS_RISK` string: Categorical age flag, informational only: to our knowledge, no validated presbylaryngis cut-off on these measures.
  - `PRESBYLARYNGIS_AGE_THRESHOLD` string: Age above which the flag is set (internal setting, not a validated cut-off).
  - `EXPECTED_INTENSITY_RANGE` string: Expected intensity range string for this demographic.

## 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)