Voices API

Explore and search the library of 1,200+ AI voices spanning 29 languages. Each voice includes a preview URL so you can audition it before assigning it to a job.

Voice Override

When creating a job, pass an elevenlabs_voice_id to override the persona's default voice. If omitted, the persona's voice is used. If the persona has no voice, voice-over is skipped.

List Voices

Retrieve a paginated list of voices with optional filters.

GET/api/v1/voices

Parameters

Parameter	Type	Description
`gender`	string	Filter by gender. malefemale
`language`	string	Filter by supported language (ISO 639-1). Matches voices that include this language.
`accent`	string	Filter by accent (e.g., American, British, Australian).
`age`	string	Filter by age category. youngmiddle agedold
`use_case`	string	Filter by intended use case (e.g., narrator, social media).
`category`	string	Filter by voice category. professionalconversationalcharacter
`search`	string	Free-text search across voice names and descriptions.
`sort_by`	string Default: name	Sort field. nameusage_countcreated_ataccent
`sort_order`	string Default: asc	Sort direction. ascdesc
`page`	integer Default: 1	Page number. Min 1
`page_size`	integer Default: 20	Results per page. 1–100

Request Example

curl -X GET "https://api.u-gen.ai/api/v1/voices?gender=female&language=en&page=1&page_size=10" \
  -H "X-API-Key: YOUR_API_KEY"

Get Voice Details

Retrieve full details for a single voice including linked personas.

GET/api/v1/voices/{voice_id}

Path

Parameter	Type	Description
`voice_id`REQ	string	The ElevenLabs voice identifier.

Request Example

curl -X GET https://api.u-gen.ai/api/v1/voices/EXAVITQu4vr4xnSDxMaL \
  -H "X-API-Key: YOUR_API_KEY"

Get Filter Options

Returns unique values for all filterable voice fields. Use this to populate dropdown menus.

GET/api/v1/voices/filter-options

Request Example

curl -X GET https://api.u-gen.ai/api/v1/voices/filter-options \
  -H "X-API-Key: YOUR_API_KEY"

Additional Endpoints

The Voices API also includes GET /voices/featured (featured voices), GET /voices/trending (most-used voices), and GET /voices/by-ids?ids=... (batch lookup by IDs).