Sign in

v1

latestOpenAPI 3.0.32026-07-267015229.9 KB
Pronunciation Dictionaries

Create Pronunciation Dictionary

Create a pronunciation dictionary with custom rules for controlling how words are spoken. Rules are automatically synced to both Cartesia and ElevenLabs so they work regardless of which TTS engine your PAL uses.

post/v2/pronunciation-dictionaries

Request body

namestring required

Name of the pronunciation dictionary. Max 255 characters.

Example request

{
  "name": "Brand Terms",
  "rules": [
    {
      "text": "Tavus",
      "pronunciation": "TAH-vus",
      "type": "alias"
    }
  ]
}

Response

Pronunciation dictionary created successfully

pronunciation_dictionary_idstring

Unique identifier for the pronunciation dictionary.

namestring

Name of the pronunciation dictionary.

rules_countinteger

Number of rules in the dictionary.

created_atstring

ISO 8601 timestamp of when the dictionary was created.

updated_atstring

ISO 8601 timestamp of when the dictionary was last updated.

Example response

{
  "pronunciation_dictionary_id": "pd_abc123def456gh",
  "name": "Brand Terms",
  "rules": [
    {
      "text": "Tavus",
      "pronunciation": "TAH-vus",
      "type": "alias",
      "word_boundaries": true
    }
  ],
  "rules_count": 1,
  "created_at": "2025-01-15T10:30:00Z",
  "updated_at": "2025-01-15T10:30:00Z"
}