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

# Breeze CLI voices

> Browse, design, clone, and manage Breeze voices from the terminal.

The `breeze voice` command family covers the full voice lifecycle: browse and audition voices, design new ones from a text description, clone from an audio sample, tune generation settings, and manage what you keep.

## Browse and audition

```bash theme={null}
breeze voice list
breeze voice search --query "calm documentary narrator"
breeze voice search --query "calm narrator" --voice-type personal --origin designed
breeze voice get <voice_id>
breeze voice play <voice_id>
```

`voice search` uses semantic and text relevance for public catalog voices and
text or identifier matching for personal voices. `voice list --search` remains
available for scripts that already use it and has the same search behavior.

`--voice-type` accepts `all`, `default`, or `personal`; results are paged with `--page` and `--page-size`.
`--origin` accepts `designed` or `cloned`.

## Design a voice

`breeze voice design` generates voice previews from a description. It consumes account credits.

```bash theme={null}
breeze voice design --description "Warm, unhurried narrator with a low register" \
  --text "This is how your story will sound."
```

Useful flags:

* `--preview-count` — number of previews to generate (default 1).
* `--text` — the line each preview speaks.
* `--format` — `wav` or `mp3`.
* `--play-all` — play every preview in sequence; `--no-play` skips playback.
* `--guidance-scale` — how strongly generation follows the description; omitted, Breeze varies it per preview.

## Work with previews

Design and clone produce previews identified by a `generated_voice_id`. Play or download them, then save the keeper as a voice:

```bash theme={null}
breeze voice preview play <generated_voice_id>
breeze voice preview download <generated_voice_id> -o preview.mp3
breeze voice preview save <generated_voice_id> --name "Story narrator" \
  --description "Warm long-form narration voice" --language en
```

`voice preview save` creates a saved voice in your account. Add `--label key=value` (repeatable) to tag it. If `--language` is omitted, Breeze reuses the generation language and falls back to `en` for legacy previews without language metadata.

## Clone a voice

`breeze voice clone` creates a voice clone preview from an audio sample you are authorized to use. It consumes account credits.

```bash theme={null}
breeze voice clone --file sample.wav --name "My voice" --text "Preview line to speak"
```

Save the resulting preview with `breeze voice preview save`, the same as designed voices.

## Voice settings

Saved voices carry generation settings that apply when the voice is used:

```bash theme={null}
breeze voice settings get <voice_id>
breeze voice settings edit <voice_id> --speed 1.1 --stability 0.6
```

`voice settings edit` accepts `--guidance-scale`, `--stability`, `--similarity-boost`, `--style`, `--speed`, and `--use-speaker-boost`; pass at least one.

## Manage saved voices

```bash theme={null}
breeze voice edit <voice_id> --name "Story narrator v2" --language en
breeze voice delete <voice_id> --yes
```

`voice edit --language` corrects a saved voice's language. Supported values are `ar`, `cs`, `de`, `el`, `en`, `es`, `fi`, `fr`, `hi`, `id`, `it`, `ja`, `ko`, `nl`, `pl`, `pt`, `ro`, `ru`, `th`, `tr`, `uk`, `vi`, and `zh`.

`voice delete` removes the voice from your Breeze account. It asks for confirmation in interactive terminals; scripts and agents must pass `--yes` or the command fails with a usage error.