> ## 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

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
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
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
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
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
cast voices get <voice_id>
```

Recommend voices from a text description:

```bash
cast voices recommend "warm female voice for product tutorials"
cast voices recommend "calm narrator for meditation" --count 5 --json
```

Recommendation results contain only `voice_id`, `voice_name`, and `score`. Run `cast voices get <voice_id>` or `cast voices list` when you need metadata such as supported models, emotions, gender, age, or use cases.

## Clone a voice

```bash
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.