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

# Voices

> Browse, preview, select, and automate Typecast voices from the CLI.

Use voice commands to find a stock voice, save a default voice, or create a custom cloned voice for a project. For cloning-specific examples, see [Voice cloning](/cli-reference/voice-cloning).

## Interactive picker

Browse, preview, and select voices interactively:

```bash theme={null}
cast voices pick
cast voices pick --gender female --age young_adult
cast voices pick --text "Custom preview sentence"
```

| Key       | Action                                       |
| --------- | -------------------------------------------- |
| **P**     | Preview with current model/emotion preset    |
| **E**     | Preview with smart emotion (`ssfm-v30` only) |
| **S**     | Set as default voice                         |
| **C**     | Copy voice ID to clipboard                   |
| **Enter** | Confirm and print voice ID                   |
| **Esc**   | Go back                                      |

## Tournament

Find your favorite voice through head-to-head elimination:

```bash theme={null}
cast voices tournament
cast voices tournament --gender female --size 16
cast voices tournament --text "Custom preview sentence"
```

| Key   | Action          |
| ----- | --------------- |
| **P** | Preview voice 1 |
| **Q** | Preview voice 2 |
| **1** | Pick voice 1    |
| **2** | Pick voice 2    |

## Random voice

Pick a random voice for experimentation:

```bash theme={null}
cast voices random
cast voices random --gender female --age young_adult
cast "Hello!" --voice-id $(cast voices random --model ssfm-v30 --gender female)
```

## List and get voices

List voices with filters:

```bash theme={null}
cast voices list
cast voices list --gender female
cast voices list --age young_adult
cast voices list --model ssfm-v30
cast voices list --use-case Audiobook
cast voices list --json
```

Available use cases: `Announcer`, `Anime`, `Audiobook`, `Conversational`, `Documentary`, `E-learning`, `Rapper`, `Game`, `Tiktok/Reels`, `News`, `Podcast`, `Voicemail`, `Ads`

Get details for a specific voice:

```bash theme={null}
cast voices get <voice_id>
```

## Clone a voice

```bash theme={null}
cast voices clone sample.wav --name "My Clone"
cast "Hello from my cloned voice." --voice-id uc_xxx --out cloned.wav
cast voices delete uc_xxx
```

Use cloned voices when an agent needs a project-specific voice for review, narration drafts, or repeatable content generation.