---
title: "Conversational language-coach agent specialized in pronunciation feedback. Similar to /api/language-chat-vocabulary b…"
method: POST
path: "/api/language-chat-pronunciation"
tags: ["AI Agents"]
---

# Conversational language-coach agent specialized in pronunciation feedback. Similar to /api/language-chat-vocabulary b…

`POST /api/language-chat-pronunciation`

## Request

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

## Request body

- object
  - `message` string, required: REQUIRED. The learner's message in the target language.
  - `language` string, required: REQUIRED. Target language being learned.
  - `ageLevel` string, required: REQUIRED. CEFR level of the learner (A1, A2, B1, B2, C1, C2).
  - `topic` string, required: REQUIRED. Conversation topic.
  - `nativeLanguage` string: Optional. The learner's native language code.
  - `threadId` string: Optional. Thread ID for multi-turn continuity.
  - `email` string: Optional. Used by the credit-validation flow.
  - `assessmentHistory` object[]: Optional. Array or object of prior pronunciation-assessment results to feed into the coach for grounded feedback.

## Response `200`

Successful response

- object
  - `response` string: String — the coach's text reply.
  - `threadId` string: Thread ID.
  - `runStatus` string: Run status string.
  - `remaining_credits` number: Number.
  - `configuration` object: Object — passthrough of resolved language, nativeLanguage, ageLevel, topic.

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