메인 콘텐츠로 건너뛰기
GET
/
v2
/
voices
/
{voice_id}
cURL
curl --request GET \
  --url 'https://api.typecast.ai/v2/voices/tc_60e5426de8b95f1d3000d7b5' \
  --header 'X-API-KEY: <api-key>'

{
  "voice_id": "tc_60e5426de8b95f1d3000d7b5",
  "voice_name": "Olivia",
  "models": [
    {
      "version": "ssfm-v30",
      "emotions": [
        "normal",
        "happy",
        "sad",
        "angry",
        "whisper",
        "toneup",
        "tonedown"
      ]
    },
    {
      "version": "ssfm-v21",
      "emotions": [
        "normal",
        "happy",
        "sad",
        "angry"
      ]
    }
  ],
  "gender": "female",
  "age": "young_adult",
  "use_cases": [
    "Audiobook",
    "E-learning",
    "Ads"
  ]
}

인증

​
X-API-KEY
string
header
필수

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

경로 매개변수

​
voice_id
string
필수

응답

Success - Returns detailed information for the requested voice

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

​
voice_id
string
필수

'tc_ObjectId' 형식의 고유한 캐릭터 식별자

​
voice_name
string
필수

사람이 읽을 수 있는 캐릭터 이름

​
models
ModelInfo · object[]
필수

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

​
gender
enum<string> | null

캐릭터 성별 분류(남성/여성)

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

캐릭터 연령대 분류(어린이/청소년/청년/중년/노년)

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

이 캐릭터가 적합한 사용 사례 카테고리 목록