Voices

List Voices

Lists the built-in voices and completed custom voices available for use with any endpoint that accepts a voice_id. Custom voices appear first. Each voice_name is keyed by ISO 639-3 language codes such as eng and kor.

Use the optional filters together to narrow the catalog by model, gender, age group, use case, or voice type. preview_url is null when a preview is unavailable, including custom voices.

get/v3/voices

Request

  • Base URL: https://api.typecast.ai
  • URL: https://api.typecast.ai/v3/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 TTS model, such as ssfm-v21, ssfm-v30, or ssfm-v31.

gender'male' | 'female'

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

Available values:

  • male: Male voice
  • female: Female voice

Filter by voice gender (male or female).

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, or elder).

use_casesstring

Filter by a use-case keyword, such as Ads.

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).

Response

Voices retrieved successfully

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 and custom voices use the uc_ prefix.

use_casesstring[]

Recommended use-case categories.

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.
preview_urlstring nullable

Preview audio URL when available.

Changes

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