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

# Voices

> Pick a voice that matches your agent's personality and language.

Pick any voice ID from the tables below and set it as `voice` when you create the agent:

<CodeGroup>
  ```bash cURL theme={null}
  curl -X POST https://agents.assemblyai.com/v1/agents \
    -H "Authorization: $ASSEMBLYAI_API_KEY" \
    -H "Content-Type: application/json" \
    -d '{
      "name": "Support Assistant",
      "system_prompt": "You are a friendly support agent. Keep replies under two sentences.",
      "voice": { "voice_id": "ivy" }
    }'
  ```

  ```python Python theme={null}
  # pip install requests
  import os
  import requests

  resp = requests.post(
      "https://agents.assemblyai.com/v1/agents",
      headers={"Authorization": os.environ["ASSEMBLYAI_API_KEY"]},
      json={
          "name": "Support Assistant",
          "system_prompt": "You are a friendly support agent. Keep replies under two sentences.",
          "voice": {"voice_id": "ivy"},
      },
  )
  resp.raise_for_status()
  print(resp.json())
  ```

  ```javascript Node.js theme={null}
  // Node 18+ has fetch built in
  const res = await fetch("https://agents.assemblyai.com/v1/agents", {
    method: "POST",
    headers: {
      Authorization: process.env.ASSEMBLYAI_API_KEY,
      "Content-Type": "application/json",
    },
    body: JSON.stringify({
      name: "Support Assistant",
      system_prompt: "You are a friendly support agent. Keep replies under two sentences.",
      voice: { voice_id: "ivy" },
    }),
  });
  const data = await res.json();
  console.log(data);
  ```
</CodeGroup>

Configuring inline over the WebSocket instead of on a stored agent? Set it on `session.output.voice` in a [`session.update`](/voice-agents/voice-agent-api/events-reference#sessionupdate) before `session.ready`:

```json theme={null}
{
  "type": "session.update",
  "session": {
    "output": { "voice": "ivy" }
  }
}
```

The voice is **immutable once the session is established**, so it can't be changed mid-conversation — pick it before the agent connects.

## Language support

The agent recognizes far more input languages than it speaks. For the authoritative, up-to-date matrix, see [Supported languages](/voice-agents/voice-agent-api/supported-languages).

In short:

* **Input (recognized):** 18 languages, with native code-switching.
* **Output (spoken):** 6 officially supported languages — 🇺🇸 English, 🇫🇷 French, 🇮🇹 Italian, 🇪🇸 Spanish, 🇮🇳 Hindi, and 🇷🇺 Russian — each backed by at least one voice below with a matching accent. More output languages are [on the roadmap](/voice-agents/voice-agent-api/supported-languages#coming-soon).

## Choose a voice by accent

Each voice has a primary accent:

* For 🇺🇸 **American English** — the right pick for an English agent — choose from [Voices](#voices).
* For a **native accent** in French, Italian, Spanish, Hindi, or Russian, choose the matching [language-specific voice](#language-specific-voices).

## Voices

These voices have an American English accent and are the recommended pick for English agents.

| Voice     | Accent | Description                           | Sample                                                         |
| --------- | ------ | ------------------------------------- | -------------------------------------------------------------- |
| `ivy`     | 🇺🇸   | Professional, deliberate, smooth      | <audio controls src="/docs/assets/audio/voices/ivy.mp3" />     |
| `james`   | 🇺🇸   | Conversational, professional, male    | <audio controls src="/docs/assets/audio/voices/james.mp3" />   |
| `tyler`   | 🇺🇸   | Theatrical, energetic, chatty, jagged | <audio controls src="/docs/assets/audio/voices/tyler.mp3" />   |
| `winter`  | 🇺🇸   | Empathetic, aesthetic, conversational | <audio controls src="/docs/assets/audio/voices/winter.mp3" />  |
| `bella`   | 🇺🇸   | High-pitched, chatty                  | <audio controls src="/docs/assets/audio/voices/bella.mp3" />   |
| `david`   | 🇺🇸   | Deep, calming, conversational         | <audio controls src="/docs/assets/audio/voices/david.mp3" />   |
| `kyle`    | 🇺🇸   | Chatty, nasal, expressive             | <audio controls src="/docs/assets/audio/voices/kyle.mp3" />    |
| `helen`   | 🇺🇸   | Soft, older, calming                  | <audio controls src="/docs/assets/audio/voices/helen.mp3" />   |
| `martha`  | 🇺🇸   | Southern, older, warm                 | <audio controls src="/docs/assets/audio/voices/martha.mp3" />  |
| `river`   | 🇺🇸   | Slow, calming, ASMR                   | <audio controls src="/docs/assets/audio/voices/river.mp3" />   |
| `emma`    | 🇺🇸   | Lively, young, conversational         | <audio controls src="/docs/assets/audio/voices/emma.mp3" />    |
| `victor`  | 🇺🇸   | Deep, older                           | <audio controls src="/docs/assets/audio/voices/victor.mp3" />  |
| `eleanor` | 🇺🇸   | Deeper, older, calming                | <audio controls src="/docs/assets/audio/voices/eleanor.mp3" /> |

## Language-specific voices

These voices have a native accent in a specific non-English language and code-switch naturally between that language and English.

| Voice    | Native accent                 | Description    | Sample                                                        |
| -------- | ----------------------------- | -------------- | ------------------------------------------------------------- |
| `arjun`  | 🇮🇳 Hindi/Hinglish           | Conversational | <audio controls src="/docs/assets/audio/voices/arjun.mp3" />  |
| `dmitri` | 🇷🇺 Russian                  | Conversational | <audio controls src="/docs/assets/audio/voices/dmitri.mp3" /> |
| `pierre` | 🇫🇷 French                   | Conversational | <audio controls src="/docs/assets/audio/voices/pierre.mp3" /> |
| `giulia` | 🇮🇹 Italian                  |                | <audio controls src="/docs/assets/audio/voices/giulia.mp3" /> |
| `luca`   | 🇮🇹 Italian                  |                | <audio controls src="/docs/assets/audio/voices/luca.mp3" />   |
| `lucia`  | 🇪🇸 Spanish                  |                | <audio controls src="/docs/assets/audio/voices/lucia.mp3" />  |
| `mateo`  | 🇪🇸 Spanish                  |                | <audio controls src="/docs/assets/audio/voices/mateo.mp3" />  |
| `diego`  | 🇨🇴 Spanish (Latin American) | Colombian      | <audio controls src="/docs/assets/audio/voices/diego.mp3" />  |