Skip to main content
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

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.
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:
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.
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:
voice settings edit accepts --guidance-scale, --stability, --similarity-boost, --style, --speed, and --use-speaker-boost; pass at least one.

​
Manage saved voices

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.