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

# 오디오북 생성

> AI 에이전트가 CLI로 챕터 오디오와 감정 연출 파일을 생성하는 방법입니다.

오디오북 생성에는 일관된 음성, 반복 가능한 파일명, 챕터 단위 출력이 중요합니다. CLI를 쓰면 에이전트가 챕터 초안 생성, 특정 구간 재생성, 승인본 분리를 단순한 명령으로 처리할 수 있습니다.

## 기본값 준비

챕터를 생성하기 전에 음성과 모델을 설정합니다:

```bash theme={null}
cast config set voice-id tc_xxx
cast config set model ssfm-v30
cast config set format mp3
```

프로젝트 전용 음성이 필요하면 먼저 클로닝하고 반환된 `uc_` voice ID를 저장합니다:

```bash theme={null}
cast voices clone narrator-sample.wav --name "Narrator Draft"
cast config set voice-id uc_xxx
```

## 챕터 생성

```bash theme={null}
cast "$(cat chapter-01.txt)" \
  --emotion smart \
  --out audiobook/chapter-01.mp3 \
  --format mp3

cast "$(cat chapter-02.txt)" \
  --emotion smart \
  --out audiobook/chapter-02.mp3 \
  --format mp3
```

## 자막 또는 리뷰용 타이밍 생성

```bash theme={null}
cast "$(cat chapter-01.txt)" \
  --emotion smart \
  --out audiobook/chapter-01.wav \
  --timestamps-out audiobook/chapter-01.timestamps.json
```

상세 타이밍 검토에는 JSON을 사용하고, 오디오북 콘텐츠를 영상 preview로도 보여줘야 하면 `.srt` 또는 `.vtt`로 저장하세요.

## 장면별 감정 연출

톤이 명확한 짧은 구간은 preset emotion이 더 제어하기 쉽습니다:

```bash theme={null}
cast "The room fell silent as the letter slipped from her hand." \
  --emotion preset \
  --emotion-preset sad \
  --emotion-intensity 1.2 \
  --out audiobook/scene-letter.mp3
```

앞뒤 문맥이 중요한 구간은 smart emotion에 문맥을 함께 전달합니다:

```bash theme={null}
cast "She opened the door and froze." \
  --emotion smart \
  --prev-text "The hallway had been empty a moment ago." \
  --next-text "A familiar voice whispered her name." \
  --out audiobook/scene-door.mp3
```

## 에이전트 프롬프트 예시

```text theme={null}
챕터 텍스트 파일에서 오디오북 초안을 생성해줘.
모든 챕터에 같은 음성을 사용해줘.
출력은 ./audiobook 아래에 저장해줘.
챕터마다 MP3 파일 1개를 생성해줘.
영상 preview가 필요한 챕터는 오디오 옆에 SRT 파일도 생성해줘.
실패한 챕터가 있으면 파일명을 보고하고 계속 진행해줘.
```

## 파일명 규칙

| 자산      | 추천 파일명                       |
| ------- | ---------------------------- |
| 전체 챕터   | `chapter-01.mp3`             |
| 장면 수정본  | `chapter-01-scene-03-v2.mp3` |
| 승인된 최종본 | `chapter-01-final.mp3`       |
| 대체 전달 톤 | `chapter-01-alt-happy.mp3`   |

## 고급 기능 사용 기준

| 필요             | 추천 기능                                                           |
| -------------- | --------------------------------------------------------------- |
| 일관된 내레이터 정체성   | `cast config set voice-id ...`                                  |
| 샘플과 맞춘 임시 내레이터 | `cast voices clone narrator-sample.wav --name "Narrator Draft"` |
| 챕터 리뷰용 타이밍     | `--timestamps-out chapter-01.timestamps.json`                   |
| 챕터 영상 preview  | `--timestamps-out chapter-01.srt`                               |
| 빠른 승인 재생       | `--out` 없이 `cast "one review sentence"`                         |

<Warning>
  승인된 오디오는 덮어쓰지 마세요. 수정본은 `-v2`, `-v3` 또는 톤 이름을 붙여 저장하도록 에이전트에게 지시하세요.
</Warning>