v1

latestOpenAPI 3.1.02026-07-2665164286.3 KB

Voices

List Voices

Returns a paginated list of voices, filterable by type, engine, language, and gender. Use engine=starfish for voices compatible with the TTS endpoint.

get/v3/voices

Query parameters

type'public' | 'private'

Voice type: 'public' for the shared library or 'private' for your cloned voices.

enginestring

Filter by voice engine (e.g. 'starfish'). When set, only voices compatible with that engine are returned.

languagestring

Filter by language (e.g. 'English').

genderstring

Filter by gender ('male' or 'female').

limitinteger

Results per page (1-100).

tokenstring

Opaque cursor token for the next page.

Response

Successful response

has_moreboolean

Whether more pages are available

next_tokenstring nullable

Opaque cursor for the next page

Example response

{
  "data": [
    {
      "voice_id": "1bd001e7e50f421d891986aad5c8bbd2",
      "name": "Sara",
      "language": "English",
      "gender": "female",
      "preview_audio_url": "https://files.heygen.ai/voice/preview_sara.mp3",
      "support_pause": true,
      "support_locale": true
    }
  ]
}