고객 지원API 콘솔로 이동
활용 예시

오디오북 생성

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

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

기본값 준비

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

cast config set voice-id tc_xxx
cast config set model ssfm-v30
cast config set format mp3

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

cast voices clone narrator-sample.wav --name "Narrator Draft"
cast config set voice-id uc_xxx

챕터 생성

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

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

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이 더 제어하기 쉽습니다:

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에 문맥을 함께 전달합니다:

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

에이전트 프롬프트 예시

챕터 텍스트 파일에서 오디오북 초안을 생성해줘.
모든 챕터에 같은 음성을 사용해줘.
출력은 ./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"
⌘I