Skip to main content
GET
List Audio Voices

Authorizations

x-api-key
string
header
required

HeyGen API key. Obtain from your HeyGen dashboard.

Query Parameters

type
enum<string>
default:private

private lists the voices your workspace created. public lists the voices HeyGen provides to every workspace.

Available options:
private,
public
limit
integer
default:10

Maximum number of voices to return per page.

Required range: 1 <= x <= 100
language
string

Public list only. Language code, such as en. Matches voices whose native language is this language.

Required string length: 2 - 8
gender
enum<string>

Public list only. Voice gender.

Available options:
male,
female
age
enum<string>

Public list only. Voice age group.

Available options:
young,
middle_aged,
old
query
string

Public list only. Free text matched against voice names and descriptions, such as warm narrator. Results are ordered by relevance.

Required string length: 1 - 256
token
string

Opaque pagination token returned by a previous request.

Minimum string length: 1

Response

Successful response

data
ModelAudioVoiceResponse · object[]
has_more
boolean

Whether more pages are available

next_token
string | null

Opaque cursor for the next page