솔라피 시작하기

가이드

타입캐스트 AI 노드 가이드

작성일 2026.03.20 | 수정일 2026.03.20

타입캐스트 AI 노드 가이드

Typecast AI 공식 SDK를 사용하여 고품질 한국어 음성 합성(TTS)을 수행하는 노드입니다.

주요 기능

작업	설명
Synthesize Speech	Typecast AI SDK를 사용하여 텍스트를 음성으로 변환

설정 항목

기본 설정

항목	타입	기본값	설명
Text	문자열	-	음성으로 변환할 텍스트 (필수). 빈 텍스트 시 1초 무음 WAV 생성
Voice ID	문자열	-	Typecast AI 음성 ID (필수, 예: `tc_62a8975e695ad26f7fb514d1`)
Model	선택	`ssfm-v21`	사용할 AI 음성 모델 (현재 SSFM V21)
Binary Property Name	문자열	`audio`	생성된 오디오를 저장할 바이너리 속성 이름

추가 옵션

항목	타입	기본값	설명
Language Code	선택	Auto Detect	언어 코드 (한국어, 영어, 일본어 등 27개 언어 지원)
Emotion Preset	선택	`normal`	감정 프리셋 (Normal/Happy/Sad/Angry/Tone Mid/Tone Up)
Emotion Preset (String)	문자열	-	표현식으로 감정 설정 (예: `{{ $json.emotion }}`)
Emotion Intensity	숫자	`1.0`	감정 강도 (0.0~2.0)
Emotion Intensity (String)	문자열	-	표현식으로 감정 강도 설정
Volume	숫자	`100`	음성 볼륨 (0~200)
Pitch	숫자	`0`	음성 피치 (-12~+12 semitones)
Tempo	숫자	`1.0`	음성 속도 (0.5x~2.0x)
Audio Format	선택	`mp3`	출력 오디오 형식 (WAV / MP3)
Seed	숫자	-	재현 가능한 결과를 위한 시드 값 (선택)
Retry Attempts	숫자	`0`	실패 시 재시도 횟수 (0~5)

지원 언어

언어	코드	언어	코드
한국어	`kor`	영어	`eng`
일본어	`jpn`	중국어	`zho`
스페인어	`spa`	프랑스어	`fra`
독일어	`deu`	이탈리아어	`ita`
러시아어	`rus`	아랍어	`ara`
포르투갈어	`por`	인도네시아어	`ind`

Auto Detect 옵션을 사용하면 텍스트의 언어를 자동으로 감지합니다.

감정 프리셋

프리셋	설명
Normal	기본 톤
Happy	밝고 즐거운 톤
Sad	슬픈 톤
Angry	화난 톤
Tone Mid	중간 톤
Tone Up	올라가는 톤

인증 정보

이 노드는 Typecast AI API 인증 정보가 필요합니다.

자세한 설정 방법은 Typecast AI API 인증 설정 가이드를 참고하세요.

사용 예시

기본 음성 합성

Typecast AI 노드를 추가합니다.
Text에 변환할 텍스트를 입력합니다.
Voice ID에 사용할 음성 ID를 입력합니다 (Typecast 대시보드에서 확인 가능).
실행하면 audio 바이너리 속성에 MP3 파일이 생성됩니다.

감정이 포함된 음성

추가 옵션에서 Emotion Preset을 "Happy"로 설정합니다.
Emotion Intensity를 1.5로 높여 감정을 강조합니다.
밝고 즐거운 톤의 음성이 생성됩니다.

동적 감정 제어

Emotion Preset (String)에 {{ $json.emotion }}을 설정합니다.
Emotion Intensity (String)에 {{ $json.intensity }}를 설정합니다.
이전 노드에서 전달된 데이터에 따라 동적으로 감정이 적용됩니다.

다양한 속도/피치 조절

Tempo를 0.8로 설정하면 느린 속도로 합성됩니다.
Pitch를 +3으로 설정하면 높은 톤으로 합성됩니다.
Volume을 150으로 설정하면 기본보다 큰 볼륨으로 합성됩니다.

참고 사항

텍스트가 비어있으면 1초 무음 WAV 파일이 자동으로 생성됩니다. 이를 활용하여 무음 구간을 삽입할 수 있습니다.
Voice ID는 Typecast AI 대시보드 또는 API에서 확인할 수 있습니다. tc_ 접두사로 시작합니다.
Typecast AI SDK(@neosapience/typecast-js)가 설치되어 있어야 합니다.
재시도 시 60초 간격으로 대기합니다. 401/402/403/422 에러는 재시도하지 않습니다.
출력 JSON에 voiceId, textLength, audioSize, duration, format, language, emotionPreset, emotionIntensity 등의 메타데이터가 포함됩니다.