Skip to main content
Save one Typecast command, and you can make the same kind of audio again whenever you need it. Use the command yourself, keep it in a note, or hand it to an AI agent so it can generate speech, save files, and create captions with the same settings every time. This is useful when you create content repeatedly and do not want to rebuild the same Typecast request from scratch. Learn one or two commands, then reuse them for drafts, narration, voice previews, subtitles, and agent-driven production tasks. 
cast "Hello, world!"
cast "Hello, world!" --voice-id tc_xxx --out hello.wav
cast "Hello, world." --out hello.wav --timestamps-out hello.srt
cast "I just got promoted!" --emotion smart

Install the CLI

Install with Homebrew or Go, then authenticate with your Typecast API key.

Generate speech

Convert text into playable audio or WAV/MP3 files with model, voice, and delivery controls.

Create captions

Generate timestamp alignment data, SRT, or WebVTT subtitles alongside audio.

Find voices

List, preview, pick, randomize, or run voice tournaments directly from the command line.

Clone a voice

Create a temporary custom voice from a WAV or MP3 sample and use it with the CLI.

Configure defaults

Store defaults in config, environment variables, or flags depending on your workflow.

​
What you can repeat

WorkflowCommand
Play speech immediatelycast "Hello, world!"
Save a WAV filecast "Hello, world!" --out hello.wav
Save an MP3 filecast "Hello, world!" --out hello.mp3 --format mp3
Generate SRT captionscast "Hello, world." --out hello.wav --timestamps-out hello.srt
Generate WebVTT captionscast "Hello, world." --out hello.wav --timestamps-out hello.vtt --timestamps-format vtt
Use smart emotioncast "I can't believe it!" --emotion smart
Pick a voice interactivelycast voices pick
Clone a custom voicecast voices clone sample.wav --name "My Clone"
Set a default voicecast config set voice-id tc_xxx
The CLI requires a Typecast API key. Get one from the Typecast API Console.

​
Next steps

Quick installation

Set up the CLI and run your first synthesis command.

Recipes

Use the CLI in scripts, pipes, batch jobs, and content workflows.