CLI는 에이전트 스킬 안에서 쓰기 좋습니다. 타입캐스트 음성 생성을 셸 명령으로 노출하기 때문에, 에이전트가 텍스트를 작성하고 파일명을 정하고 cast를 호출해 재생 가능한 오디오 자산을 만들 수 있습니다.
스킬 지시문 템플릿
# 타입캐스트 음성 생성 스킬
사용자가 보이스오버, 내레이션, 대사, 오디오 미리듣기를 요청하면 CLI를 사용합니다.
Rules:
- Never expose the API key.
- Prefer `--out` so generated audio is saved as a file.
- Use descriptive filenames.
- Use `--emotion smart` for natural narration.
- Use preset emotion when the user specifies a tone.
- Use `--timestamps-out` when the user asks for captions, subtitles, timing, or lip-sync.
- Use `cast voices clone` only when the user provides or approves a voice sample.
- Report the output path after generation.
최소 명령 세트
| 작업 | 명령어 |
|---|---|
| 인증 확인 | cast "test" --out typecast-test.wav |
| 내레이션 생성 | cast "$(cat script.txt)" --emotion smart --out narration.wav |
| MP3 생성 | cast "$(cat script.txt)" --format mp3 --out narration.mp3 |
| 자막 생성 | cast "$(cat script.txt)" --out narration.wav --timestamps-out narration.srt |
| 음성 선택 | cast voices pick |
| 음성 클로닝 | cast voices clone sample.wav --name "Project Voice" |
| 기본 음성 저장 | cast config set voice-id tc_xxx |
에이전트 프롬프트 예시
타입캐스트 음성 생성 스킬을 사용해줘.
script.txt에서 보이스오버 테이크 3개를 만들어줘:
- neutral
- energetic
- soft
./voiceover 아래에 저장하고 파일명을 알려줘.
기능 라우팅
에이전트가 요청에 맞는 가장 작은 CLI 기능을 고르게 하세요:
| 사용자 요청 | 에이전트가 사용할 기능 |
|---|---|
| "이 문장을 말해줘" | --out 없이 cast "..." |
| "보이스오버 파일을 만들어줘" | cast "$(cat script.txt)" --out narration.wav |
| "자막도 같이 만들어줘" | --timestamps-out narration.srt 추가 |
| "이 샘플 목소리로 해줘" | cast voices clone sample.wav --name ... 후 --voice-id uc_xxx |
| "몇 가지 목소리를 미리 들어보고 싶어" | cast voices pick 또는 cast voices tournament |
권장 안전장치
프롬프트에 비밀키를 넣지 않기
API 키는 cast login 또는 TYPECAST_API_KEY로 보관하세요. 공유 프롬프트나 생성 문서에 키를 붙여넣지 마세요.
긴 스크립트는 파일로 전달하기
긴 원고는 한 줄 명령에 직접 넣기보다 cast "$(cat script.txt)" 형태를 권장합니다.
승인된 테이크 보존하기
리뷰가 끝난 오디오를 덮어쓰지 않도록, 수정본은 새 파일명으로 만들라고 에이전트에게 지시하세요.