메인 콘텐츠로 건너뛰기
GET
/
v2
/
voices
cURL
curl --request GET \
  --url 'https://api.typecast.ai/v2/voices?model=ssfm-v30&gender=female&age=young_adult' \
  --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 키를 생성할 수 있습니다.

쿼리 매개변수

​
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

응답

Success - Returns list of voice models with enhanced metadata

​
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[]

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