Typecast
SupportGo to API Console
Deprecated

Get Voice Details (v2)

SDK

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

SDK guide

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}

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
agechild | teenager | young_adult | middle_age | elder

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

childteenageryoung_adultmiddle_ageelder
gendermale | female

Voice gender classification (male/female)

malefemale
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

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.

use_casesstring[]

List of use case categories this voice is suitable for

voice_namestring

Human-readable name of the voice

voice_typeoriginal | custom

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

originalcustom
⌘I