Cast CLI v1.0.9 or later supports both Instant Voice Cloning and Professional Voice Cloning from a local WAV or MP3 sample.
| Mode | Best for | Processing |
|---|---|---|
| Instant cloning | Fast previews and temporary project voices | Returns a ready-to-use voice ID immediately |
| Professional Cloning | Higher-quality production voices | Trains asynchronously and requires status checks |
Instant Voice Cloning
cast voices clone sample.wav --name "My Clone"
The command prints the cloned voice ID by default, which makes it easy to use in scripts:
voice_id=$(cast voices clone sample.wav --name "Review Clone")
cast "Short test line." --voice-id "$voice_id" --out review.wav
cast voices delete "$voice_id"
Use JSON output for handoff
cast voices clone sample.mp3 --name "Review Clone" --json
Use JSON when an agent or another tool needs structured fields such as the cloned voice ID and suggested next-step values.
Professional Voice Cloning
Add --professional and the sample language code. The command prints a new uc_ voice ID while training continues asynchronously.
voice_id=$(cast voices clone sample.wav --name "My Premium Voice" \
--professional --language eng)
cast voices clone status "$voice_id"
Check the status until it becomes completed or failed. Use kor for Korean samples and eng for English samples.
Generate speech with the cloned voice
cast "Hello from my cloned voice." \
--voice-id uc_xxx \
--emotion smart \
--out cloned.wav
Clean up cloned voices
cast voices delete uc_xxx
Constraints
| Constraint | Value |
|---|---|
| Input audio | WAV or MP3 |
| Max file size | 25 MB |
| Voice name | 1-30 characters |
| Model | ssfm-v30 |
| Professional Cloning | --professional and --language are required |