---
title: "Generate personalized speech therapy exercises. The agent returns a single conversational reply containing the exerci…"
method: POST
path: "/api/speech-exercise-generator"
tags: ["AI Agents"]
---

# Generate personalized speech therapy exercises. The agent returns a single conversational reply containing the exerci…

`POST /api/speech-exercise-generator`

## Request

- Base URL: `https://platform.vocametrix.com`
- URL: `https://platform.vocametrix.com/api/speech-exercise-generator`
- Auth: API key in header `X-API-Key`

## Request body

- object
  - `message` string, required: REQUIRED. Instructions or context for the exercise generation (e.g., "Generate 5 articulation exercises for /r/").
  - `ageLevel` string, required: Patient age range (e.g., "3-6 years", "7-12 years", "adults")
  - `speechChallenge` string, required: The specific speech challenge to address (e.g., "R sounds", "S sounds")
  - `language` string, required: Target language for exercises (English, French, Spanish)

## Response `200`

Successful response

- object
  - `response` string: The agent reply containing the generated exercises as structured text
  - `threadId` string: Conversation thread ID — pass it back to continue the same session
  - `agentName` string: Identifier of the agent that produced the reply
  - `runStatus` string: Internal run state (e.g., "completed")
  - `remaining_credits` number: Number of API credits remaining in your account
  - `parameters` string: Echo of the parameters used to produce the reply (ageLevel, speechChallenge, language)

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