Skip to main content
GET
cURL

Authorizations

X-API-KEY
string
header
required

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

Path Parameters

voice_id
string
required

Response

Success - Returns detailed information for the requested voice

V2 Voice response model with model-grouped emotions and enhanced metadata

voice_id
string
required

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_name
string
required

Human-readable name of the voice

models
ModelInfo · object[]
required

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

voice_type
enum<string>
required

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

Available options:
original,
custom
gender
enum<string> | null

Voice gender classification (male/female)

Available options:
male,
female
age
enum<string> | null

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

Available options:
child,
teenager,
young_adult,
middle_age,
elder
use_cases
string[]

List of use case categories this voice is suitable for