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

# HeyGen Voice

> Compare HeyGen Voice, Turbo, and Turbo Free. Try public voices, create instant or professional clones, and generate completed or streaming speech.

![](https://mintcdn.com/heygen-1fa696a7/hfMXXwJzjE7vBSYZ/images/theme/research-3.webp?fit=max\&auto=format\&n=hfMXXwJzjE7vBSYZ\&q=85\&s=c8191ba4743fd85050f1af1a93ed4969)

HeyGen Voice is HeyGen's in-house voice model. Use a public voice or create a clone from a recording. Public voices and clones use the same speech endpoints. An instant voice can also speak a recording again: the same words and timing, in that voice.

> [!NOTE]
>
> **HeyGen Voice Turbo Free is free until November 30, 2026.** Use `"model": "heygen-voice-1-turbo-free"` with a public or instant voice. No credit balance is required. We will notify you before this offer changes.
>
> [Try it in the playground](https://platform.heygen.com/models/heygen-voice) · [Get a free API key](https://platform.heygen.com/api-keys)

## Choose a model

| Model | Voices | Speed and availability |
| - | - | - |
| `heygen-voice-1` | Public, instant, and professional | Standard speech generation |
| `heygen-voice-1-turbo` | Public and instant | Faster speech generation |
| `heygen-voice-1-turbo-free` | Public and instant | Turbo speech generation. Capacity is shared and limited. Response time and availability are not guaranteed. |

Use Turbo Free for tests, prototypes, and small amounts of speech; its `429` and `500` limits and retry steps are on [Turbo Free](https://heygen-1fa696a7.mintlify.site/docs/voices/heygen-voice-speech.md#turbo-free).

## Hear the public voices

[Listen to public voice samples in the playground](https://platform.heygen.com/models/heygen-voice), then use the same voice in the API. Start with **Nadine** (`83548de556df48ba8c09c42a57c51d85`) in the [free speech example](https://heygen-1fa696a7.mintlify.site/docs/voices/heygen-voice-speech.md#generate-completed-speech). No clone is needed.

To find more samples, call [`GET /v3/models/audio/voices?type=public`](https://heygen-1fa696a7.mintlify.site/reference/list-audio-voices) and [filter it](https://heygen-1fa696a7.mintlify.site/docs/voices/overview.md#find-a-public-voice) by `language`, `gender`, `age`, or a free-text `query`. Each `ACTIVE` voice includes a `preview_audio_url`. Play that URL to hear the voice before you generate speech.

## Choose a mode

| | Instant <sup>New</sup> | Professional |
| - | - | - |
| `mode` | `instant` | `professional` |
| You give it | One recording, ideally about 1 minute. The first 3 minutes are used. | 1–10 recordings of the same speaker, 20+ minutes in total |
| Ready | Usually within seconds | After training. Poll until `ACTIVE`. |
| Retrain | No. Create a new voice. | Yes, with new recordings |
| Speech controls | `expressiveness_boost`, [audio tags](https://heygen-1fa696a7.mintlify.site/docs/voices/heygen-voice-audio-tags.md) | `seed`, `speed`, `pitch_shift`, `pitch_variance`, `<break>` pauses |
| Cost to create | Free during the preview | One purchased voice clone slot per voice |
| Guide | [Instant Voice Clone](https://heygen-1fa696a7.mintlify.site/docs/voices/heygen-voice-instant-clone.md) | [Professional Voice Clone](https://heygen-1fa696a7.mintlify.site/docs/voices/professional-voice-clone.md) |

## Endpoints

| Endpoint | Purpose |
| - | - |
| [`POST /v3/models/audio/voices`](https://heygen-1fa696a7.mintlify.site/reference/create-or-retrain-an-audio-voice) | Create an instant or professional voice, or retrain a professional voice. |
| [`GET /v3/models/audio/voices/{voice_id}`](https://heygen-1fa696a7.mintlify.site/reference/get-an-audio-voice) | Read a voice: `mode`, `status`, and `failure_reason`. |
| [`GET /v3/models/audio/voices`](https://heygen-1fa696a7.mintlify.site/reference/list-audio-voices) | List your instant and professional voices, newest first, or HeyGen's public voices with `type=public`. Each `ACTIVE` voice has a `preview_audio_url`. |
| [`DELETE /v3/models/audio/voices/{voice_id}`](https://heygen-1fa696a7.mintlify.site/reference/delete-an-audio-voice) | Delete a voice. |
| [`POST /v3/models/audio/tts`](https://heygen-1fa696a7.mintlify.site/reference/generate-model-speech) | Generate one completed WAV. |
| [`POST /v3/models/audio/tts/stream`](https://heygen-1fa696a7.mintlify.site/reference/stream-speech) | Stream audio parts as they are generated. |
| [`WSS /v3/models/audio/tts/stream-input`](https://heygen-1fa696a7.mintlify.site/docs/voices/heygen-voice-speech#websocket-input-streaming) | Send text in pieces, such as LLM tokens, and receive audio on one WebSocket. Public and instant voices. |
| [`WSS /v3/models/audio/tts/multi-stream-input`](https://heygen-1fa696a7.mintlify.site/docs/voices/heygen-voice-speech#websocket-input-streaming) | Run up to five contexts on one WebSocket. Public and instant voices. |
| [`POST /v3/models/audio/tts/stream-input/tokens`](https://heygen-1fa696a7.mintlify.site/reference/create-speech-input-token) | Create a single-use WebSocket token for a client that cannot set headers, such as a browser. |
| [`POST /v3/models/audio/sts`](https://heygen-1fa696a7.mintlify.site/docs/voices/speech-to-speech) | Speak a recording again in an instant voice: same words and timing, one WAV. |

Send your API key in the `X-Api-Key` header; create one in the [API keys page](https://platform.heygen.com/api-keys). Voices belong to the workspace that created them.

## Voice slots

An instant voice is free to create during the preview and counts toward the workspace's voice clone allowance. A professional voice takes one purchased slot from the [Usage page](https://platform.heygen.com/usage); trainings per slot and the `voice_expired` behaviour past the slot limit are on [Slots and training allowance](https://heygen-1fa696a7.mintlify.site/docs/voices/professional-voice-clone.md#slots-and-training-allowance).

## Next steps

The same `voice_id` works in a video: pass it to [`POST /v3/videos`](https://heygen-1fa696a7.mintlify.site/reference/create-video). See [Voices](https://heygen-1fa696a7.mintlify.site/docs/voices/overview.md).

> [card] [Instant Voice Clone](https://heygen-1fa696a7.mintlify.site/docs/voices/heygen-voice-instant-clone.md)
>
> One recording, ready in seconds.

> [card] [Professional Voice Clone](https://heygen-1fa696a7.mintlify.site/docs/voices/professional-voice-clone.md)
>
> Train from 20+ minutes of recordings.

> [card] [Text to Speech](https://heygen-1fa696a7.mintlify.site/docs/voices/heygen-voice-speech.md)
>
> Completed or streaming speech from any `ACTIVE` voice.

> [card] [Speech to Speech](https://heygen-1fa696a7.mintlify.site/docs/voices/speech-to-speech.md)
>
> Speak a recording again in an instant voice.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.