> ## Documentation Index
> Fetch the complete documentation index at: https://docs.zeroruntime.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Cartesia

> Python API reference for the cartesia text-to-speech provider.

<Card title="Usage guide" icon="book" href="/plugins/tts/cartesia" horizontal>
  Setup, environment variables, and Python/JavaScript/Go usage examples.
</Card>

## CartesiaTTS

Initialize the Cartesia TTS plugin.

Slot: tts. Route: plugins -- direct to the vendor, with CARTESIA\_API\_KEY or
an explicit api\_key.

```python theme={null}
from zeroruntime.plugins import CartesiaTTS  # direct to the vendor, with your key
from zeroruntime.inference import CartesiaTTS  # same fields, through the gateway, no vendor key
```

### Fields

<ParamField path="model" type="str" default="sonic-3.5'; pinned" />

<ParamField path="voice" type="Union[str, List[float]]" default="UNSET" />

<ParamField path="language" type="str" default="en" />

<ParamField path="base_url" type="str" default="https://api.cartesia.ai" />

<ParamField path="generation_config" type="Mapping[str, Any] | None" default="UNSET" />

<ParamField path="pronunciation_dict_id" type="str | None" default="None" />

<ParamField path="max_buffer_delay_ms" type="int | None" default="None" />

<ParamField path="word_timestamps" type="bool" default="False" />

<ParamField path="max_connection_age_sec" type="float" default="300.0" />