Typecast
고객 지원API 콘솔로 이동
보이스

보이스 상세 정보 조회

SDK

수동 HTTP 호출보다 안전하고 빠른 통합을 위해 SDK를 사용하세요.

SDK 가이드

계정에서 사용할 수 있는 기본 보이스 또는 생성이 완료된 커스텀 보이스 한 개를 조회합니다. 다국어 이름, 지원 모델과 감정, 추천 사용 사례, 제공 가능한 경우 미리듣기 URL을 반환합니다. 기본 보이스 ID는 tc_, 커스텀 보이스 ID는 uc_로 시작합니다.

GET/v3/voices/{voice_id}

인증

X-API-KEYstringheader필수

인증을 위한 API 키입니다. Typecast API 콘솔에서 API 키를 발급받을 수 있습니다.

경로 매개변수

voice_idstringrequired

조회할 보이스의 고유 식별자입니다.

응답

200보이스 상세 정보를 조회했습니다.application/json
agechild | teenager | young_adult | middle_age | elder

보이스 연령대입니다.

childteenageryoung_adultmiddle_ageelder
gendermale | female

보이스 성별(male 또는 female)입니다.

malefemale
modelsobject[]

지원하는 TTS 모델과 감정 목록입니다.

Show nested model
versionssfm-v30 | ssfm-v21

TTS 모델 버전(예: ssfm-v21, ssfm-v30)

ssfm-v30ssfm-v21
emotionsstring[]

이 모델에서 지원되는 감정 목록

voice_idstring

고유 보이스 식별자입니다. 기본 보이스는 tc_, 커스텀 보이스는 uc_로 시작합니다.

use_casesstring[]

추천 사용 사례 목록입니다.

voice_nameobject

{"eng": "Daejin", "kor": "대진"} 같은 다국어 보이스 이름입니다.

Show nested model
engstringrequired

영어 보이스 이름입니다.

korstringrequired

한국어 보이스 이름입니다.

voice_typeoriginal | custom

보이스 타입(original 또는 custom)입니다.

originalcustom
preview_urlstring

제공되는 경우 사용할 수 있는 미리듣기 오디오 URL입니다.

⌘I