TAtavus
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

  • Base URL
    https://tavusapi.com
  • URL
    https://tavusapi.com/v2/pronunciation-dictionaries
  • Auth
    API key in header x-api-key

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"
}

Changes

No recorded changes to this operation across all 2 revisions of this API.