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

# 음성 클로닝

> CLI로 커스텀 클로닝 음성을 생성하고 사용합니다.

CLI는 로컬 WAV 또는 MP3 샘플에서 커스텀 음성을 만들고, 새 `uc_` voice ID를 출력한 뒤, 해당 음성을 텍스트 음성 변환에 사용할 수 있습니다.

## 샘플에서 클로닝

```bash theme={null}
cast voices clone sample.wav --name "My Clone"
```

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

```bash theme={null}
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 theme={null}
cast voices clone sample.mp3 --name "Review Clone" --json
```

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

## 클로닝 음성으로 음성 생성

```bash theme={null}
cast "Hello from my cloned voice." \
  --voice-id uc_xxx \
  --emotion smart \
  --out cloned.wav
```

## 클로닝 음성 정리

```bash theme={null}
cast voices delete uc_xxx
```

## 제약

| 항목       | 값          |
| -------- | ---------- |
| 입력 오디오   | WAV 또는 MP3 |
| 최대 파일 크기 | 25 MB      |
| 음성 이름    | 1-30자      |
| 모델       | `ssfm-v30` |

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