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

# Deepgram TTS

[Deepgram](https://deepgram.com) provides low-latency text-to-speech synthesis with the Aura-2 model.

<Info>
  Vision Agents requires a [Stream](https://getstream.io/try-for-free/) account
  for real-time transport. Most providers offer free tiers to get started.
</Info>

<Tip>
  Deepgram also provides fast, accurate [speech-to-text](/integrations/stt/deepgram) with built-in turn detection. You can use both in the same agent.
</Tip>

## Installation

```sh theme={null}
uv add "vision-agents[deepgram]"
```

## Quick Start

```python theme={null}
from vision_agents.core import Agent, User
from vision_agents.plugins import deepgram, gemini, getstream

agent = Agent(
    edge=getstream.Edge(),
    agent_user=User(name="Assistant", id="agent"),
    instructions="You are a helpful assistant.",
    llm=gemini.LLM("gemini-3-flash-preview"),
    stt=deepgram.STT(),
    tts=deepgram.TTS(),
)
```

<Warning>
  Set `DEEPGRAM_API_KEY` in your environment or pass `api_key` directly.
</Warning>

## Parameters

```python theme={null}
tts = deepgram.TTS(
    model="aura-2",
    voice="aura-asteria-en",
)
```

| Name      | Type  | Default             | Description                                                                    |
| --------- | ----- | ------------------- | ------------------------------------------------------------------------------ |
| `model`   | `str` | `"aura-2"`          | TTS model                                                                      |
| `voice`   | `str` | `"aura-asteria-en"` | Voice ID ([available voices](https://developers.deepgram.com/docs/tts-models)) |
| `api_key` | `str` | `None`              | API key (defaults to `DEEPGRAM_API_KEY` env var)                               |

## Next Steps

<CardGroup cols={2}>
  <Card title="Deepgram STT" icon="microphone" href="/integrations/stt/deepgram">
    Real-time speech-to-text
  </Card>

  <Card title="Build a Voice Agent" icon="microphone" href="/introduction/voice-agents">
    Get started with voice
  </Card>
</CardGroup>