Voices

List Voices

SDK

Use the SDK for safer, faster integration than manual HTTP calls.

Lists the built-in voices and completed custom voices available for use with any endpoint that accepts a voice_id. Custom voices appear first. Each voice_name is keyed by ISO 639-3 language codes such as eng and kor.

Use the optional filters together to narrow the catalog by model, gender, age group, use case, or voice type. preview_url is null when a preview is unavailable, including custom voices.

GET/v3/voices

cURL

curl --request GET \
+  --url https://api.typecast.ai/v3/voices \
+  --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"
  }
]

Authorizations

X-API-KEYstringheaderrequired

API key for authentication. You can obtain an API key from the Typecast API Console.

Query parameters

modelssfm-v30 | ssfm-v21

Filter by TTS model, such as ssfm-v21, ssfm-v30, or ssfm-v31.

ssfm-v30ssfm-v21

gendermale | female

Filter by voice gender (male or female).

malefemale

agechild | teenager | young_adult | middle_age | elder

Filter by age group (child, teenager, young_adult, middle_age, or elder).

childteenageryoung_adultmiddle_ageelder

use_casesstring

Filter by a use-case keyword, such as Ads.

voice_typeoriginal | custom

Filter by voice type (original or custom).

originalcustom

Response

200Voices retrieved successfullyapplication/json

agechild | teenager | young_adult | middle_age | elder

Voice age group.

childteenageryoung_adultmiddle_ageelder

gendermale | female

Voice gender (male or female).

malefemale

modelsobject[]

Supported TTS models and their available emotions.

Show nested model

versionssfm-v30 | ssfm-v21

TTS model version (e.g., ssfm-v21, ssfm-v30)

ssfm-v30ssfm-v21

emotionsstring[]

List of supported emotions for this model

voice_idstring

Unique voice identifier. Built-in voices use the tc_ prefix and custom voices use the uc_ prefix.

use_casesstring[]

Recommended use-case categories.

voice_nameobject

Localized voice names, such as {"eng": "Daejin", "kor": "대진"}.

Show nested model

engstringrequired

English voice name.

korstringrequired

Korean voice name.

voice_typeoriginal | custom

Voice type (original or custom).

originalcustom

preview_urlstring

Preview audio URL when available.

cURL

curl --request GET \
+  --url https://api.typecast.ai/v3/voices \
+  --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"
  }
]