메인 콘텐츠로 건너뛰기
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"
    ],
    "voice_type": "original"
  }
]

Documentation Index

Fetch the complete documentation index at: https://typecast.ai/docs/llms.txt

Use this file to discover all available pages before exploring further.

인증

​
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개)
영어한국어영어한국어영어한국어
Aaron에런Inhye인혜Piljae필재
Abigail아비게일Inseong인성Pyeonghwa평화
Ae-ran애란Instructor Han한유격 교관Rachel레이첼
Ael아엘Insun인선Ravi라비
Agatha아가사Jabbaba자바바Rayeon라연
Aiden에이든Jack잭Rebecca레베카
Alena알레나Jack-o’-Lantern잭오랜턴Reporter Bona다보나 기자
Alex알렉스Jackson잭슨Reporter Catalina카탈리나 기자
Amber엠버Jaeho재호Reporter Jinsub송진섭 기자
Anchor Hwa김경화 앵커Jaehun재훈Reporter Kang강수정 기자
Angela안젤라Jaejun재준Reporter Lee이승주 기자
Anja안냐Jaekyung재경Reporter Parkchan박찬 기자
Annabelle the Ghost귀신 애나벨Jaesun재선Rex렉스
Annie애니JaeYi재이Riley라일리
April에이프릴Jaeyoung재영Risan Ji지리산
Arang아랑Jain자인Rita리타
Ari아리Jake제이크River리버
Arin아린Janet재닛Robert로버트
Athena아테나Jangho장호Robo로보
Audrey오드리Jangwoon장운Romi로미
Avery에이버리Jechan제찬Ron론
Avong아봉Jeff제프Roro로로
Azzi아찌Jenna제나Rowoon로운
Babilon바빌론Jennifer제니퍼Royce로이스
Bell벨Jeong Choi최정Rudolph루돌프
Ben벤Jeongah정아Ruri루리
Benny베니JeongJin정진Rusty러스티
Beri베리Jeongseob정섭Ryan라이언
Billie빌리Jerome제롬Ryueun류은
Bomi이보미Jewby쥬비Sabrina the Witch마녀 사브리나
Bonggyu봉규Jian지안Saeron새론
Bongman Kim김봉만Jicheol지철Salty Chan-gu삐뚤어진 찬구
Bono보노Jihee지희Samantha사만다
Bora보라Jihoon지훈Sammy새미
Brad브래드Jihyun지현Sangdo상도
Bruce브루스Jimmy지미Sanghoon상훈
Buddy버디Jin진Sangwoo상우
Bumsoo범수Jinhan진한Santa산타
Buttaguy빠다가이Jinhang Kim김진행Santa Claus산타클로스
Caitlyn케이틀린Jinhee진희Santa ReporterVJ 싼타
Callan칼란Jinhyuk진혁Sara세라
Camila카밀라Jinseo진서Sean션
Captain Bill캡틴 빌Jinung진웅SeHee세희
Carl칼Jinwoo진우Seheon세헌
Carlos카를로스Jiwoo지우Sejin세진
Carol캐롤Jiyoon지윤Sena세나
Catherine캐서린Jiyoung지영Seohee서희
Chad채드Jodie조디Seojin서진
Chaeah채아Jolly졸리Seojoon서준
Chan-gu찬구Jongdae종대Seok Choi최석
Changbae창배Jooeun주은SeokPil한석필
Changhee창희Joonghyun중현Seokpyo석표
Changmin창민Joongsik중식Seolhwa설화
Changsu박창수Joonkyu준규Seonha선하
Chanhyuk찬혁Joshua조슈아Seoyeon서연
Charlotte샬롯Juha주하Seoyoon서윤
Chase체이스Juho주호Seungah승아
Cheolhoon철훈Jungbong정봉Seungheon승헌
Cheolyong리철용Junghee정희Seungho승호
Cherry체리Jungjae정재Seunghwa승화
Chester체스터Jungmin정민Seungjae승재
Chiho치호Jungseok정석Seungmoon승문
Chloe클로이Jungsoon정순Seungwon승원
Choyeon강초연 교관Jungwon정원Seungyeon승연
Chungah청아Junhee준희Sewoo세우
Chunsik Kang강춘식 기자Junho준호Shana샤나
Claire클레어JunKi준기Sheriff Kim김반장
Classic Narrator미스타 변사Junsang준상Shinhe신혜
Cole콜Junseong준성Shinwook신욱
Cox콕스Justice Roh정의로Shotgun샷건
Cyrus사이러스Justin저스틴Simon사이먼
Dabin다빈Juwon주원Sindarin신다린
Daegil대길Juyoung주영Sio시오
Dahee다희K-Santa산타 할아버지Siwon시원
Dahyeon다현Kangil강일Siwoo시우
Damian데이미언Kanno칸노Siyeon시연
Dan댄Katie케이티Skylar스카일러
Dana다나Kelly켈리Slushy슬러시
Dasom다솜Kelsey켈시Smoke스모크
David데이비드Kevin케빈Sohye소혜
Dean딘Keybo키보Sojin소진
Deokhwan덕환Kijang Kim김기장Soobin수빈
Dohan도한Killian the Vampire뱀파이어 킬리언Sookhee숙희
Dohee도희Kiseob기섭Sooni순이
Dohyun도현Klip Kim클립 킴Sophia소피아
Dollar Jr.달러 주니어Koombo쿰보Sora소라
Doug더그Kristen크리스틴Soye소예
Doughnut도넛Kukhee국희Soyi소이
DU5T더스트Kwonil권일Soyoung소영
Duckchun덕춘Kyumin규민Soyul소율
Duke듀크Kyungho경호Spice스파이스
Dukgu덕구Kyungsoo경수Sportscaster Kang강수정 캐스터
Duman두만Kyungsook경숙Sportscaster Tony이영광 캐스터
Dupil곽두필Lady Cho단희빈Starling스탈링
DVZY데이지Lala라라Stephanie스테파니
Dylan딜런Lamie라미Storyteller Jinsub송진섭 스토리텔러
E-seller Sherri쇼린이Landon랜던Sua수아
Echo에코Larry래리Suho수호
Edward에드워드Leo레오Suji수지
Elias엘리아스Liam리암Sujin수진
Elise엘리스Lindsay린지Sullock Hong홍설록
Ella엘라Liz리즈Sumin수민
Eman이만Lloyd로이드Sungbae성배
Emma엠마Logan로건Sunggyu성규
Eunbin은빈Lucille루실Sungho성호
Eunchae은채Luna루나Sunghoon성훈
Eunha은하Lydia리디아Sunghyun성현
Eunsol은솔Maddie매디Sungjun홈쇼핑 성준
Frankenstein프랑켄슈타인Maisie메이시Sungkwon성권
Furnando터르난도Margaret마가렛Sungtae성태
Gaeul가을Margot마고Sungwook성욱
Gahee가희Matthew매튜Sunyoung선영
George조지MBTI EF (F)MBTI EF 여Suyoon수윤
GeumHee금희MBTI EF (M)MBTI EF 남Sylvia실비아
Geunhyeok근혁MBTI ET (F)MBTI ET 여Taebaek장태백
Geunseok근석MBTI ET (M)MBTI ET 남Taeji태지
Geunwoo근우MBTI IF (F)MBTI IF 여Taejoong태중
Geunyeong근영MBTI IF (M)MBTI IF 남Taemin태민
Ggami까미MBTI IT (F)MBTI IT 여Taesub태섭
Ggomi꼬미MBTI IT (M)MBTI IT 남Taewoo태우
Glenda글렌다MC KongMC콩Teal틸
Goat Kim김고트MC TypeCastMC 타캐Tessa테사
Gongchul공철Mia미아Tian티안
Gowoon고운Michael마이클Tim팀
Grace그레이스Mija오미자Tina티나
Graham그레이엄Mijin미진Toby토비
Gunseok건석Mikyung미경Tommy토미
Gunwoo건우Millie밀리Tyson타이슨
Guri구리Minchae민채UiChan의찬이
Gus거스Minji민지Uncle Hank행크
Ha Eun하은Minjoon민준Valerie밸러리
Haejun해준Minju민주Valkyrie발키리
Haerang해랑Minjung민정Vanessa바네사
Hailey헤일리Minsang민상Verna베르나
Hajun하준Minsu민수Victoria빅토리아
Hakchul학철Mio미오Viktor빅토르
Hamchu햄쮸Miran Choi최미란Vincent빈센트
Han Taesung Caster한태성 캐스터Mirine미리내Vivien비비안
Hana하나Miseon미선Wade웨이드
Hangyeol한결Miso미소Walter월터
Hanjun한준Mister Gop미스터 갑Wangkwon왕권
Hanna한나Monggun몽군Weather Reporter Sky하늘 캐스터
Hans한스Moonjung문정West웨스트
Hansol한솔Mooyeol무열Wonho원호
Hanyoung한영Morgan모건Wonkyung원경
Harin하린Moru머루Wonwoo원우
Harper하퍼Mrs. Claus미세스 클로스Wooju우주
Hayul하율Munseok문석Woosung우성
Heejoon희준Munsu문수Xavier자비에르
Helena헬레나Myeonghee명희Yeeun예은
Henry헨리Myungil명일Yejin예진
Homun Sim심호문Myungjoo명주Yejoon예준
Hoon훈Naeun나은YeLin예린
Hosik호식Najin나진Yena예나
Hosun호선Namjoon남준Yeonah연아
Hoyoung호영Nana나나Yeonggeol영걸
Hugh휴Nari개나리Yeonhwa연화
Hwimin휘민Nathan네이선Yeonja연자
Hyejung혜정Neel닐Yeonsuh연서
Hyelee혜리Neoguard네오가드Yeonwoo연우
Hyemin혜민News anchor Jinsub송진섭 앵커Yeseul예슬
Hyena혜나Newscaster John존 앵커Yongsik용식이
Hyeongjin형진Nia니아Yoonseo윤서
Hyera혜라Noa노아Yoonsung윤성
Hyesu홈쇼핑 혜수Noel노엘Younggil영길
Hyewon혜원Noeul노을Younghee영희
Hyun현Norah노라Younghwan영환
Hyunji현지Nova노바Youngji영지
Hyunjin현진Old radio레디오Youngkyu영규
Hyunju현주Oliver올리버Youngmok영목
Hyunkyung현경Olivia올리비아Yubin유빈
Hyunmin현민Oscar오스카Yujin유진
Hyunseung현승Owen오언Yumi유미
HyunWoo현우P-0150N포이즌Yumin유민
Ian이안Pacang파캉Yunbin윤빈
Icarus이카루스Paige페이지Yunjeong윤정
Igyeom이겸Pangpang팡팡Yura유라
Ijun이준Patricia패트리샤Yuri유리
Ilho일호Patrick패트릭Yuseong유성
Ina이나Peter피터Zoey조이
Inhwa인화Philip필립