--- title: HeyGen Voice 1.0 Turbo Free | Runware Docs url: https://runware.ai/docs/models/heygen-voice-1-0-turbo-free description: HeyGen Voice Turbo on shared capacity for tests and prototypes --- # HeyGen Voice 1.0 Turbo Free ![HeyGen Voice 1.0 Turbo Free](https://assets.runware.ai/covers/heygen-voice-1-0-turbo-free.jpg) HeyGen Voice 1.0 Turbo Free runs HeyGen Voice 1.0 Turbo on shared, limited capacity. It offers the same public voices, instant voice cloning from a single recording and 39 languages, but response time and availability are not guaranteed. It suits tests, prototypes and small amounts of speech. - **Status**: live - **ID**: `heygen:voice@1.0-turbo-free` - Try in Playground - **Creator**: HeyGen - **Release Date**: October 22, 2026 - **Zero Data Retention**: Yes - **Capabilities**: Text to Audio, Audio to Audio, Checkpoint ## Compatibility & Validation Provide exactly one of: `speech.voice`, `inputs.audio`. ## Notes HeyGen Voice 1.0 Turbo Free speaks with a voice chosen in one of two ways, and a request sends exactly one of them: - **Public voice:** Set `speech.voice` to one of HeyGen's public voices. - **Cloned voice:** Send a recording of the speaker in `inputs.audio`. The model clones the voice, speaks `speech.text` with it and returns its ID in `outputs.voiceId`. Send that ID as `speech.voice` in later requests from the same organization to reuse the voice without the recording. ## Request Parameters **API Options** Platform-level options for task execution and delivery. ### [taskType](https://runware.ai/docs/models/heygen-voice-1-0-turbo-free#request-tasktype) - **Type**: `string` - **Required**: true - **Value**: `audioInference` Identifier for the type of task being performed. ### [taskUUID](https://runware.ai/docs/models/heygen-voice-1-0-turbo-free#request-taskuuid) - **Type**: `string` - **Required**: true - **Format**: `UUID v4` UUID v4 identifier for tracking tasks and matching async responses. Must be unique per task. ### [outputType](https://runware.ai/docs/models/heygen-voice-1-0-turbo-free#request-outputtype) - **Type**: `string` - **Default**: `URL` Audio output type. **Allowed values**: `URL` `base64Data` `dataURI` ### [outputFormat](https://runware.ai/docs/models/heygen-voice-1-0-turbo-free#request-outputformat) - **Type**: `string` - **Default**: `MP3` Specifies the file format of the generated output. The available values depend on the task type and the specific model's capabilities. - \`MP3\`: Compressed audio, smaller file size. - \`WAV\`: Uncompressed, high-quality audio. - \`FLAC\`: Lossless compression. - \`OGG\`: Open-source compressed audio format (Vorbis codec). **Allowed values**: `MP3` `WAV` `FLAC` `OGG` ### [audioSettings](https://runware.ai/docs/models/heygen-voice-1-0-turbo-free#request-audiosettings) - **Path**: `audioSettings.bitrate` - **Type**: `object (3 properties)` Audio encoding settings for controlling the bitrate, number of channels, and sample rate of the generated audio. Only applicable for lossy output formats (`MP3` and `OGG`). When using lossless formats (`WAV` or `FLAC`), this parameter must not be provided. The available sample rates and valid bitrate ranges depend on the output format. For `OGG`, bitrate limits also vary by the number of channels. **MP3 bitrate limits**: Bitrate limits for MP3 are the same regardless of mono or stereo. | Sample Rate | Min Bitrate | Max Bitrate | | --- | --- | --- | | 8,000 Hz | 8 kbps | 64 kbps | | 11,025 Hz | 8 kbps | 64 kbps | | 12,000 Hz | 8 kbps | 64 kbps | | 16,000 Hz | 8 kbps | 160 kbps | | 22,050 Hz | 8 kbps | 160 kbps | | 24,000 Hz | 8 kbps | 160 kbps | | 32,000 Hz | 32 kbps | 320 kbps | | 44,100 Hz | 32 kbps | 320 kbps | | 48,000 Hz | 32 kbps | 320 kbps | **OGG bitrate limits — Mono (1 channel)**: | Sample Rate | Min Bitrate | Max Bitrate | | --- | --- | --- | | 8,000 Hz | 8 kbps | 40 kbps | | 12,000 Hz | 16 kbps | 48 kbps | | 16,000 Hz | 16 kbps | 96 kbps | | 24,000 Hz | 16 kbps | 80 kbps | | 48,000 Hz | 32 kbps | 224 kbps | **OGG bitrate limits — Stereo (2 channels)**: | Sample Rate | Min Bitrate | Max Bitrate | | --- | --- | --- | | 8,000 Hz | 16 kbps | 80 kbps | | 12,000 Hz | 16 kbps | 96 kbps | | 16,000 Hz | 24 kbps | 192 kbps | | 24,000 Hz | 32 kbps | 160 kbps | | 48,000 Hz | 48 kbps | 256 kbps | > [!NOTE] > **Lossless formats**: When `outputFormat` is set to `WAV` or `FLAC`, the `audioSettings` parameter is not available since these formats produce uncompressed or lossless audio with no configurable encoding settings. #### [bitrate](https://runware.ai/docs/models/heygen-voice-1-0-turbo-free#request-audiosettings-bitrate) - **Path**: `audioSettings.bitrate` - **Type**: `integer` - **Min**: `8` Audio bitrate in kbps. #### [channels](https://runware.ai/docs/models/heygen-voice-1-0-turbo-free#request-audiosettings-channels) - **Path**: `audioSettings.channels` - **Type**: `integer` - **Default**: `2` Number of audio channels. 1 for mono, 2 for stereo. **Allowed values**: `1` `2` #### [sampleRate](https://runware.ai/docs/models/heygen-voice-1-0-turbo-free#request-audiosettings-samplerate) - **Path**: `audioSettings.sampleRate` - **Type**: `integer` Audio sample rate in Hz. ### [webhookURL](https://runware.ai/docs/models/heygen-voice-1-0-turbo-free#request-webhookurl) - **Type**: `string` - **Format**: `uri` Webhook URL that receives JSON responses via HTTP POST when generation tasks complete. For batch requests with multiple results, each completed item triggers a separate webhook call as it becomes available. **Learn more** (1 resource): - [Webhooks](https://runware.ai/docs/models-api/webhooks) (platform) ### [deliveryMethod](https://runware.ai/docs/models/heygen-voice-1-0-turbo-free#request-deliverymethod) - **Type**: `string` - **Default**: `sync` Determines how the API delivers task results. **Allowed values**: - `sync` Returns complete results directly in the API response. - `async` Returns an immediate acknowledgment with the task UUID. Poll for results using getResponse. **Learn more** (1 resource): - [Task Polling](https://runware.ai/docs/models-api/task-polling) (platform) ### [uploadEndpoint](https://runware.ai/docs/models/heygen-voice-1-0-turbo-free#request-uploadendpoint) - **Type**: `string` - **Format**: `uri` Specifies a URL where the generated content will be automatically uploaded using the HTTP PUT method. The raw binary data of the media file is sent directly as the request body. For secure uploads to cloud storage, use presigned URLs that include temporary authentication credentials. **Common use cases:** - **Cloud storage**: Upload directly to S3 buckets, Google Cloud Storage, or Azure Blob Storage using presigned URLs. - **CDN integration**: Upload to content delivery networks for immediate distribution. ```text // S3 presigned URL for secure upload https://your-bucket.s3.amazonaws.com/generated/content.mp4?X-Amz-Signature=abc123&X-Amz-Expires=3600 // Google Cloud Storage presigned URL https://storage.googleapis.com/your-bucket/content.jpg?X-Goog-Signature=xyz789 // Custom storage endpoint https://storage.example.com/uploads/generated-image.jpg ``` The content data will be sent as the request body to the specified URL when generation is complete. ### [ttl](https://runware.ai/docs/models/heygen-voice-1-0-turbo-free#request-ttl) - **Type**: `integer` - **Min**: `60` Time-to-live (TTL) in seconds for generated content. Only applies when `outputType` is `URL`. ### [includeCost](https://runware.ai/docs/models/heygen-voice-1-0-turbo-free#request-includecost) - **Type**: `boolean` Include task cost in the response. ### [numberResults](https://runware.ai/docs/models/heygen-voice-1-0-turbo-free#request-numberresults) - **Type**: `integer` - **Min**: `1` - **Max**: `4` - **Default**: `1` Number of results to generate. Each result uses a different seed, producing variations of the same parameters. ### [routing](https://runware.ai/docs/models/heygen-voice-1-0-turbo-free#request-routing) - **Path**: `routing.preferences` - **Type**: `object (6 properties)` Model router options. Only read when `model` is `auto`, and never sent to the model. #### [preferences](https://runware.ai/docs/models/heygen-voice-1-0-turbo-free#request-routing-preferences) - **Path**: `routing.preferences` - **Type**: `object (3 properties)` Relative importance of each dimension when models are compared. Weights, not thresholds. ##### [quality](https://runware.ai/docs/models/heygen-voice-1-0-turbo-free#request-routing-preferences-quality) - **Path**: `routing.preferences.quality` - **Type**: `integer` - **Min**: `0` - **Max**: `5` Importance of one dimension. `0` leaves it out of the decision. ##### [speed](https://runware.ai/docs/models/heygen-voice-1-0-turbo-free#request-routing-preferences-speed) - **Path**: `routing.preferences.speed` - **Type**: `integer` - **Min**: `0` - **Max**: `5` Importance of one dimension. `0` leaves it out of the decision. ##### [cost](https://runware.ai/docs/models/heygen-voice-1-0-turbo-free#request-routing-preferences-cost) - **Path**: `routing.preferences.cost` - **Type**: `integer` - **Min**: `0` - **Max**: `5` Importance of one dimension. `0` leaves it out of the decision. #### [maxPrice](https://runware.ai/docs/models/heygen-voice-1-0-turbo-free#request-routing-maxprice) - **Path**: `routing.maxPrice` - **Type**: `float` - **Min**: `0` Upper bound on what this request may cost, in USD. A model whose cost cannot be bounded is not chosen. #### [requirements](https://runware.ai/docs/models/heygen-voice-1-0-turbo-free#request-routing-requirements) - **Path**: `routing.requirements` - **Type**: `string` - **Max**: `3000` Conditions the result has to meet, in plain words, such as a style or a feature. A model that cannot meet them is not chosen. Output size is set with width and height rather than described here. **Inputs** Input resources for the task (images, audio, etc). These must be nested inside the \`inputs\` object. ### [audio](https://runware.ai/docs/models/heygen-voice-1-0-turbo-free#request-inputs-audio) - **Path**: `inputs.audio` - **Type**: `string` - **File size**: `up to 100 MB` Audio input (UUID or URL). Recording to clone the voice from. Only the first 3 minutes are used. **Core Parameters** Primary parameters that define the task output. ### [model](https://runware.ai/docs/models/heygen-voice-1-0-turbo-free#request-model) - **Type**: `string` - **Required**: true - **Value**: `heygen:voice@1.0-turbo-free` Send `auto` instead of an AIR identifier to have the model router choose the model for this task. The rest of the request is unchanged, every value you send is kept, and only the parameters you leave out are filled in. See [Model Router](https://runware.ai/docs/models-api/model-router). **Learn more** (3 resources): - [Text To Image: Model Selection](https://runware.ai/docs/learn/text-to-image#model-selection) (learn) - [Image Inpainting: Model Specialized Inpainting Models](https://runware.ai/docs/learn/image-inpainting#model-specialized-inpainting-models) (learn) - [Image Outpainting: Other Critical Parameters](https://runware.ai/docs/learn/image-outpainting#other-critical-parameters) (learn) ### [speech](https://runware.ai/docs/models/heygen-voice-1-0-turbo-free#request-speech) - **Path**: `speech.text` - **Type**: `object (3 properties)` - **Required**: true Settings for speech generation. #### [text](https://runware.ai/docs/models/heygen-voice-1-0-turbo-free#request-speech-text) - **Path**: `speech.text` - **Type**: `string` - **Required**: true - **Min**: `1` - **Max**: `5000` Text to convert to speech. Plain text only, so SSML and `` tags are not supported. #### [voice](https://runware.ai/docs/models/heygen-voice-1-0-turbo-free#request-speech-voice) - **Path**: `speech.voice` - **Type**: `string` Voice identifier to use for speech generation. A public HeyGen voice, or the `outputs.voiceId` of an earlier `inputs.audio` request from the same organization. **Allowed values**: - `fca00394b42949c2a939acd456e3291f` Bram, calm and gentle. - `41f17b4ebd334ac99a91c2aada5f86d7` Cecily, warm and friendly. - `69a83c97b51a4bb5a3d0fb0ce1699431` Corinne, bright and energetic. - `3195f3da04c94984a0a77a4b757c8119` Elowen, warm and soothing. - `5f9c155f4108437f970c308c95b06e11` Ewan, bright and energetic. - `6ab7f456be114a109f8c8006567f638c` Felicity, upbeat and lively. - `826be797681d4b1a92042b54b3c75c64` Gareth, conversational and easygoing. - `9b71011176ac49ee8d0936c36566d665` Hugh, firm and measured. - `660022d4c7ff428cbb5787685e8df571` Iona, bright and energetic. - `f415c3cd23db47c1b4fe834387d26449` Jocelyn, bright and energetic. - `7e48c8d406b04a8089c5eb3cd057cb2e` Jonah, clear and professional. - `d322a996ccc54505a170d5f9db7fd7dd` Kieran, warm and friendly. - `049413e41c334753984c294d694afb5c` Lucian, conversational and easygoing. - `880609d7e76e4360ba44e65f0774d4e6` Marielle, upbeat and lively. - `aa9746e325ff46d482a54fe5bc87890f` Meredith, serious and composed. - `83548de556df48ba8c09c42a57c51d85` Nadine, calm and gentle. - `48476d5a314943149b9522fb666b128a` Noelle, warm and soothing. - `7bb4df56d7714d33bb88ed1dde8128f6` Rory, upbeat and lively. - `75300849b571414c8d62693289cb6509` Sabrina, upbeat and lively. - `8be9884ebd16499fbe0efb274e769ed5` Simon, calm and gentle. - `95fae2bb58b647c58ea32e6667f86b0e` Soren, firm and measured. - `a6752292cd204ac4a80a25fb575b1327` Tabitha, conversational and easygoing. - `f43e55ae9fb540c6b62e23081c951748` Vincent, thoughtful and clear. - `742d54da82fb46a8be11480d9ec6e3c3` Weston, warm and friendly. #### [language](https://runware.ai/docs/models/heygen-voice-1-0-turbo-free#request-speech-language) - **Path**: `speech.language` - **Type**: `string` - **Min**: `1` Language code for speech generation. Detected from `speech.text` when omitted. **Allowed values**: `ar` `be` `bg` `ca` `cs` `da` `de` `el` `en` `es` `fa` `fi` `fr` `he` `hi` `hr` `hu` `id` `it` `ja` `ko` `mk` `ms` `nl` `pl` `pt` `ro` `ru` `sk` `sl` `sr` `sv` `ta` `th` `tl` `tr` `uk` `vi` `zh` **Settings** Technical parameters to fine-tune the inference process. These must be nested inside the \`settings\` object. ### [expressiveness](https://runware.ai/docs/models/heygen-voice-1-0-turbo-free#request-settings-expressiveness) - **Path**: `settings.expressiveness` - **Type**: `float` - **Min**: `0` - **Max**: `1` - **Step**: `0.01` - **Default**: `1` Expressiveness of the delivery. ## Response Parameters ### [taskType](https://runware.ai/docs/models/heygen-voice-1-0-turbo-free#response-tasktype) - **Type**: `string` - **Required**: true - **Value**: `audioInference` Identifier for the type of task this response belongs to. ### [taskUUID](https://runware.ai/docs/models/heygen-voice-1-0-turbo-free#response-taskuuid) - **Type**: `string` - **Required**: true - **Format**: `UUID v4` UUID v4 identifier echoed from the original request, used to match async responses to their tasks. ### [audioUUID](https://runware.ai/docs/models/heygen-voice-1-0-turbo-free#response-audiouuid) - **Type**: `string` - **Required**: true - **Format**: `UUID v4` UUID of the output audio. ### [audioURL](https://runware.ai/docs/models/heygen-voice-1-0-turbo-free#response-audiourl) - **Type**: `string` - **Format**: `uri` URL of the output audio. ### [audioBase64Data](https://runware.ai/docs/models/heygen-voice-1-0-turbo-free#response-audiobase64data) - **Type**: `string` Base64-encoded audio data. ### [audioDataURI](https://runware.ai/docs/models/heygen-voice-1-0-turbo-free#response-audiodatauri) - **Type**: `string` - **Format**: `uri` Data URI of the output audio. ### [seed](https://runware.ai/docs/models/heygen-voice-1-0-turbo-free#response-seed) - **Type**: `integer` The seed used for generation. If none was provided, shows the randomly generated seed. ### [cost](https://runware.ai/docs/models/heygen-voice-1-0-turbo-free#response-cost) - **Type**: `float` Task cost in USD. Present when `includeCost` is set to `true` in the request. ### [outputs](https://runware.ai/docs/models/heygen-voice-1-0-turbo-free#response-outputs) - **Path**: `outputs.voiceId` - **Type**: `object (1 property)` Generated output artifacts. #### [voiceId](https://runware.ai/docs/models/heygen-voice-1-0-turbo-free#response-outputs-voiceid) - **Path**: `outputs.voiceId` - **Type**: `string` ID of the voice cloned from `inputs.audio`, returned only when `inputs.audio` is sent. Pass it as `speech.voice` in later requests from the same organization. ## Examples ### text-to-audio (text-to-audio) [Listen to audio](https://assets.runware.ai/examples/heygen-voice-1-0-turbo-free/cb0907fc-0917-4ac9-9a12-c87c9cdf0a29.mp3) > **Prompt**: When you discover water near archival materials, protect yourself before protecting the collection. Do not enter if electrical equipment is wet or the ceiling appears unstable. Once the area is safe, photograph the damage and identify the source of the leak. Move dry items first, then place damp records in clean crates with space for air to circulate. Never separate soaked pages by force. Record every item you relocate so the conservation team can begin recovery without losing its original context. ```json { "taskType": "audioInference", "taskUUID": "9d029df7-ccae-4500-babd-6f882c3cecf7", "model": "heygen:voice@1.0-turbo-free", "speech": { "text": "When you discover water near archival materials, protect yourself before protecting the collection. Do not enter if electrical equipment is wet or the ceiling appears unstable. Once the area is safe, photograph the damage and identify the source of the leak. Move dry items first, then place damp records in clean crates with space for air to circulate. Never separate soaked pages by force. Record every item you relocate so the conservation team can begin recovery without losing its original context.", "voice": "aa9746e325ff46d482a54fe5bc87890f", "language": "en" } } ``` --- ### text-to-audio (text-to-audio) [Listen to audio](https://assets.runware.ai/examples/heygen-voice-1-0-turbo-free/fec319f1-fa07-4e2c-9232-2051d7e84d6d.mp3) > **Prompt**: Tides turn, ropes tighten, and another working day begins. This is Harbor Signal. ```json { "taskType": "audioInference", "taskUUID": "eac0666c-cef7-4fc5-a9aa-0d666bb97ff4", "model": "heygen:voice@1.0-turbo-free", "speech": { "text": "Tides turn, ropes tighten, and another working day begins. This is Harbor Signal.", "voice": "95fae2bb58b647c58ea32e6667f86b0e", "language": "en" } } ``` --- ### voice-cloning (voice-cloning) [Listen to audio](https://assets.runware.ai/examples/heygen-voice-1-0-turbo-free/f6ec9760-f67a-4fb4-ac93-dde182130d5a.mp3) > **Prompt**: Historic fragrances are stored in small, tightly sealed vessels because every opening releases volatile molecules. Before handling a sample, put on nitrile gloves and confirm its accession number against the worksheet. Keep the vessel upright, away from direct light, and open it only inside the ventilated assessment station. Never smell directly from the container. Instead, use a disposable scent strip and allow several seconds for the aroma to develop. Record changes in color, clarity, and scent character, then reseal the vessel immediately. If you notice leakage, crystallization, or pressure beneath the stopper, stop work and notify the collection manager. ```json { "taskType": "audioInference", "taskUUID": "e50e1595-1460-4554-a181-c5e6dfcafc4f", "model": "heygen:voice@1.0-turbo-free", "speech": { "text": "Historic fragrances are stored in small, tightly sealed vessels because every opening releases volatile molecules. Before handling a sample, put on nitrile gloves and confirm its accession number against the worksheet. Keep the vessel upright, away from direct light, and open it only inside the ventilated assessment station. Never smell directly from the container. Instead, use a disposable scent strip and allow several seconds for the aroma to develop. Record changes in color, clarity, and scent character, then reseal the vessel immediately. If you notice leakage, crystallization, or pressure beneath the stopper, stop work and notify the collection manager.", "language": "en" }, "inputs": { "audio": "https://assets.runware.ai/assets/inputs/fe3e9367-7ebf-4454-a9a4-a83916d65a74.mp3" } } ``` --- ### voice-cloning (voice-cloning) [Listen to audio](https://assets.runware.ai/examples/heygen-voice-1-0-turbo-free/c05ac2fa-48a9-41c8-ba6e-ea922db0030d.mp3) > **Prompt**: At 03:17 UTC, two commercial satellites passed close enough to trigger a collision alert. Nothing struck. No hardware failed. But before breakfast, operators, regulators, and insurers were already disputing who should have moved first. In orbit, even a near miss can expose gaps in contracts written decades before today’s crowded skies. This is The Fine Print Above Us, the podcast about risk beyond the atmosphere. Today, we follow one warning through mission control, underwriting desks, and international law to ask a deceptively simple question: when everyone shares the orbit, who owns the responsibility? ```json { "taskType": "audioInference", "taskUUID": "48af7ffb-b3f8-4cdf-95a8-bb3fd2008185", "model": "heygen:voice@1.0-turbo-free", "speech": { "text": "At 03:17 UTC, two commercial satellites passed close enough to trigger a collision alert. Nothing struck. No hardware failed. But before breakfast, operators, regulators, and insurers were already disputing who should have moved first. In orbit, even a near miss can expose gaps in contracts written decades before today’s crowded skies. This is The Fine Print Above Us, the podcast about risk beyond the atmosphere. Today, we follow one warning through mission control, underwriting desks, and international law to ask a deceptively simple question: when everyone shares the orbit, who owns the responsibility?" }, "inputs": { "audio": "https://assets.runware.ai/assets/inputs/8977aec0-2fa6-4ad8-9f59-0fba8fc9fc76.mp3" } } ```