> ## 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를 설치하고 시작하세요.

타입캐스트 명령어 한 줄만 저장해두면, 같은 방식의 음성을 언제든 다시 만들 수 있습니다. 직접 실행해도 되고, 메모에 남겨두어도 되고, AI 에이전트에게 전달해서 매번 같은 설정으로 음성 파일과 자막을 만들게 할 수도 있습니다.

반복해서 콘텐츠를 만들 때마다 같은 타입캐스트 요청을 처음부터 다시 구성할 필요가 없습니다. 한두 개의 명령어만 익혀두면 초안 음성, 내레이션, 보이스 미리듣기, 자막 생성, 에이전트 기반 제작 작업을 명령어 단위로 재사용할 수 있습니다.

```bash theme={null}
cast "Hello, world!"
cast "Hello, world!" --voice-id tc_xxx --out hello.wav
cast "Hello, world." --out hello.wav --timestamps-out hello.srt
cast "I just got promoted!" --emotion smart
```

<CardGroup cols={2}>
  <Card title="CLI 설치" icon="download" href="/ko/cli-reference/installation">
    Homebrew 또는 Go로 설치하고 타입캐스트 API 키로 인증합니다.
  </Card>

  <Card title="음성 생성" icon="volume-high" href="/ko/cli-reference/synthesis">
    모델, 음성, 감정, 출력 파일 옵션을 조합해 음성을 생성합니다.
  </Card>

  <Card title="자막 생성" icon="closed-captioning" href="/ko/cli-reference/timestamps-captions">
    오디오와 함께 타임스탬프 JSON, SRT, WebVTT 자막을 생성합니다.
  </Card>

  <Card title="음성 찾기" icon="microphone" href="/ko/cli-reference/voices">
    CLI에서 음성을 조회, 미리듣기, 선택, 랜덤 추출할 수 있습니다.
  </Card>

  <Card title="음성 클로닝" icon="user-plus" href="/ko/cli-reference/voice-cloning">
    WAV 또는 MP3 샘플로 커스텀 음성을 만들고 CLI에서 사용합니다.
  </Card>

  <Card title="기본값 설정" icon="gear" href="/ko/cli-reference/configuration">
    설정 파일, 환경 변수, 플래그로 CLI 기본값을 관리합니다.
  </Card>
</CardGroup>

## 반복할 수 있는 일

| 워크플로우        | 명령어                                                                                       |
| ------------ | ----------------------------------------------------------------------------------------- |
| 음성 바로 재생     | `cast "Hello, world!"`                                                                    |
| WAV 파일 저장    | `cast "Hello, world!" --out hello.wav`                                                    |
| MP3 파일 저장    | `cast "Hello, world!" --out hello.mp3 --format mp3`                                       |
| SRT 자막 생성    | `cast "Hello, world." --out hello.wav --timestamps-out hello.srt`                         |
| WebVTT 자막 생성 | `cast "Hello, world." --out hello.wav --timestamps-out hello.vtt --timestamps-format vtt` |
| 스마트 이모션 사용   | `cast "I can't believe it!" --emotion smart`                                              |
| 음성 인터랙티브 선택  | `cast voices pick`                                                                        |
| 커스텀 음성 클로닝   | `cast voices clone sample.wav --name "My Clone"`                                          |
| 기본 음성 설정     | `cast config set voice-id tc_xxx`                                                         |

<Info>
  CLI 사용에는 타입캐스트 API 키가 필요합니다. [타입캐스트 API 콘솔](https://typecast.ai/developers/api)에서 키를 발급받으세요.
</Info>