Design a Custom Voice

Generate a new HeyGen voice from a natural-language description. No audio sample needed; describe the voice and HeyGen synthesizes it for use in your videos.

Steps

1. Describe the voice you want

   Use voice create with a natural language prompt:

   heygen voice create --prompt "warm, confident female narrator with a slight British accent"
   

   {
     "data": {
       "seed": 0,
       "voices": [
         {
           "voice_id": "BDfLWYibC6on6hn2IqEC",
           "name": "Warm Confident Narrator",
           "gender": "female",
           "language": "English",
           "preview_audio_url": "https://files2.heygen.ai/voice-design/previews/..."
         },
         {
           "voice_id": "1jgmj3JDxkh9ybd7CRzS",
           "name": "Warm Confident Narrator",
           "preview_audio_url": "..."
         },
         {
           "voice_id": "Db84ogyBT4thl08lVok8",
           "name": "Warm Pro Narrator",
           "preview_audio_url": "..."
         }
       ]
     }
   }
   

   You get up to 3 voice options. Each includes a preview_audio_url you can listen to before committing.

2. Get different options with --seed

   The same prompt with the same seed always returns the same voices. Increment --seed to explore new batches:

   heygen voice create --prompt "warm, confident female narrator" --seed 1
   heygen voice create --prompt "warm, confident female narrator" --seed 2
   
3. Use the voice in a video

   Take the voice_id and pass it to any video creation command.

   Video Agent (prompt-based)

   heygen video-agent create \
     --prompt "A presenter introducing our new product line" \
     --voice-id "BDfLWYibC6on6hn2IqEC"
   

   heygen video create -d '{
     "type": "avatar",
     "avatar_id": "avt_angela_01",
     "script": "Welcome to the future of video creation.",
     "voice_id": "BDfLWYibC6on6hn2IqEC"
   }'
   

Prompt tips

The quality of your voice depends on the quality of your description:

Prompt	Result
"deep male voice with authority, like a movie trailer narrator"	Dramatic, resonant bass
"friendly young woman, upbeat and energetic, American accent"	Casual, approachable
"calm, measured British male, BBC documentary style"	Professional, trustworthy
"enthusiastic tech reviewer, fast-paced, excited"	High energy, engaging
"soft-spoken female, ASMR-like, soothing"	Gentle, intimate delivery

Optional flags

Flag	Description
--gender	male or female — narrows results
--locale	BCP-47 locale tag (e.g. en-US, pt-BR) for accent targeting
--seed	Increment to get different batches (default: 0)

Browsing existing voices instead

If you’d rather use a stock voice:

# All English female voices
heygen voice list --language English --gender female --limit 20

# Private voices (ones you've created)
heygen voice list --type private