Voices

Get Voice Details

Retrieves detailed information for a specific voice with enhanced metadata (V2).

This endpoint returns the complete information for a single voice, including model-grouped emotion support and metadata such as gender, age group, and use cases. Use this when you need to verify voice details or check available emotions before making a TTS request.

Response includes:

voice_id: Unique voice identifier
voice_name: Human-readable voice name
models: Array of supported TTS models with their respective emotion sets
gender: Voice gender classification (male/female)
age: Age group classification (child/teenager/young_adult/middle_age/elder)
use_cases: Recommended content categories for this voice

Use Cases:

Verify voice availability before TTS request
Check supported emotions for a specific voice and model combination
Display voice details in a voice selection UI

GET/v2/voices/{voice_id}

curl --request GET \
  --url 'https://api.typecast.ai/v2/voices/tc_60e5426de8b95f1d3000d7b5' \
  --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"
}

Authorizations

X-API-KEYstringheaderrequired

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

Path parameters

voice_idstringrequired

Response

200Success - Returns detailed information for the requested voiceapplication/json

voice_idstring

Unique voice identifier. Built-in voices use the tc_ prefix (e.g., tc_60e5426de8b95f1d3000d7b5); cloned custom voices created via POST /v1/voices/clone use the uc_ prefix and are also returned by /v2/voices for the owner.

voice_namestring

Human-readable name of the voice

modelsobject[]

List of supported TTS models with their available emotions (e.g., [{'version': 'ssfm-v21', 'emotions': ['happy', 'sad']}])

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

gendermale | female

Voice gender classification (male/female)

malefemale

agechild | teenager | young_adult | middle_age | elder

Voice age group classification (child/teenager/young_adult/middle_age/elder)

childteenageryoung_adultmiddle_ageelder

use_casesstring[]

List of use case categories this voice is suitable for

voice_typeoriginal | custom

Voice type - original for Typecast-provided stock voices, custom for user-cloned voices.

originalcustom

curl --request GET \
  --url 'https://api.typecast.ai/v2/voices/tc_60e5426de8b95f1d3000d7b5' \
  --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"
}