HEheygen
Voices

List Voices

Changed on

Returns a paginated list of voices, filterable by type, engine, language, and gender. Speech generation supports Starfish, HeyGen Voice, and ElevenLabs. Each voice includes its speech default and available speech engines.

get/v3/voices

Request

  • Base URL
    https://api.heygen.com
  • URL
    https://api.heygen.com/v3/voices
  • Auth
    • API key in header x-api-key
    • or HTTP bearer

Query parameters

type'public' | 'private'

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

enginestring

Filter by stored engine mapping. Use 'heygen_voice' for HeyGen Voice; 'orca' remains accepted as its legacy alias. Also accepts 'starfish', 'elevenlabs' or internal engine names. Response engine values retain 'orca' for compatibility. The deprecated elevenlabs_v3 input alias is also accepted. Available engines may also include engines prepared on first use.

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
    }
  ]
}

Changes

  • 7dfa5e59b4f5Revision changes
    • info

      added the optional property // to the response with the status

    • info

      added the optional property // to the response with the status

    • info

      added the optional property / to the response with the status

    • info

      added the optional property / to the response with the status

    • info

      added the optional property / to the response with the status

    • info

      added the optional property / to the response with the status

    • info

      added the optional property / to the response with the status

    • info

      added the optional property / to the response with the status