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

# 보이스

보이스 명령으로 기본 제공 보이스를 찾거나 기본 보이스를 저장하고, 프로젝트용 커스텀 클로닝 보이스를 만들 수 있습니다. 클로닝 전용 예시는 [보이스 클로닝](/ko/cli-reference/voice-cloning)을 참고하세요.

## 인터랙티브 피커

보이스를 인터랙티브하게 탐색, 미리듣기, 선택할 수 있습니다:

```bash
cast voices pick
cast voices pick --gender female --age young_adult
cast voices pick --text "미리듣기 문장"
```

| 키 | 동작 |
|----|------|
| **P** | 현재 모델/감정 프리셋으로 미리듣기 |
| **E** | 스마트 이모션으로 미리듣기 (`ssfm-v30` 전용) |
| **S** | 기본 보이스로 설정 |
| **C** | 보이스 ID를 클립보드에 복사 |
| **Enter** | 확인 후 보이스 ID 출력 |
| **Esc** | 뒤로가기 |

## 토너먼트

일대일 토너먼트 방식으로 가장 마음에 드는 보이스를 찾을 수 있습니다:

```bash
cast voices tournament
cast voices tournament --gender female --size 16
cast voices tournament --text "미리듣기 문장"
```

| 키 | 동작 |
|----|------|
| **P** | 보이스 1 미리듣기 |
| **Q** | 보이스 2 미리듣기 |
| **1** | 보이스 1 선택 |
| **2** | 보이스 2 선택 |

## 랜덤 보이스

실험용으로 랜덤 보이스를 선택합니다:

```bash
cast voices random
cast voices random --gender female --age young_adult
cast "Hello!" --voice-id $(cast voices random --model ssfm-v30 --gender female)
```

## 목록 및 상세 조회

필터를 사용하여 보이스를 조회합니다:

```bash
cast voices list
cast voices list --gender female
cast voices list --age young_adult
cast voices list --model ssfm-v30
cast voices list --use-case Audiobook
cast voices list --json
```

사용 가능한 용도: `Announcer`, `Anime`, `Audiobook`, `Conversational`, `Documentary`, `E-learning`, `Rapper`, `Game`, `Tiktok/Reels`, `News`, `Podcast`, `Voicemail`, `Ads`

특정 보이스의 상세 정보를 조회합니다:

```bash
cast voices get <voice_id>
```

텍스트 설명으로 보이스를 추천받습니다:

```bash
cast voices recommend "warm female voice for product tutorials"
cast voices recommend "calm narrator for meditation" --count 5 --json
```

추천 결과에는 `voice_id`, `voice_name`, `score`만 포함됩니다. 지원 모델, 감정, 성별, 나이대, 사용 사례 같은 메타데이터가 필요하면 `cast voices get <voice_id>` 또는 `cast voices list`를 함께 사용하세요.

## 보이스 클로닝

```bash
cast voices clone sample.wav --name "My Clone"
cast "Hello from my cloned voice." --voice-id uc_xxx --out cloned.wav
cast voices delete uc_xxx
```

프로젝트 전용 리뷰 보이스, 내레이션 초안, 반복 콘텐츠 생성에는 클로닝한 보이스를 사용할 수 있습니다.