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

# 설정

## 기본값 설정

매번 플래그를 전달하지 않도록 기본값을 저장할 수 있습니다:

```bash
cast config set voice-id tc_xxx
cast config set model ssfm-v21
cast config set volume 120

cast config list
cast config unset volume
```

사용 가능한 키: `voice-id`, `model`, `language`, `emotion`, `emotion-preset`, `emotion-intensity`, `volume`, `pitch`, `tempo`, `format`, `remove-silence-ms`

## 우선순위

설정은 다음 우선순위로 적용됩니다:

```text
--flag  >  환경 변수  >  ~/.typecast/config.yaml  >  기본값
```

## 환경 변수

`TYPECAST_` 접두사를 사용하여 모든 옵션을 환경 변수로 설정할 수 있습니다:

| 변수 | 플래그 |
|------|--------|
| `TYPECAST_API_KEY` | `--api-key` |
| `TYPECAST_VOICE_ID` | `--voice-id` |
| `TYPECAST_MODEL` | `--model` |
| `TYPECAST_LANGUAGE` | `--language` |
| `TYPECAST_EMOTION` | `--emotion` |
| `TYPECAST_EMOTION_PRESET` | `--emotion-preset` |
| `TYPECAST_EMOTION_INTENSITY` | `--emotion-intensity` |
| `TYPECAST_FORMAT` | `--format` |
| `TYPECAST_VOLUME` | `--volume` |
| `TYPECAST_PITCH` | `--pitch` |
| `TYPECAST_TEMPO` | `--tempo` |
| `TYPECAST_REMOVE_SILENCE_MS` | `--remove-silence-ms` |

## 무음 길이 조절

**Cast v1.0.10 이상**에서 `--remove-silence-ms`로 설정합니다. 기본값은 미설정이며 `0`이 아닙니다.

```bash
cast "Hello. Thank you for listening." --voice-id tc_672c5f5ce59fac2a48faeaee --remove-silence-ms 300
```

`remove_silence_ms`는 제거할 시간이 아니라 **남길 무음 길이**를 지정합니다. `0`부터 `1000`ms까지의 정수를 사용하세요. `0`은 검출된 무음을 제거하며, 생략하거나 `null`을 지정하면 지정 길이에 따른 무음 제거를 적용하지 않습니다.

일반·스트리밍·타임스탬프 TTS는 `output.remove_silence_ms`, Compose는 각 `tts` 세그먼트의 `segments[].output.remove_silence_ms`로 전달합니다. 반환 타임스탬프는 처리 후 오디오를 기준으로 하며, 명시적인 `pause` 세그먼트는 유지됩니다.

스트리밍의 기본 앞부분 무음 트림은 별개입니다. 특히 `0`처럼 작은 값에서는 재생 가능한 청크 수신에 간격이 생길 수 있으므로 충분한 재생 버퍼를 확보하고 실제 콘텐츠로 확인하세요.

```bash
export TYPECAST_REMOVE_SILENCE_MS=300
cast config set remove-silence-ms 300
cast config unset remove-silence-ms
```

환경 변수는 `TYPECAST_REMOVE_SILENCE_MS`, YAML 키는 `remove_silence_ms`입니다. 기존 우선순위(플래그 → 환경 변수 → 설정 파일 → 기본값)를 따릅니다.