Skip to main content
GET
cURL

인증

X-API-KEY
string
header
필수

인증을 위한 API 키. 타입캐스트 API 콘솔에서 API 키를 생성할 수 있습니다.

쿼리 매개변수

model
enum<string>

보이스 모델로 필터링(ssfm-v21 또는 ssfm-v30). 지정된 모델을 지원하는 보이스를 반환합니다. 선택 사항 - 제공하지 않으면 모든 모델의 보이스를 반환합니다. 음성 합성에 사용할 TTS 모델 버전. 다양한 모델은 다양한 기능과 품질 수준을 제공합니다.

사용 가능한 모델:

  • ssfm-v30: 향상된 플로우와 추가 감정 프리셋이 있는 최신 모델(권장)
  • ssfm-v21: 검증된 신뢰성과 일관된 품질을 갖춘 안정적인 모델
사용 가능한 옵션:
ssfm-v30,
ssfm-v21
gender
enum<string>

성별로 필터링(남성 또는 여성). 지정된 성별과 일치하는 보이스를 반환합니다. 선택 사항 - 제공하지 않으면 모든 성별의 보이스를 반환합니다. 성별 분류 열거형 - 데이터베이스 값(한국어)을 API 값(영어)으로 변환합니다.

사용 가능한 값:

  • male: 남성 보이스
  • female: 여성 보이스
사용 가능한 옵션:
male,
female
age
enum<string>

연령대로 필터링(어린이, 청소년, 청년, 중년, 노년). 지정된 연령대와 일치하는 보이스를 반환합니다. 선택 사항 - 제공하지 않으면 모든 연령의 보이스를 반환합니다. 연령대 분류 열거형 - 데이터베이스 값(한국어)을 API 값(영어)으로 변환합니다.

사용 가능한 값:

  • child: 어린이 보이스(12세 미만)
  • teenager: 청소년 보이스(13-19세)
  • young_adult: 청년 보이스(20-35세)
  • middle_age: 중년 보이스(36-60세)
  • elder: 노년 보이스(60세 이상)
사용 가능한 옵션:
child,
teenager,
young_adult,
middle_age,
elder
use_cases
enum<string>

사용 사례 카테고리로 필터링. 지정된 사용 사례로 태그된 보이스를 반환합니다(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
voice_type
enum<string>

보이스 타입으로 필터링 (original 또는 custom). 선택 사항 - 제공하지 않으면 모든 타입의 보이스를 반환합니다. 보이스 타입 분류.

  • original — 타입캐스트가 기본 제공하는 스톡 보이스로, 모든 계정에서 사용 가능합니다.
  • custom — 사용자가 본인의 샘플을 업로드하거나 클로닝해서 만든 보이스입니다.
사용 가능한 옵션:
original,
custom

응답

Success - Returns list of voice models with enhanced metadata

voice_id
string
필수

고유한 보이스 식별자. 기본 제공 보이스는 tc_ prefix (예: tc_60e5426de8b95f1d3000d7b5), POST /v1/voices/clone 으로 만든 커스텀 보이스는 uc_ prefix 를 사용합니다. 본인이 소유한 uc_ 보이스도 /v2/voices 응답에 포함됩니다.

voice_name
string
필수

사람이 읽을 수 있는 보이스 이름

models
ModelInfo · object[]
필수

사용 가능한 감정이 있는 지원되는 TTS 모델 목록(예: [{'version': 'ssfm-v21', 'emotions': ['happy', 'sad']}])

voice_type
enum<string>
필수

보이스 타입 — original 은 타입캐스트가 기본 제공하는 스톡 보이스, custom 은 사용자가 업로드/클론한 보이스입니다.

사용 가능한 옵션:
original,
custom
gender
enum<string> | null

보이스 성별 분류(남성/여성)

사용 가능한 옵션:
male,
female
age
enum<string> | null

보이스 연령대 분류(어린이/청소년/청년/중년/노년)

사용 가능한 옵션:
child,
teenager,
young_adult,
middle_age,
elder
use_cases
string[]

이 보이스가 적합한 사용 사례 카테고리 목록

보이스 이름 참고

voice_name 필드는 영문으로만 반환됩니다. 아래 목록에서 한국어 표기를 확인하실 수 있습니다.

보이스 이름 목록 펼치기 (542개)