Suggest Pronunciation

Generate a pronunciation suggestion for a word before saving it as a dictionary entry. Returns a `pronunciation` string suitable for use as the `pronunciation` field when creating a `spelled`-method dictionary entry. The suggestion is deterministic (same word always returns the same result) and is intended as a starting point for human review, not as a production-ready transcription. `language` is accepted to maintain a consistent request shape for future per-locale phonetic rules; it does not affect the current output. `ipa` is always `null` in this version — automatic IPA generation is a planned enhancement.

Authentication

AuthorizationBearer
Clerk JWT token
OR
AuthorizationBearer

Onepin live API key (op_live_...). Test and public keys are reserved in Phase 1.

Headers

X-Workspace-Idstring or nullOptional

Request

This endpoint expects an object.
wordstringRequired1-255 characters
The word or phrase to generate a pronunciation suggestion for.
languagestringRequiredformat: "^[a-zA-Z]{2,3}(-[a-zA-Z0-9]{2,4})?$"2-10 characters

BCP-47 locale of the word. Reserved for future per-locale phonetic rules; does not affect current output.

Response

Successful Response
dataobject
metaobject

Errors

422
Unprocessable Entity Error