Skip to main content
Cartesia logo
  • Category: artificial intelligence
  • Auth: API_KEY
  • Composio-managed OAuth available? N/A
  • Tools: 10
  • Triggers: 0
  • Slug: CARTESIA
  • Version: 00000000_00

Tools

Slug: CARTESIA_CREATE_PRONUNCIATION_DICTIONARYCreate a reusable pronunciation dictionary for text-to-speech generation.

Input Parameters

string
required
Name for the pronunciation dictionary.
array
Initial text-to-pronunciation mappings for the dictionary.
string ("private" | "public")
Who may use the dictionary: private restricts it to the owning organization; public allows any Cartesia user with its ID.
string
Optional description of the dictionary’s purpose.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: CARTESIA_DELETE_PRONUNCIATION_DICTIONARYPermanently delete one pronunciation dictionary by ID.

Input Parameters

string
required
ID of the pronunciation dictionary to permanently delete.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: CARTESIA_GET_PRONUNCIATION_DICTIONARYReturn one pronunciation dictionary and its complete text-to-pronunciation mappings.

Input Parameters

string
required
ID of the pronunciation dictionary to retrieve.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: CARTESIA_GET_VOICEReturn synthesis-relevant details for one Cartesia voice by ID.

Input Parameters

string
required
ID of the voice to retrieve; obtainable from List Voices.
boolean
Include the voice’s preview audio URL when true.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: CARTESIA_LIST_ACCENTSList supported accents, optionally filtered by language, locale, or voice-localization support.

Input Parameters

string
Filter by locale code, such as en-US or es-MX.
string
Filter by language code, such as en or es.
boolean
When true, return only accents available for voice localization.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: CARTESIA_LIST_AGENT_MODELSList language models available to Cartesia Managed Agents, including provider, latency, and pricing metadata.

Input Parameters

integer
Maximum models to return in this page (1-100).
string
Continuation cursor returned by a previous call.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: CARTESIA_LIST_PRONUNCIATION_DICTIONARIESReturn one page of pronunciation dictionaries available to the connected account.

Input Parameters

integer
Maximum dictionaries to return in this page (1-100).
string
Continuation cursor returned by a previous call. Omit for the first page.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: CARTESIA_LIST_VOICESSearch and filter Cartesia voices, returning one page of voice IDs and synthesis-relevant metadata.

Input Parameters

integer
Maximum voices to return in this page (1-100).
string
Continuation cursor returned by a previous call. Omit for the first page.
string ("masculine" | "feminine" | "gender_neutral")
Filter by voice gender presentation.
string
Filter by language or locale code, such as en or en-GB.
boolean
When true, return only voices owned by the connected organization.
string
Search voice names, descriptions, or IDs.
boolean
Include archived voices when true.
boolean
Include each voice’s preview audio URL when true.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: CARTESIA_SYNTHESIZE_SPEECHGenerate a downloadable audio file from one complete transcript using a selected Cartesia voice; usage is billed by transcript length.

Input Parameters

number
Optional generation speed setting for sonic-3 and newer.
string
Optional accent ID supported by the selected voice; normally omit to let Cartesia choose.
number
Optional generation volume setting for sonic-3 and newer.
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.
string ("pcm_f32le" | "pcm_s16le" | "pcm_mulaw" | "pcm_alaw")
Audio encoding valid for the selected output container.
string
Transcript language or locale code, such as en or en-GB.
string ("sonic-3.6" | "sonic-3.5" | "sonic-3" | "sonic-latest")
Cartesia speech model to use.
string
required
Voice ID from List Voices.
string
required
Complete text to synthesize; usage is billed by transcript length.
integer ("8000" | "16000" | "22050" | "24000" | "44100" | "48000")
Output sample rate in hertz; must be valid for the selected container and encoding.
string
Use auto, off, or a language/locale code to control text normalization.
string ("wav" | "mp3" | "raw")
Audio file/container format.
string
Optional pronunciation dictionary ID to apply; supported by sonic-3 and newer.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: CARTESIA_UPDATE_PRONUNCIATION_DICTIONARYUpdate a pronunciation dictionary and replace its mappings with the complete supplied item set.

Input Parameters

string
New dictionary name; omit to leave the name unchanged.
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.
string ("private" | "public")
New access level; omit to leave it unchanged.
string
New dictionary description; omit to leave it unchanged.
string
required
ID of the pronunciation dictionary to update.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not