Overview - Typecast Documentation

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

Workflow	Command
Play speech immediately	`cast "Hello, world!"`
Save a WAV file	`cast "Hello, world!" --out hello.wav`
Save an MP3 file	`cast "Hello, world!" --out hello.mp3 --format mp3`
Generate SRT captions	`cast "Hello, world." --out hello.wav --timestamps-out hello.srt`
Generate WebVTT captions	`cast "Hello, world." --out hello.wav --timestamps-out hello.vtt --timestamps-format vtt`
Use smart emotion	`cast "I can't believe it!" --emotion smart`
Pick a voice interactively	`cast voices pick`
Clone a custom voice	`cast voices clone sample.wav --name "My Clone"`
Set a default voice	`cast 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.

Install the CLI

Generate speech

Create captions

Find voices

Clone a voice

Configure defaults

​What you can repeat

​Next steps

Quick installation

Recipes

What you can repeat

Next steps