Voices

List Voices

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

curl --request GET \
  --url 'https://api.typecast.ai/v2/voices?model=ssfm-v30&gender=female&age=young_adult' \
  --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.

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

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

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?model=ssfm-v30&gender=female&age=young_adult' \
  --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"
  }
]

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

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

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

voice_idstring

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