HEheygen
Voices

List voices for text-to-speech

Changed on

List voices available for TTS generation with cursor-based pagination. Filter by type (public/private), language, and gender.

get/v1/audio/voices

Request

  • Base URL
    https://api.heygen.com
  • URL
    https://api.heygen.com/v1/audio/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.

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