보이스

보이스 목록 조회

SDK

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

voice_id가 포함된 모든 엔드포인트에서 사용할 수 있는 일반 보이스와 생성이 완료된 커스텀 보이스를 조회합니다. 커스텀 보이스가 먼저 표시되며 voice_name은 eng, kor 같은 ISO 639-3 언어 코드별 이름을 제공합니다.

모델, 성별, 연령대, 사용 사례, 보이스 유형 필터를 함께 사용할 수 있습니다. 미리듣기를 제공하지 않는 보이스와 커스텀 보이스의 preview_url은 null입니다.

GET/v3/voices

cURL

curl --request GET \
  --url 'https://api.typecast.ai/v3/voices?model=ssfm-v30&voice_type=original' \
  --header 'X-API-KEY: <api-key>'

[
  {
    "age": null,
    "gender": null,
    "models": [
      {
        "version": "ssfm-v30",
        "emotions": [
          "normal"
        ]
      }
    ],
    "voice_id": "uc_6700000000000000000000aa",
    "use_cases": [],
    "voice_name": {
      "eng": "My Voice",
      "kor": "내 보이스"
    },
    "voice_type": "custom",
    "preview_url": null
  },
  {
    "age": "young_adult",
    "gender": "female",
    "models": [
      {
        "version": "ssfm-v30",
        "emotions": [
          "normal",
          "happy",
          "sad",
          "angry"
        ]
      }
    ],
    "voice_id": "tc_6045d56d5f9ae03ac175cf73",
    "use_cases": [
      "Game",
      "Anime"
    ],
    "voice_name": {
      "eng": "Valkyrie",
      "kor": "발키리"
    },
    "voice_type": "original",
    "preview_url": "https://static2.typecast.ai/data/actor/valkyrie.mp3"
  }
]

인증

X-API-KEYstringheader필수

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

쿼리 매개변수

modelssfm-v30 | ssfm-v21

ssfm-v21, ssfm-v30, ssfm-v31 같은 TTS 모델로 필터링합니다.

ssfm-v30ssfm-v21

gendermale | female

보이스 성별(male 또는 female)로 필터링합니다.

malefemale

agechild | teenager | young_adult | middle_age | elder

연령대(child, teenager, young_adult, middle_age, elder)로 필터링합니다.

childteenageryoung_adultmiddle_ageelder

use_casesstring

Ads 같은 사용 사례 키워드로 필터링합니다.

voice_typeoriginal | custom

보이스 타입(original 또는 custom)으로 필터링합니다.

originalcustom

응답

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입니다.

cURL

curl --request GET \
  --url 'https://api.typecast.ai/v3/voices?model=ssfm-v30&voice_type=original' \
  --header 'X-API-KEY: <api-key>'

[
  {
    "age": null,
    "gender": null,
    "models": [
      {
        "version": "ssfm-v30",
        "emotions": [
          "normal"
        ]
      }
    ],
    "voice_id": "uc_6700000000000000000000aa",
    "use_cases": [],
    "voice_name": {
      "eng": "My Voice",
      "kor": "내 보이스"
    },
    "voice_type": "custom",
    "preview_url": null
  },
  {
    "age": "young_adult",
    "gender": "female",
    "models": [
      {
        "version": "ssfm-v30",
        "emotions": [
          "normal",
          "happy",
          "sad",
          "angry"
        ]
      }
    ],
    "voice_id": "tc_6045d56d5f9ae03ac175cf73",
    "use_cases": [
      "Game",
      "Anime"
    ],
    "voice_name": {
      "eng": "Valkyrie",
      "kor": "발키리"
    },
    "voice_type": "original",
    "preview_url": "https://static2.typecast.ai/data/actor/valkyrie.mp3"
  }
]