Typecast CLI(
cast)를 사용하면 터미널에서 바로 텍스트를 음성으로 변환할 수 있습니다. 즉시 오디오를 재생하거나, 파일로 저장하고, 음성을 인터랙티브하게 탐색하고, 감정을 제어할 수 있습니다. 타입캐스트 API 키가 필요합니다.설치
로그인
빠른 시작
기본적으로
cast는 오디오를 즉시 재생합니다. --out 플래그를 사용하면 WAV 또는 MP3 파일로 저장할 수 있습니다.기능
옵션
| 플래그 | 설명 | 기본값 |
|---|---|---|
--voice-id | Voice ID | tc_60e5426de8b95f1d3000d7b5 |
--model | 모델 (ssfm-v30, ssfm-v21) | ssfm-v30 |
--language | 언어 코드 (ISO 639-3) | 자동 감지 |
--emotion | 감정 유형: smart, preset | |
--emotion-preset | 이모션 프리셋 (--emotion preset 필요) | |
--emotion-intensity | 감정 강도 0.0–2.0 (--emotion preset 필요) | 1.0 |
--prev-text | 문맥을 위한 이전 문장 (--emotion smart 전용) | |
--next-text | 문맥을 위한 다음 문장 (--emotion smart 전용) | |
--volume | 볼륨 (0–200) | 100 |
--pitch | 피치 (반음 단위, -12 ~ +12) | 0 |
--tempo | 템포 배율 (0.5–2.0) | 1.0 |
--format | 출력 형식 (wav, mp3) | wav |
--seed | 재현 가능한 출력을 위한 부호 없는 정수 시드 (≥ 0) | |
--out | 재생 대신 파일로 저장 |
모델
| 모델 | 언어 | 감정 | 지연시간 |
|---|---|---|---|
ssfm-v30 | 37개 | 7개 프리셋 + 스마트 이모션 | 표준 |
ssfm-v21 | 27개 | 4개 프리셋 (normal, happy, sad, angry) | 낮음 |
감정
- 스마트 이모션
- 이모션 프리셋
AI가 텍스트에서 적절한 감정을 자동으로 추론합니다. 더 나은 문맥을 위해 앞뒤 문장을 제공할 수 있습니다:
ssfm-v30에서만 사용 가능합니다.음성
인터랙티브 피커
인터랙티브 피커
음성을 인터랙티브하게 탐색, 미리듣기, 선택할 수 있습니다:입력하여 필터링한 후 다음 키를 사용하세요:
| 키 | 동작 |
|---|---|
| P | 현재 모델/감정 프리셋으로 미리듣기 |
| E | 스마트 이모션으로 미리듣기 (ssfm-v30 전용) |
| S | 기본 음성으로 설정 |
| C | Voice ID를 클립보드에 복사 |
| Enter | 확인 후 Voice ID 출력 |
| Esc | 뒤로가기 |
토너먼트
토너먼트
일대일 토너먼트 방식으로 가장 마음에 드는 음성을 찾을 수 있습니다:
| 키 | 동작 |
|---|---|
| P | 음성 1 미리듣기 |
| Q | 음성 2 미리듣기 |
| 1 | 음성 1 선택 |
| 2 | 음성 2 선택 |
랜덤
랜덤
랜덤으로 음성을 선택합니다:
목록 & 상세 조회
목록 & 상세 조회
필터를 사용하여 음성을 조회합니다:사용 가능한 용도:
Announcer, Anime, Audiobook, Conversational, Documentary, E-learning, Rapper, Game, Tiktok/Reels, News, Podcast, Voicemail, Ads특정 음성의 상세 정보를 조회합니다:설정
매번 플래그를 전달하지 않도록 기본값을 설정할 수 있습니다:voice-id, model, language, emotion, emotion-preset, emotion-intensity, volume, pitch, tempo, format
설정은 다음 우선순위로 적용됩니다:
환경 변수
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 |
활용 예시
파일에서 텍스트 읽기
파일에서 텍스트 읽기
파이프로 입력
파이프로 입력
배치 오디오 파일 생성
배치 오디오 파일 생성
오디오북 감정 연출
오디오북 감정 연출
스마트 이모션으로 자연스러운 전달
스마트 이모션으로 자연스러운 전달
고정 시드로 재현 가능한 출력
고정 시드로 재현 가능한 출력
다른 언어 사용
다른 언어 사용
전달 스타일 조정
전달 스타일 조정
문제 해결
cast: command not found
cast: command not found
- 설치가 정상적으로 완료되었는지 확인하세요
- Homebrew:
brew list neosapience/tap/cast로 확인 - Go:
$GOPATH/bin이PATH에 포함되어 있는지 확인 - 새 터미널 세션을 열어보세요
인증 오류
인증 오류
cast login으로 API 키를 다시 입력하세요- 타입캐스트 API 콘솔에서 키가 유효한지 확인하세요
cast logout후cast login으로 초기화하세요
오디오가 재생되지 않음
오디오가 재생되지 않음
- 파일로 저장해보세요:
cast "test" --out test.wav - 시스템 오디오 출력 장치를 확인하세요
- 시스템 볼륨이 음소거 상태가 아닌지 확인하세요
리소스
GitHub
소스 코드 및 릴리스
API 레퍼런스
타입캐스트 API 탐색하기
음성 라이브러리
사용 가능한 음성 둘러보기
타입캐스트 API 콘솔
API 홈