Voices

Get Voice Details

SDK

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

Returns one accessible built-in or completed custom voice with localized names, supported models and emotions, recommended use cases, and a preview URL when available. Built-in voice IDs use the tc_ prefix; custom voice IDs use uc_.

GET/v3/voices/{voice_id}

cURL

curl --request GET \
  --url https://api.typecast.ai/v3/voices/tc_6045d56d5f9ae03ac175cf73 \
  --header 'X-API-KEY: <api-key>'

{
  "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.

Path parameters

voice_idstringrequired

Unique voice identifier.

Response

200Voice 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/tc_6045d56d5f9ae03ac175cf73 \
  --header 'X-API-KEY: <api-key>'

{
  "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"
}