> ## 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에서 타입캐스트 음성을 탐색, 미리듣기, 선택, 자동화합니다.

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

## 인터랙티브 피커

음성을 인터랙티브하게 탐색, 미리듣기, 선택할 수 있습니다:

```bash theme={null}
cast voices pick
cast voices pick --gender female --age young_adult
cast voices pick --text "미리듣기 문장"
```

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

## 토너먼트

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

```bash theme={null}
cast voices tournament
cast voices tournament --gender female --size 16
cast voices tournament --text "미리듣기 문장"
```

| 키     | 동작        |
| ----- | --------- |
| **P** | 음성 1 미리듣기 |
| **Q** | 음성 2 미리듣기 |
| **1** | 음성 1 선택   |
| **2** | 음성 2 선택   |

## 랜덤 음성

실험용으로 랜덤 음성을 선택합니다:

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

## 목록 및 상세 조회

필터를 사용하여 음성을 조회합니다:

```bash theme={null}
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 theme={null}
cast voices get <voice_id>
```

텍스트 설명으로 음성을 추천받습니다:

```bash theme={null}
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 theme={null}
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
```

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