---
title: "Pronunciation assessment enriched with per-word pitch contours. Same audio upload + Azure pronunciation evaluation as…"
method: POST
path: "/api/pronunciation-assessment-with-pitch"
tags: ["Core Speech Analysis"]
---

# Pronunciation assessment enriched with per-word pitch contours. Same audio upload + Azure pronunciation evaluation as…

`POST /api/pronunciation-assessment-with-pitch`

## Request

- Base URL: `https://platform.vocametrix.com`
- URL: `https://platform.vocametrix.com/api/pronunciation-assessment-with-pitch`
- Auth: API key in header `X-API-Key`

## Request body

- object
  - `blobURL` string, required: The secure URL received from /api/get-blob-url
  - `referenceText` string, required: The text to compare against the audio
  - `locale` string, required: The language locale (e.g., en-US, fr-FR)

## Response `200`

Successful response

- object
  - `RecognitionStatus` string: Azure recognition status (e.g., "Success")
  - `Offset` string: Recognition start offset in 100-nanosecond units
  - `Duration` string: Recognition duration in 100-nanosecond units
  - `DisplayText` string: The recognized text with proper formatting
  - `NBest` object[]: Array of N-best recognition hypotheses. Each NBest[i] contains the standard Azure pronunciation fields (Confidence, Lexical, ITN, MaskedITN, Display, PronunciationAssessment, Words[]) — and each NBest[i].Words[j] is augmented with an additional `Pitch` array containing F0 samples (Hz) measured over the word's timespan via parselmouth. Words[j] also carry the standard Azure fields: Word, Offset, Duration, PronunciationAssessment {AccuracyScore, ErrorType}, Phonemes[], Syllables[].

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