---
title: "Translate raw voice metrics (jitter, shimmer, HNR, CPPS, etc.) into a clinical-language interpretation with severity,…"
method: POST
path: "/api/voice-metrics-interpreter"
tags: ["AI Agents"]
---

# Translate raw voice metrics (jitter, shimmer, HNR, CPPS, etc.) into a clinical-language interpretation with severity,…

`POST /api/voice-metrics-interpreter`

## Request

- Base URL: `https://platform.vocametrix.com`
- URL: `https://platform.vocametrix.com/api/voice-metrics-interpreter`
- Auth: API key in header `X-API-Key`

## Request body

- object
  - `metrics` object, required: REQUIRED. Object of voice metrics — typical keys: jitter, shimmer, hnr, cpps, etc. (validated server-side).
  - `age` integer, required: REQUIRED. Patient age in years (1–120).
  - `gender` string, required: REQUIRED. "male" | "female" | "other".
  - `languageCode` string: Optional. Output language code — server applies a default via validateLanguageCode if omitted.
  - `threadId` string: Optional. Azure AI Foundry thread ID for multi-turn continuity.
  - `praatResults` object: Optional. Full Praat output object — when present, the server merges F0 / expected-range fields into the metrics for richer interpretation.
  - `email` string: Optional. Used by the credit-validation flow.

## Response `200`

Successful response

- object
  - `success` boolean: Boolean.
  - `overallScore` number: Number 0–100, or -1 if the agent's response could not be parsed.
  - `pathologyLevel` string: Categorical string describing pathology severity.
  - `problematicMetrics` object[]: Array of metric names flagged as problematic.
  - `interpretation` object: Object: { summary, overallAssessment, metrics: [...], additionalNotes: [...], recommendedActions: [{category, recommendation}], riskLevel, nextSteps }.
  - `metadata` object: Object: { languageCode, age, gender, metricsProcessed, threadId, agentName, processingTimeSeconds, timestamp, genderValidation: {detectedF0, expectedRange, f0Validity, note} | null }.
  - `remaining_credits` number: Number.

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