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.

Interactive picker

Browse, preview, and select voices interactively:

cast voices pick
cast voices pick --gender female --age young_adult
cast voices pick --text "Custom preview sentence"

Tournament

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

cast voices tournament
cast voices tournament --gender female --size 16
cast voices tournament --text "Custom preview sentence"

Random voice

Pick a random voice for experimentation:

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:

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:

cast voices get <voice_id>

Recommend voices from a text description:

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

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.