Typecast
SupportGo to API Console
Deprecated

List Voices (v2)

SDK

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

SDK guide

Lists all available voice models with enhanced metadata and filtering capabilities (V2).

This endpoint returns an enhanced voice list with model-grouped emotion support and additional metadata including gender, age group, and use cases. Each voice can support multiple models with their respective emotion sets.

Key Features:

  • Model Grouping: Each voice includes a models array showing all supported TTS models and their available emotions
  • Enhanced Metadata: Includes gender (male/female), age group (child/teenager/young_adult/middle_age/elder), and use cases
  • Advanced Filtering: Filter by model, gender, age, and use cases to find voices matching specific requirements

Use Cases:

  • Voice selection UI with demographic filters
  • Finding voices suitable for specific content types (e.g., Ads, Audiobook, eLearning)
  • Discovering which emotions are available for each model version
GET/v2/voices

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 voice model (ssfm-v21 or ssfm-v30). Returns voices that support the specified model. Optional - if not provided, returns voices for all models.

ssfm-v30ssfm-v21
gendermale | female

Filter by gender (male or female). Returns voices matching the specified gender. Optional - if not provided, returns voices of all genders.

malefemale
agechild | teenager | young_adult | middle_age | elder

Filter by age group (child, teenager, young_adult, middle_age, elder). Returns voices matching the specified age group. Optional - if not provided, returns voices of all ages.

childteenageryoung_adultmiddle_ageelder
use_casesAnnouncer | Anime | Audiobook | Conversational | Documentary | E-learning | Rapper | Game | Tiktok/Reels | News | Podcast | Voicemail | Ads

Filter by use case category. Returns voices tagged with the specified use case (TikTok/Reels/Shorts, Game, Audiobook/Storytelling, etc.). Optional - if not provided, returns all voices regardless of use case.

AnnouncerAnimeAudiobookConversationalDocumentaryE-learningRapperGameTiktok/ReelsNewsPodcastVoicemailAds
voice_typeoriginal | custom

Filter by voice type (original or custom). Optional - if not provided, returns voices of all types.

originalcustom

Response

200Success - Returns list of voice models with enhanced metadataapplication/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