Skip to main content
GET
cURL

인증

X-API-KEY
string
header
필수

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

경로 매개변수

voice_id
string
필수

응답

Success - Returns detailed information for the requested voice

모델별로 그룹화된 감정과 향상된 메타데이터가 있는 V2 보이스 응답 모델

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개)