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

# ElevenLabs STT

[ElevenLabs](https://www.elevenlabs.io) provides real-time speech-to-text via Scribe v2 with \~150ms latency, 99 languages, and built-in VAD-based turn detection. No separate turn detection plugin is needed.

> [!NOTE]
>
> Vision Agents uses [Stream Video](https://getstream.io/video/) for real-time WebRTC transport by default. [External WebRTC transports](https://visionagents.ai/integrations/introduction-to-integrations.md#edge-transport) are supported as well. Most AI providers offer free tiers to get started.

> [!TIP]
>
> ElevenLabs also provides highly realistic [text-to-speech](https://visionagents.ai/integrations/tts/elevenlabs.md). You can use both in the same agent.

## Installation

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

## Quick Start

```python theme={null}
from vision_agents.core import Agent, User
from vision_agents.plugins import elevenlabs, 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=elevenlabs.STT(),
    tts=elevenlabs.TTS(),
)
```

> [!WARNING]
>
> Set `ELEVENLABS_API_KEY` in your environment or pass `api_key` directly.

## Parameters

```python theme={null}
stt = elevenlabs.STT(
    model_id="scribe_v2_realtime",
    language_code="en",
)
```

| Name | Type | Default | Description |
| - | - | - | - |
| `model_id` | `str` | `"scribe_v2_realtime"` | Scribe model |
| `language_code` | `str` | `"en"` | Language code |
| `api_key` | `str` | `None` | API key (defaults to `ELEVENLABS_API_KEY` env var) |
| `vad_silence_threshold_secs` | `float` | `0.3` | Silence duration (seconds) before VAD commits |
| `vad_threshold` | `float` | `0.4` | VAD sensitivity threshold for speech detection |
| `min_speech_duration_ms` | `int` | `100` | Minimum speech duration in milliseconds |
| `min_silence_duration_ms` | `int` | `100` | Minimum silence duration in milliseconds |
| `audio_chunk_duration_ms` | `int` | `100` | Audio chunk size sent to the server (100-1000ms) |

> [!TIP]
>
> ElevenLabs STT includes built-in turn detection via VAD. When you use `elevenlabs.STT`, the `Agent` automatically ignores any external `TurnDetector` plugin to prevent conflicts. You do not need to add a separate turn detection plugin.

## Next Steps

> [card] [ElevenLabs TTS](https://visionagents.ai/integrations/tts/elevenlabs.md)
>
> Expressive text-to-speech

> [card] [Build a Voice Agent](https://visionagents.ai/introduction/voice-agents.md)
>
> Get started with voice


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.