> ## Documentation Index
> Fetch the complete documentation index at: https://composio-preview.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Cartesia

> Cartesia provides real-time text-to-speech, speech-to-text, voice, model training, and managed voice agent APIs.

![Cartesia logo](https://mintcdn.com/composio-preview/PudKL42NVsy5O-ND/images/toolkits/cartesia.svg?fit=max\&auto=format\&n=PudKL42NVsy5O-ND\&q=85\&s=2c6abce6cb5e3b041a2aee3d1a9cba39)

* **Category:** artificial intelligence
* **Auth:** API\_KEY
* **Composio-managed OAuth available?** N/A
* **Tools:** 10
* **Triggers:** 0
* **Slug:** `CARTESIA`
* **Version:** 00000000\_00

## Tools

> [accordion] Create Pronunciation Dictionary
>
> **Slug:** `CARTESIA_CREATE_PRONUNCIATION_DICTIONARY`
>
> Create a reusable pronunciation dictionary for text-to-speech generation.
>
> #### Input Parameters
>
> **name** `string` *required*
>
> Name for the pronunciation dictionary.
>
> **items** `array`
>
> Initial text-to-pronunciation mappings for the dictionary.
>
> **access** `string ("private" | "public")`
>
> Who may use the dictionary: private restricts it to the owning organization; public allows any Cartesia user with its ID.
>
> **description** `string`
>
> Optional description of the dictionary's purpose.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Delete Pronunciation Dictionary
>
> **Slug:** `CARTESIA_DELETE_PRONUNCIATION_DICTIONARY`
>
> Permanently delete one pronunciation dictionary by ID.
>
> #### Input Parameters
>
> **dictionary\_id** `string` *required*
>
> ID of the pronunciation dictionary to permanently delete.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Pronunciation Dictionary
>
> **Slug:** `CARTESIA_GET_PRONUNCIATION_DICTIONARY`
>
> Return one pronunciation dictionary and its complete text-to-pronunciation mappings.
>
> #### Input Parameters
>
> **dictionary\_id** `string` *required*
>
> ID of the pronunciation dictionary to retrieve.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Voice
>
> **Slug:** `CARTESIA_GET_VOICE`
>
> Return synthesis-relevant details for one Cartesia voice by ID.
>
> #### Input Parameters
>
> **voice\_id** `string` *required*
>
> ID of the voice to retrieve; obtainable from List Voices.
>
> **include\_preview\_url** `boolean`
>
> Include the voice's preview audio URL when true.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] List Accents
>
> **Slug:** `CARTESIA_LIST_ACCENTS`
>
> List supported accents, optionally filtered by language, locale, or voice-localization support.
>
> #### Input Parameters
>
> **locale** `string`
>
> Filter by locale code, such as en-US or es-MX.
>
> **language** `string`
>
> Filter by language code, such as en or es.
>
> **localizable\_only** `boolean`
>
> When true, return only accents available for voice localization.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] List Agent Models
>
> **Slug:** `CARTESIA_LIST_AGENT_MODELS`
>
> List language models available to Cartesia Managed Agents, including provider, latency, and pricing metadata.
>
> #### Input Parameters
>
> **limit** `integer`
>
> Maximum models to return in this page (1-100).
>
> **cursor** `string`
>
> Continuation cursor returned by a previous call.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] List Pronunciation Dictionaries
>
> **Slug:** `CARTESIA_LIST_PRONUNCIATION_DICTIONARIES`
>
> Return one page of pronunciation dictionaries available to the connected account.
>
> #### Input Parameters
>
> **limit** `integer`
>
> Maximum dictionaries to return in this page (1-100).
>
> **cursor** `string`
>
> Continuation cursor returned by a previous call. Omit for the first page.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] List Voices
>
> **Slug:** `CARTESIA_LIST_VOICES`
>
> Search and filter Cartesia voices, returning one page of voice IDs and synthesis-relevant metadata.
>
> #### Input Parameters
>
> **limit** `integer`
>
> Maximum voices to return in this page (1-100).
>
> **cursor** `string`
>
> Continuation cursor returned by a previous call. Omit for the first page.
>
> **gender** `string ("masculine" | "feminine" | "gender_neutral")`
>
> Filter by voice gender presentation.
>
> **language** `string`
>
> Filter by language or locale code, such as en or en-GB.
>
> **owned\_only** `boolean`
>
> When true, return only voices owned by the connected organization.
>
> **search\_query** `string`
>
> Search voice names, descriptions, or IDs.
>
> **include\_archived** `boolean`
>
> Include archived voices when true.
>
> **include\_preview\_url** `boolean`
>
> Include each voice's preview audio URL when true.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Synthesize Speech
>
> **Slug:** `CARTESIA_SYNTHESIZE_SPEECH`
>
> Generate a downloadable audio file from one complete transcript using a selected Cartesia voice; usage is billed by transcript length.
>
> #### Input Parameters
>
> **speed** `number`
>
> Optional generation speed setting for sonic-3 and newer.
>
> **accent** `string`
>
> Optional accent ID supported by the selected voice; normally omit to let Cartesia choose.
>
> **volume** `number`
>
> Optional generation volume setting for sonic-3 and newer.
>
> **emotion** `string ("neutral" | "happy" | "excited" | "enthusiastic" | "elated" | "euphoric" | "triumphant" | "amazed" | "surprised" | "flirtatious" | "curious" | "content" | "peaceful" | "serene" | "calm" | "grateful" | "affectionate" | "trust" | "sympathetic" | "anticipation" | "mysterious" | "angry" | "mad" | "outraged" | "frustrated" | "agitated" | "threatened" | "disgusted" | "contempt" | "envious" | "sarcastic" | "ironic" | "sad" | "dejected" | "melancholic" | "disappointed" | "hurt" | "guilty" | "bored" | "tired" | "rejected" | "nostalgic" | "wistful" | "apologetic" | "hesitant" | "insecure" | "confused" | "resigned" | "anxious" | "panicked" | "alarmed" | "scared" | "proud" | "confident" | "distant" | "skeptical" | "contemplative" | "determined")`
>
> Optional primary emotion to guide speech generation on sonic-3 and newer.
>
> **encoding** `string ("pcm_f32le" | "pcm_s16le" | "pcm_mulaw" | "pcm_alaw")`
>
> Audio encoding valid for the selected output container.
>
> **language** `string`
>
> Transcript language or locale code, such as en or en-GB.
>
> **model\_id** `string ("sonic-3.6" | "sonic-3.5" | "sonic-3" | "sonic-latest")`
>
> Cartesia speech model to use.
>
> **voice\_id** `string` *required*
>
> Voice ID from List Voices.
>
> **transcript** `string` *required*
>
> Complete text to synthesize; usage is billed by transcript length.
>
> **sample\_rate** `integer ("8000" | "16000" | "22050" | "24000" | "44100" | "48000")`
>
> Output sample rate in hertz; must be valid for the selected container and encoding.
>
> **normalization** `string`
>
> Use auto, off, or a language/locale code to control text normalization.
>
> **output\_container** `string ("wav" | "mp3" | "raw")`
>
> Audio file/container format.
>
> **pronunciation\_dictionary\_id** `string`
>
> Optional pronunciation dictionary ID to apply; supported by sonic-3 and newer.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Update Pronunciation Dictionary
>
> **Slug:** `CARTESIA_UPDATE_PRONUNCIATION_DICTIONARY`
>
> Update a pronunciation dictionary and replace its mappings with the complete supplied item set.
>
> #### Input Parameters
>
> **name** `string`
>
> New dictionary name; omit to leave the name unchanged.
>
> **items** `array` *required*
>
> Complete intended mapping set. This replaces the dictionary's existing mappings, so include every mapping that should remain; an empty list clears all mappings.
>
> **access** `string ("private" | "public")`
>
> New access level; omit to leave it unchanged.
>
> **description** `string`
>
> New dictionary description; omit to leave it unchanged.
>
> **dictionary\_id** `string` *required*
>
> ID of the pronunciation dictionary to update.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not
