> ## Documentation Index
> Fetch the complete documentation index at: https://typecast.ai/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Voice cloning

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

```bash
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:

```bash
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

```bash
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.

```bash
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

```bash
cast "Hello from my cloned voice." \
  --voice-id uc_xxx \
  --emotion smart \
  --out cloned.wav
```

## Clean up cloned voices

```bash
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 |

<Warning>
  Treat cloned voices as project assets. Name them clearly, record which output files used them, and delete temporary clones when the workflow is done.
</Warning>