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

messagestring required

REQUIRED. The user's message in their target language

languagestring required

REQUIRED. Target language the user is learning (en-US, fr-FR, es-ES, de-DE, etc.)

nativeLanguagestring required

REQUIRED. The user's native language code — used to localize vocabulary hints and corrections

ageLevelstring required

CEFR level of the learner (A1, A2, B1, B2, C1, C2)

topicstring required

Conversation topic (family, travel, food, work, hobbies, etc.)

threadIdstring

Optional thread ID to continue previous conversation

emailstring

Optional user email for tracking

Response

Successful response

responsestring

The AI assistant's conversational reply with vocabulary enhancements

threadIdstring

Thread ID for continuing the conversation

remaining_creditsnumber

Number of API credits remaining in your account

configurationobject

Object containing the current language, age level, and topic

Changes

No recorded changes to this operation across all 1 revision of this API.