REVERIE · TTS

Pronunciation

Manage the global pronunciation dictionary of a speaker. Entries saved here apply to every future request for that speaker, unlike the per-request custom_pronunciations field on inference calls.

NOTE
All four dictionary endpoints require an API key in the x-api-key header. Add requests use a JSON body; delete requests identify the entry in the URL.

Per-request overrides

Include custom_pronunciations in any generate or stream request:

"custom_pronunciations": {
  "words": { "computer": "compyuter" },
  "phonemes": {}
}

Add word pronunciation

POSThttps://api.lucidweights.ai/v1/tts/pronunciation/{speaker}/words
FieldTypeDefaultDescription
wordstringrequiredThe original word to replace
pronunciationstringrequiredReplacement string
languagestringrequiredISO 639-1 language code
Example
curl -X POST "https://api.lucidweights.ai/v1/tts/pronunciation/emily/words" \
  -H "x-api-key: lw_YOUR_SECRET" \
  -H "Content-Type: application/json" \
  -d '{"word":"computer","pronunciation":"compyuter","language":"en"}'

The response contains a message field, such as Success or Failed.

Add phoneme pronunciation

POSThttps://api.lucidweights.ai/v1/tts/pronunciation/{speaker}/phonemes
FieldTypeDefaultDescription
phonemestringrequiredOriginal phoneme to replace
replacementstringrequiredReplacement phoneme
languagestringrequiredISO 639-1 language code
Example
curl -X POST "https://api.lucidweights.ai/v1/tts/pronunciation/emily/phonemes" \
  -H "x-api-key: lw_YOUR_SECRET" \
  -H "Content-Type: application/json" \
  -d '{"phoneme":"həlˈoʊ","replacement":"hˈæloʊ","language":"en"}'

The response has the same message field as the word endpoint.

Delete word pronunciation

DELETEhttps://api.lucidweights.ai/v1/tts/pronunciation/{speaker}/words/{word}

Query param language (default en). The response contains a status message.

Example
curl -X DELETE "https://api.lucidweights.ai/v1/tts/pronunciation/emily/words/computer?language=en" \
  -H "x-api-key: lw_YOUR_SECRET"

Delete phoneme pronunciation

DELETEhttps://api.lucidweights.ai/v1/tts/pronunciation/{speaker}/phonemes/{phoneme}

Query param language (default en). URL-encode phoneme characters in the path. The response contains a status message.