Skip to main content
GET
Retrieves a paginated list of voices. You can request public voices from our voice library, your custom cloned voices, or both.

Query Parameters

type
string
default:"all"
The type of voices to retrieve.Allowed values: public, cloned, all
  • public: Public library voices available to all users
  • cloned: Your custom cloned voices
  • all: Both public and cloned voices (default)
gender
string
Filter voices by gender.Allowed values: male, female
age
string
Filter voices by age group.Allowed values: young, middle_aged, old
language
string
Filter voices by language (ISO 639-1 code).Allowed values: en, es, pt, de, fr, it, ca
limit
integer
default:"20"
Maximum number of voices to return per page.Range: 1-100
offset
integer
default:"0"
Number of voices to skip (for pagination).Minimum: 0

Response

voices
array
required
List of voice objects.
pagination
object
required
Pagination information.

Usage with Video Creation

Once you’ve retrieved the voice list, use the voice voice_id when creating videos:

Error Codes

See Error Handling for more details.