---
title: "Interactive conversational AI that helps users practice language skills with real-time vocabulary enhancement"
method: POST
path: "/api/language-chat-vocabulary"
tags: ["AI Agents"]
---

# Interactive conversational AI that helps users practice language skills with real-time vocabulary enhancement

`POST /api/language-chat-vocabulary`

## Request

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

## Request body

- object
  - `message` string, required: REQUIRED. The user's message in their target language
  - `language` string, required: REQUIRED. Target language the user is learning (en-US, fr-FR, es-ES, de-DE, etc.)
  - `nativeLanguage` string, required: REQUIRED. The user's native language code — used to localize vocabulary hints and corrections
  - `ageLevel` string, required: CEFR level of the learner (A1, A2, B1, B2, C1, C2)
  - `topic` string, required: Conversation topic (family, travel, food, work, hobbies, etc.)
  - `threadId` string: Optional thread ID to continue previous conversation
  - `email` string: Optional user email for tracking

## Response `200`

Successful response

- object
  - `response` string: The AI assistant's conversational reply with vocabulary enhancements
  - `threadId` string: Thread ID for continuing the conversation
  - `remaining_credits` number: Number of API credits remaining in your account
  - `configuration` object: Object containing the current language, age level, and 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)