> ## 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.

# 보이스 클로닝

Cast CLI v1.0.9 이상에서는 로컬 WAV 또는 MP3 샘플로 퀵 클로닝과 프리미엄 클로닝을 모두 사용할 수 있습니다.

| 방식 | 적합한 용도 | 처리 방식 |
|------|-------------|-----------|
| 퀵 클로닝 | 빠른 미리보기와 임시 프로젝트 보이스 | 즉시 사용 가능한 보이스 ID 반환 |
| 프리미엄 클로닝 | 고품질 프로덕션 보이스 | 비동기 학습 후 상태 확인 필요 |

## 퀵 클로닝

```bash
cast voices clone sample.wav --name "My Clone"
```

기본 출력은 클로닝된 voice ID이므로 스크립트에서 바로 사용할 수 있습니다:

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

## JSON 출력으로 도구에 넘기기

```bash
cast voices clone sample.mp3 --name "Review Clone" --json
```

에이전트나 다른 도구가 클로닝된 voice ID와 다음 단계 값을 구조화해서 받아야 하면 JSON 출력을 사용하세요.

## 프리미엄 클로닝

`--professional`과 샘플 보이스의 언어 코드를 추가하세요. 명령을 실행하면 학습이 비동기로 진행되는 동안 새 `uc_` 보이스 ID가 출력됩니다.

```bash
voice_id=$(cast voices clone sample.wav --name "My Premium Voice" \
  --professional --language kor)
cast voices clone status "$voice_id"
```

상태가 `completed` 또는 `failed`가 될 때까지 확인하세요. 한국어 샘플은 `kor`, 영어 샘플은 `eng`를 사용합니다.

## 클로닝 보이스로 음성 생성

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

## 클로닝 보이스 정리

```bash
cast voices delete uc_xxx
```

## 제약

| 항목 | 값 |
|------|----|
| 입력 오디오 | WAV 또는 MP3 |
| 최대 파일 크기 | 25 MB |
| 보이스 이름 | 1-30자 |
| 모델 | `ssfm-v30` |
| 프리미엄 클로닝 | `--professional`, `--language` 필수 |

<Warning>
  클로닝 보이스는 프로젝트 자산처럼 관리하세요. 이름을 명확히 붙이고, 어떤 출력 파일에 사용했는지 기록하고, 임시 클론은 작업이 끝나면 삭제하세요.
</Warning>