연동 키트API 연동타입캐스트 API
타입캐스트 음성 합성 API를 콘텐츠 파이프라인에 연동
- 누가 · 어디에
- 콘텐츠 제작 실무자가 영상 내레이션 및 음성 안내 오디오를 대본 기반으로 자동 생성하는 업무
- 업무 효과
- 별도 녹음 환경 없이 텍스트 대본만으로 감정과 억양이 적용된 고품질 오디오 파일을 즉시 추출
공식 API · SDK 로 우리 시스템에 붙입니다. AI 가 공식 문서를 찾아 정리한 가이드로, mopick 이 직접 따라 해 보지는 않았습니다 · 공식 문서에서 제품을 확인했습니다
준비할 것
- 타입캐스트(Typecast) 계정
- Typecast API 콘솔에서 발급한 API 키
- cURL 또는 Python 3.11 이상 실행 환경
연동 단계
해 본 단계는 번호를 눌러 표시하세요. 표시는 이 브라우저에만 남습니다.
0% 진행
API 키 발급
Typecast API 콘솔에 접속하여 무료 플랜을 시작하고 발급된 API 키를 확인한 뒤 환경 변수로 저장합니다.
보이스 ID 조회
GET https://api.typecast.ai/v3/voices?model=ssfm-v31 요청을 보내 사용할 모델에 호환되는 voice_id를 확인합니다.
음성 변환 호출
POST https://api.typecast.ai/v1/text-to-speech 엔드포인트에 X-API-KEY 헤더와 텍스트, model, voice_id를 담아 요청합니다.
오디오 파일 저장
API 응답으로 반환되는 바이너리 오디오 데이터를 로컬 파일(speech.wav)로 저장합니다.
붙여 넣는 설정 · 코드
YOUR_API_KEY 같은 자리에는 내 값을 넣으세요. 키는 코드 · 문서에 그대로 남기지 말고 환경 변수 · 비밀 저장소에 두세요.
cURL 음성 합성 요청 bash
curl --request POST \
--url 'https://api.typecast.ai/v1/text-to-speech' \
--header 'Content-Type: application/json' \
--header 'X-API-KEY: YOUR_API_KEY' \
--data '{
"voice_id": "tc_674fc11f6720f4e7cf72f3f9",
"text": "안녕하세요. 타입캐스트 AI 음성 합성 연동 테스트입니다.",
"model": "ssfm-v31"
}' \
--output speech.wav- 잘 연결됐는지 확인
- 생성된 speech.wav 오디오 파일을 재생하여 입력한 대본 내용이 지정한 AI 목소리로 정상 출력되는지 확인
- 비용
- 결제수단 등록 없이 무료로 API 시작 가능(요금제별 월간 크레딧 및 초과 요금은 공식 문서에서 확인)
- 주의
- · API 키 노출 방지를 위해 소스 코드 하드코딩을 피하고 환경 변수로 관리해야 합니다.
- · 1회 음성 합성 요청 시 텍스트 길이는 최소 1자에서 최대 2,000자까지 지원됩니다.
- · 선택한 모델(ssfm-v31, ssfm-v30, ssfm-v21)에 따라 지원되는 보이스 ID 및 언어/감정 프리셋 범위가 다릅니다.
공식 문서
우리 회사 시스템에 붙여야 한다면 — 업무 앱 · 사내 자료 · 보안 조건에 맞춘 연동을 TPI INSIGHT AX센터가 함께합니다.