Deprecated

List Voices (v2)

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

Request

  • Base URL: https://api.typecast.ai
  • URL: https://api.typecast.ai/v2/voices
  • Auth: API key in header X-API-KEY

Query parameters

model'ssfm-v30' | 'ssfm-v21'

TTS model version to use for speech synthesis. Different models offer varying capabilities and quality levels.

Available models:

  • ssfm-v30: Latest model with improved prosody and additional emotion presets (recommended)
  • ssfm-v21: Stable production model with proven reliability and consistent quality

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.

gender'male' | 'female'

Gender classification enum - Converts database values (Korean) to API values (English).

Available values:

  • male: Male voice
  • female: Female voice

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

age'child' | 'teenager' | 'young_adult' | 'middle_age' | 'elder'

Age group classification enum - Converts database values (Korean) to API values (English).

Available values:

  • child: Child voice (under 12 years old)
  • teenager: Teenage voice (13-19 years old)
  • young_adult: Young adult voice (20-35 years old)
  • middle_age: Middle-aged voice (36-60 years old)
  • elder: Elder voice (over 60 years old)

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.

use_cases'Announcer' | 'Anime' | 'Audiobook' | 'Conversational' | 'Documentary' | 'E-learning' | 'Rapper' | 'Game' | 'Tiktok/Reels' | 'News' | 'Podcast' | 'Voicemail' | 'Ads'

Voice use case categories for content type filtering. Each voice is tagged with one or more use cases indicating its suitability for specific content types.

Available Use Cases:

  • Announcer: Public announcements and presentations
  • Anime: Animation and character voices
  • Audiobook: Long-form narration and storytelling
  • Conversational: Chatbots and conversational AI
  • Documentary: Documentary narration and commentary
  • E-learning: Educational content and tutorials
  • Rapper: Rap and music performance
  • Game: Video game characters and narration
  • Tiktok/Reels: Short-form social media content
  • News: News broadcasting
  • Podcast: Broadcasting and podcast production
  • Voicemail: IVR systems and voice assistants
  • Ads: Advertising and promotional content

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.

voice_type'original' | 'custom'

Voice type classification.

  • original — Typecast-provided stock voices available to every account.
  • custom — Voices the user created by uploading or cloning their own sample.

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

Response

Success - Returns list of voice models with enhanced metadata

age'child' | 'teenager' | 'young_adult' | 'middle_age' | 'elder'

Age group classification enum - Converts database values (Korean) to API values (English).

Available values:

  • child: Child voice (under 12 years old)
  • teenager: Teenage voice (13-19 years old)
  • young_adult: Young adult voice (20-35 years old)
  • middle_age: Middle-aged voice (36-60 years old)
  • elder: Elder voice (over 60 years old)
gender'male' | 'female'

Gender classification enum - Converts database values (Korean) to API values (English).

Available values:

  • male: Male voice
  • female: Female voice
voice_idstring 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. Use /v3/voices to list the built-in and completed custom voices available to your account.

use_casesstring[]

List of use case categories this voice is suitable for

voice_namestring required

Human-readable name of the voice

voice_type'original' | 'custom' required

Voice type classification.

  • original — Typecast-provided stock voices available to every account.
  • custom — Voices the user created by uploading or cloning their own sample.

Changes

No recorded changes to this operation across all 1 revision of this API.