> ## 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를 쓰면 에이전트가 스크립트 초안에서 음성 파일까지 한 흐름으로 만들 수 있습니다.

## 추천 흐름

<Steps>
  <Step title="에이전트에게 짧은 스크립트 요청">
    자막과 편집을 고려해 문장을 짧게 유지합니다.

    ```text theme={null}
    25초 쇼츠 스크립트를 작성해줘.
    - 시작 훅 1개
    - 짧은 본문 3문장
    - 마지막 행동 유도 1문장
    ```
  </Step>

  <Step title="초안 음성 생성">
    ```bash theme={null}
    cast "타입캐스트 음성을 가장 빠르게 테스트하는 방법입니다." \
      --emotion smart \
      --out shorts-scratch.wav
    ```
  </Step>

  <Step title="훅 대체안 생성">
    ```bash theme={null}
    cast "Stop scrolling. Your app can speak in one command." \
      --emotion preset --emotion-preset happy --emotion-intensity 1.3 \
      --out hook-a.wav

    cast "Here is a terminal trick for instant AI voiceovers." \
      --emotion smart \
      --out hook-b.wav
    ```
  </Step>

  <Step title="최종 오디오 저장">
    ```bash theme={null}
    cast "$(cat shorts-script.txt)" \
      --voice-id tc_xxx \
      --emotion smart \
      --format mp3 \
      --out shorts-final.mp3
    ```
  </Step>

  <Step title="같은 테이크에서 자막 생성">
    ```bash theme={null}
    cast "$(cat shorts-script.txt)" \
      --voice-id tc_xxx \
      --emotion smart \
      --out shorts-final.wav \
      --timestamps-out shorts-final.srt
    ```
  </Step>
</Steps>

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

```text theme={null}
쇼츠용 보이스오버를 만들어줘.
먼저 스크립트를 작성하고 다음 파일을 생성해줘:
1. hook-a.wav
2. hook-b.wav
3. final.mp3
4. final.srt

CLI를 사용하고, 같은 최종 스크립트에서 자막을 생성하고, 승인된 테이크를 덮어쓰지 마.
```

## 실무 팁

| 목표           | CLI 옵션                                                            |
| ------------ | ----------------------------------------------------------------- |
| 빠른 전달감       | `--tempo 1.08` \~ `--tempo 1.18`                                  |
| 에너지 있는 낭독    | `--emotion preset --emotion-preset happy --emotion-intensity 1.2` |
| 자연스러운 문맥     | `--emotion smart --prev-text ... --next-text ...`                 |
| 편집기용 파일      | `--out final.mp3 --format mp3`                                    |
| 자막 import    | `--timestamps-out final.srt`                                      |
| 웹 preview 자막 | `--timestamps-out final.vtt --timestamps-format vtt`              |
| 캠페인 전용 음성    | `cast voices clone sample.wav --name "Campaign Voice"`            |
| 재현 가능한 초안    | `--seed 42`                                                       |

## 자동화하면 좋은 부분

| 쇼츠 작업           | 추천 CLI 기능                                            |
| --------------- | ---------------------------------------------------- |
| 시작 훅 A/B 테스트    | `hook-a.wav`, `hook-b.wav`를 별도 파일로 생성                |
| 편집용 자막          | `--timestamps-out final.srt`                         |
| 브라우저 preview 자막 | `--timestamps-out final.vtt --timestamps-format vtt` |
| 브랜드/크리에이터 음성    | `cast voices clone` 후 `--voice-id uc_xxx` 사용         |
| 회의 중 빠른 리뷰      | `--out` 없이 `cast "short sentence"`로 즉시 재생            |

<Tip>
  훅은 별도 파일로 생성하세요. 전체 내레이션을 다시 만들지 않아도 시작 부분만 빠르게 비교할 수 있습니다.
</Tip>