> ## Documentation Index
> Fetch the complete documentation index at: https://heygen-1fa696a7.mintlify.app/llms.txt
> Use this file to discover all available pages before exploring further.

# 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

<Steps>
  <Step title="Describe the voice you want">
    Use `voice create` with a natural language prompt:

    ```bash theme={null}
    heygen voice create --prompt "warm, confident female narrator with a slight British accent"
    ```

    ```json theme={null}
    {
      "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.
  </Step>

  <Step title="Get different options with --seed">
    The same prompt with the same seed always returns the same voices. Increment `--seed` to explore new batches:

    ```bash theme={null}
    heygen voice create --prompt "warm, confident female narrator" --seed 1
    heygen voice create --prompt "warm, confident female narrator" --seed 2
    ```
  </Step>

  <Step title="Use the voice in a video">
    Take the `voice_id` and pass it to any video creation command.

    <CodeGroup>
      ```bash Video Agent (prompt-based) theme={null}
      heygen video-agent create \
        --prompt "A presenter introducing our new product line" \
        --voice-id "BDfLWYibC6on6hn2IqEC"
      ```

      ```bash Video Create (full control) theme={null}
      heygen video create -d '{
        "type": "avatar",
        "avatar_id": "avt_angela_01",
        "script": "Welcome to the future of video creation.",
        "voice_id": "BDfLWYibC6on6hn2IqEC"
      }'
      ```
    </CodeGroup>
  </Step>
</Steps>

## 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:

```bash theme={null}
# All English female voices
heygen voice list --language English --gender female --limit 20

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