wx44wx/pipecat
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

Cartesia TTS: Add support for pronunciation_dict_id

Browse Source
This commit is contained in:
Mark Backman
2026-01-04 09:28:32 -05:00
parent 1c80c739d6
commit d8be1282b5
2 changed files with 13 additions and 0 deletions
Download Patch File Download Diff File Expand all files Collapse all files

1
changelog/3346.added.md Normal file
View File

@@ -0,0 +1 @@
- Added `pronunciation_dict_id` parameter to `CartesiaTTSService.InputParams` and `CartesiaHttpTTSService.InputParams` to support Cartesia's pronunciation dictionary feature for custom pronunciations.

12
src/pipecat/services/cartesia/tts.py
View File

@@ -213,12 +213,14 @@ class CartesiaTTSService(AudioContextWordTTSService):
generation_config: Generation configuration for Sonic-3 models. Includes volume, generation_config: Generation configuration for Sonic-3 models. Includes volume,
speed (numeric), and emotion (string) parameters. speed (numeric), and emotion (string) parameters.
pronunciation_dict_id: The ID of the pronunciation dictionary to use for custom pronunciations.
""" """
language: Optional[Language] = Language.EN language: Optional[Language] = Language.EN
speed: Optional[Literal["slow", "normal", "fast"]] = None speed: Optional[Literal["slow", "normal", "fast"]] = None
emotion: Optional[List[str]] = [] emotion: Optional[List[str]] = []
generation_config: Optional[GenerationConfig] = None generation_config: Optional[GenerationConfig] = None
pronunciation_dict_id: Optional[str] = None
def __init__( def __init__(
self, self,
@@ -300,6 +302,7 @@ class CartesiaTTSService(AudioContextWordTTSService):
"speed": params.speed, "speed": params.speed,
"emotion": params.emotion, "emotion": params.emotion,
"generation_config": params.generation_config, "generation_config": params.generation_config,
"pronunciation_dict_id": params.pronunciation_dict_id,
} }
self.set_model_name(model) self.set_model_name(model)
self.set_voice(voice_id) self.set_voice(voice_id)
@@ -444,6 +447,9 @@ class CartesiaTTSService(AudioContextWordTTSService):
exclude_none=True exclude_none=True
) )
if self._settings["pronunciation_dict_id"]:
msg["pronunciation_dict_id"] = self._settings["pronunciation_dict_id"]
return json.dumps(msg) return json.dumps(msg)
async def start(self, frame: StartFrame): async def start(self, frame: StartFrame):
@@ -636,12 +642,14 @@ class CartesiaHttpTTSService(TTSService):
generation_config: Generation configuration for Sonic-3 models. Includes volume, generation_config: Generation configuration for Sonic-3 models. Includes volume,
speed (numeric), and emotion (string) parameters. speed (numeric), and emotion (string) parameters.
pronunciation_dict_id: The ID of the pronunciation dictionary to use for custom pronunciations.
""" """
language: Optional[Language] = Language.EN language: Optional[Language] = Language.EN
speed: Optional[Literal["slow", "normal", "fast"]] = None speed: Optional[Literal["slow", "normal", "fast"]] = None
emotion: Optional[List[str]] = Field(default_factory=list) emotion: Optional[List[str]] = Field(default_factory=list)
generation_config: Optional[GenerationConfig] = None generation_config: Optional[GenerationConfig] = None
pronunciation_dict_id: Optional[str] = None
def __init__( def __init__(
self, self,
@@ -690,6 +698,7 @@ class CartesiaHttpTTSService(TTSService):
"speed": params.speed, "speed": params.speed,
"emotion": params.emotion, "emotion": params.emotion,
"generation_config": params.generation_config, "generation_config": params.generation_config,
"pronunciation_dict_id": params.pronunciation_dict_id,
} }
self.set_voice(voice_id) self.set_voice(voice_id)
self.set_model_name(model) self.set_model_name(model)
@@ -788,6 +797,9 @@ class CartesiaHttpTTSService(TTSService):
exclude_none=True exclude_none=True
) )
if self._settings["pronunciation_dict_id"]:
payload["pronunciation_dict_id"] = self._settings["pronunciation_dict_id"]
yield TTSStartedFrame() yield TTSStartedFrame()
session = await self._client._get_session() session = await self._client._get_session()