기본값 설정
매번 플래그를 전달하지 않도록 기본값을 저장할 수 있습니다:
cast config set voice-id tc_xxx
cast config set model ssfm-v21
cast config set volume 120
cast config list
cast config unset volume
사용 가능한 키: voice-id, model, language, emotion, emotion-preset, emotion-intensity, volume, pitch, tempo, format, remove-silence-ms
우선순위
설정은 다음 우선순위로 적용됩니다:
--flag > 환경 변수 > ~/.typecast/config.yaml > 기본값
환경 변수
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 |
TYPECAST_REMOVE_SILENCE_MS | --remove-silence-ms |
무음 길이 조절
Cast v1.0.10 이상에서 --remove-silence-ms로 설정합니다. 기본값은 미설정이며 0이 아닙니다.
cast "Hello. Thank you for listening." --voice-id tc_672c5f5ce59fac2a48faeaee --remove-silence-ms 300
remove_silence_ms는 제거할 시간이 아니라 남길 무음 길이를 지정합니다. 0부터 1000ms까지의 정수를 사용하세요. 0은 검출된 무음을 제거하며, 생략하거나 null을 지정하면 지정 길이에 따른 무음 제거를 적용하지 않습니다.
일반·스트리밍·타임스탬프 TTS는 output.remove_silence_ms, Compose는 각 tts 세그먼트의 segments[].output.remove_silence_ms로 전달합니다. 반환 타임스탬프는 처리 후 오디오를 기준으로 하며, 명시적인 pause 세그먼트는 유지됩니다.
스트리밍의 기본 앞부분 무음 트림은 별개입니다. 특히 0처럼 작은 값에서는 재생 가능한 청크 수신에 간격이 생길 수 있으므로 충분한 재생 버퍼를 확보하고 실제 콘텐츠로 확인하세요.
export TYPECAST_REMOVE_SILENCE_MS=300
cast config set remove-silence-ms 300
cast config unset remove-silence-ms
환경 변수는 TYPECAST_REMOVE_SILENCE_MS, YAML 키는 remove_silence_ms입니다. 기존 우선순위(플래그 → 환경 변수 → 설정 파일 → 기본값)를 따릅니다.