---
title: "Interpret raw speech-to-text transcriptions of spelling attempts and provide intelligent feedback"
method: POST
path: "/api/spell-agent"
tags: ["AI Agents"]
---

# Interpret raw speech-to-text transcriptions of spelling attempts and provide intelligent feedback

`POST /api/spell-agent`

## Request

- Base URL: `https://platform.vocametrix.com`
- URL: `https://platform.vocametrix.com/api/spell-agent`
- Auth: API key in header `X-API-Key`

## Request body

- object
  - `text` string, required: The speech-to-text transcription of user's spoken spelling attempt
  - `word` string, required: The target word to compare against (with proper accents if applicable)
  - `language` string, required: Language code (e.g., "en-US", "fr-FR", "es-ES") for language-appropriate feedback

## Response `200`

Successful response

- object
  - `output` string: Spelled word in uppercase with any recognized accents
  - `match` boolean: Boolean indicating whether the spelling matches the target word
  - `explanation` string: Detailed explanation in the target language providing educational feedback
  - `remaining_credits` number: Number of remaining API credits

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