보이스 목록 조회
향상된 메타데이터 및 필터링 기능을 갖춘 사용 가능한 모든 보이스를 조회합니다(V2).
이 엔드포인트는 모델별로 그룹화된 감정 지원과 성별, 연령대, 사용 사례를 포함한 추가 메타데이터가 있는 향상된 보이스 목록을 반환합니다. 각 보이스는 해당 감정 세트와 함께 여러 모델을 지원할 수 있습니다.
주요 기능:
- 모델 그룹화: 각 보이스에는 지원되는 모든 TTS 모델과 사용 가능한 감정을 보여주는
models배열이 포함됩니다 - 향상된 메타데이터: 성별(남성/여성), 연령대(어린이/청소년/청년/중년/노년), 사용 사례 포함
- 고급 필터링: 모델, 성별, 연령, 사용 사례로 필터링하여 특정 요구사항에 맞는 보이스 찾기
사용 사례:
- 다양한 필터가 있는 보이스 선택 UI
- 특정 콘텐츠 유형에 적합한 보이스 찾기(예: 광고, 오디오북, 교육)
- 각 모델 버전에서 사용 가능한 감정 탐색
인증
인증을 위한 API 키. 타입캐스트 API 콘솔에서 API 키를 생성할 수 있습니다.
쿼리 매개변수
보이스 모델로 필터링(ssfm-v21 또는 ssfm-v30). 지정된 모델을 지원하는 보이스를 반환합니다. 선택 사항 - 제공하지 않으면 모든 모델의 보이스를 반환합니다. 음성 합성에 사용할 TTS 모델 버전. 다양한 모델은 다양한 기능과 품질 수준을 제공합니다.
사용 가능한 모델:
- ssfm-v30: 향상된 플로우와 추가 감정 프리셋이 있는 최신 모델(권장)
- ssfm-v21: 검증된 신뢰성과 일관된 품질을 갖춘 안정적인 모델
ssfm-v30, ssfm-v21 성별로 필터링(남성 또는 여성). 지정된 성별과 일치하는 보이스를 반환합니다. 선택 사항 - 제공하지 않으면 모든 성별의 보이스를 반환합니다. 성별 분류 열거형 - 데이터베이스 값(한국어)을 API 값(영어)으로 변환합니다.
사용 가능한 값:
- male: 남성 보이스
- female: 여성 보이스
male, female 연령대로 필터링(어린이, 청소년, 청년, 중년, 노년). 지정된 연령대와 일치하는 보이스를 반환합니다. 선택 사항 - 제공하지 않으면 모든 연령의 보이스를 반환합니다. 연령대 분류 열거형 - 데이터베이스 값(한국어)을 API 값(영어)으로 변환합니다.
사용 가능한 값:
- child: 어린이 보이스(12세 미만)
- teenager: 청소년 보이스(13-19세)
- young_adult: 청년 보이스(20-35세)
- middle_age: 중년 보이스(36-60세)
- elder: 노년 보이스(60세 이상)
child, teenager, young_adult, middle_age, elder 사용 사례 카테고리로 필터링. 지정된 사용 사례로 태그된 보이스를 반환합니다(TikTok/Reels/Shorts, Game, Audiobook/Storytelling 등). 선택 사항 - 제공하지 않으면 사용 사례에 관계없이 모든 보이스를 반환합니다. 콘텐츠 유형 필터링을 위한 보이스 사용 사례 카테고리. 각 보이스는 특정 콘텐츠 유형에 대한 적합성을 나타내는 하나 이상의 사용 사례로 태그됩니다.
사용 가능한 사용 사례:
- Announcer: 공공 발표 및 프레젠테이션
- Anime: 애니메이션 보이스
- Audiobook: 장문 내레이션 및 스토리텔링
- Conversational: 챗봇 및 대화형 AI
- Documentary: 다큐멘터리 내레이션 및 해설
- E-learning: 교육 콘텐츠 및 튜토리얼
- Rapper: 랩 및 음악 퍼포먼스
- Game: 비디오 게임 보이스 및 내레이션
- Tiktok/Reels: SNS 숏츠
- News: 뉴스 방송
- Podcast: 방송 및 팟캐스트 제작
- Voicemail: IVR 시스템 및 음성 비서
- Ads: 광고 및 홍보 콘텐츠
Announcer, Anime, Audiobook, Conversational, Documentary, E-learning, Rapper, Game, Tiktok/Reels, News, Podcast, Voicemail, Ads 보이스 타입으로 필터링 (original 또는 custom). 선택 사항 - 제공하지 않으면 모든 타입의 보이스를 반환합니다.
보이스 타입 분류.
original— 타입캐스트가 기본 제공하는 스톡 보이스로, 모든 계정에서 사용 가능합니다.custom— 사용자가 본인의 샘플을 업로드하거나 클로닝해서 만든 보이스입니다.
original, custom 응답
Success - Returns list of voice models with enhanced metadata
고유한 보이스 식별자. 기본 제공 보이스는 tc_ prefix (예: tc_60e5426de8b95f1d3000d7b5), POST /v1/voices/clone 으로 만든 커스텀 보이스는 uc_ prefix 를 사용합니다. 본인이 소유한 uc_ 보이스도 /v2/voices 응답에 포함됩니다.
사람이 읽을 수 있는 보이스 이름
사용 가능한 감정이 있는 지원되는 TTS 모델 목록(예: [{'version': 'ssfm-v21', 'emotions': ['happy', 'sad']}])
보이스 타입 — original 은 타입캐스트가 기본 제공하는 스톡 보이스, custom 은 사용자가 업로드/클론한 보이스입니다.
original, custom 보이스 성별 분류(남성/여성)
male, female 보이스 연령대 분류(어린이/청소년/청년/중년/노년)
child, teenager, young_adult, middle_age, elder 이 보이스가 적합한 사용 사례 카테고리 목록
보이스 이름 참고
voice_name 필드는 영문으로만 반환됩니다. 아래 목록에서 한국어 표기를 확인하실 수 있습니다.