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

# Video Translation - Speed

> Translate videos into 175+ languages with the HeyGen Video Translation API. Preserves the speaker's voice, applies lipsync to the target language, and exports.

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

**Mode:** `"speed"` (default) Best for: fast turnaround, batch jobs, and workflows where time matters more than perfect lip-sync. For higher fidelity at the cost of latency, see [Precision mode](https://heygen-1fa696a7.mintlify.site/docs/video-translation-precision.md). For dozens or hundreds of videos in one job, see [Video Translation batches](https://heygen-1fa696a7.mintlify.site/batch-video-translations.md).

## How Lip Sync and Video Translation Relate

Both APIs sit on top of **one lip sync engine** that runs in two modes, **Speed** and **Precision**, trading latency for fidelity. What differs is what each API does *around* that engine:

* **[Lip Sync API](https://heygen-1fa696a7.mintlify.site/lipsync-speed.md)** is the engine on its own. You bring the video *and* your own audio; the engine redraws the mouth to match. Dialogue replacement only, no translation or audio generation.
* **[Video Translation API](https://heygen-1fa696a7.mintlify.site/docs/video-translate.md)** transcribes, translates and generates the translated audio, then optionally runs the engine:
  * **Audio only** (`translate_audio_only: true`) stops after the audio. The output is the new audio track (or the original video with swapped audio and an untouched mouth).
  * **Video (audio + visual)** runs the lip sync engine so the mouth matches the translated speech.

## Quick Start

### 1. List Supported Languages

Fetch the available target language codes via [`GET /v3/video-translations/languages`](https://heygen-1fa696a7.mintlify.site/reference/list-supported-translation-languages):

```bash theme={null}
curl --request GET \
  --url 'https://api.heygen.com/v3/video-translations/languages' \
  --header 'accept: application/json' \
  --header 'x-api-key: <your-api-key>'
```

### 2. Submit a Translation

Full schema: [`POST /v3/video-translations`](https://heygen-1fa696a7.mintlify.site/reference/create-video-translation). List several `output_languages` to translate into all of them in one request; the response returns one ID per language in `video_translation_ids`.

```bash theme={null}
curl --request POST \
  --url 'https://api.heygen.com/v3/video-translations' \
  --header 'accept: application/json' \
  --header 'x-api-key: <your-api-key>' \
  --header 'Content-Type: application/json' \
  --data '{
    "video": {
      "type": "url",
      "url": "<video_url>"
    },
    "output_languages": ["English", "Spanish", "French"],
    "mode": "speed",
    "title": "Global Campaign"
  }'
```

The source `video` is either `{ "type": "url", "url": "..." }` or `{ "type": "asset_id", "asset_id": "<asset_id>" }`. The URL must be publicly accessible (test by opening it in an incognito browser). To use an `asset_id`, upload first via [`POST /v3/assets`](https://heygen-1fa696a7.mintlify.site/reference/upload-asset), as the [Upload Assets guide](https://heygen-1fa696a7.mintlify.site/docs/upload-assets.md) shows.

### 3. Poll for Status

Poll [`GET /v3/video-translations/{video_translation_id}`](https://heygen-1fa696a7.mintlify.site/reference/get-video-translation) while `status` is `pending` or `running`. On `completed`, `video_url` is available; on `failed`, read `failure_message`. Skip polling by passing `callback_url` (and your own `callback_id`, echoed back) as described in [Webhooks](https://heygen-1fa696a7.mintlify.site/docs/webhooks.md).

## Speed Mode Options

Every optional parameter (`speaker_num`, `translate_audio_only`, `disable_music_track`, `enable_speech_enhancement` and more) is in the [create reference](https://heygen-1fa696a7.mintlify.site/reference/create-video-translation.md). Two behave in ways worth knowing:

* `enable_dynamic_duration` (default `true`) lets the output duration vary to match natural speech pacing. Billing is unaffected: translations are always charged on the source duration.
* `brand_glossary_id` applies a [brand glossary](https://heygen-1fa696a7.mintlify.site/docs/brand-glossary.md) (see [Keep terminology intact](#keep-terminology-intact)). `brand_voice_id` is its deprecated former name; both are accepted and resolve to the same glossary.

## Keep terminology intact

A [brand glossary](https://heygen-1fa696a7.mintlify.site/docs/brand-glossary.md) tells the translator which terms to leave alone and which to replace with a fixed form. Create one with [`POST /v3/brand-glossaries`](https://heygen-1fa696a7.mintlify.site/reference/create-brand-glossary):

```json Glossary create payload theme={null}
{
  "name": "Acme Translation Rules",
  "do_not_translate_terms": [{ "term": "HeyGen" }],
  "forced_translations": [{ "term": "CEO", "translation": "Geschäftsführer" }]
}
```

Then pass the returned `brand_glossary_id` at the top level of the translation request:

```json Translation request theme={null}
{
  "video": { "type": "url", "url": "<video_url>" },
  "output_languages": ["German"],
  "brand_glossary_id": "8c2d5e91a47b4f3c8d1e6a9b2f5c7d40"
}
```

Its `do_not_translate_terms` stay untranslated and its `forced_translations` get their exact replacement. Rules apply case-insensitively in every target language of the request. A `translation` is inserted verbatim, so pick a form that reads correctly without inflection. Glossaries created in the HeyGen app under **Brand Kit** carry the same rules and work the same way.

## Stock Voice (Enterprise)

By default, Video Translation clones the original speaker, so the translated video sounds like them. A preset "stock" voice instead speaks the translation in a natural voice optimized for clear pronunciation and accent in the target language. The trade-off: the result won't sound like the original speaker.

> [!NOTE]
>
> This is an Enterprise feature, available for selected accounts and languages and turned on by request. To use it, contact your HeyGen account team.

Add `stock_voice_config` to the translation request. `preferred_stock_voice_ids` is optional and pins specific voices; each entry is a Gemini voice name (e.g. `Erinome`, `Vindemiatrix`), not a UUID. Without it, the target language's default stock-voice pool is used.

```json theme={null}
"stock_voice_config": {
  "use_stock_voice": true,
  "preferred_stock_voice_ids": ["Erinome"]
}
```

## Captions

Captions are generated in SRT and VTT. A completed [`GET /v3/video-translations/{video_translation_id}`](https://heygen-1fa696a7.mintlify.site/reference/get-video-translation) carries them as presigned download URLs in `srt_caption_url` and `vtt_caption_url`, alongside `video_url`.

Each field appears once `status` is `completed` and that caption file is available. A field whose URL has not been produced is left out of the response entirely rather than returned as `null`, so read both with a presence check before using them. The `enable_caption` request field is retained for compatibility and no longer changes anything, since whether captions are displayed is a download-side choice.

## Proofread Before Finalizing

Both modes support the proofread workflow: review and edit subtitles before spending credits on final generation.

1. **Create a session** with [`POST /v3/video-translations/proofreads`](https://heygen-1fa696a7.mintlify.site/reference/create-proofread-session). It takes the same `video`, `output_languages`, `title` and `mode` as a translation and returns `proofread_ids`, one per language.

   ```bash theme={null}
   curl --request POST \
     --url 'https://api.heygen.com/v3/video-translations/proofreads' \
     --header 'x-api-key: <your-api-key>' \
     --header 'Content-Type: application/json' \
     --data '{
       "video": { "type": "url", "url": "<video_url>" },
       "output_languages": ["Spanish"],
       "title": "Review Before Publishing",
       "mode": "speed"
     }'
   ```

2. **Poll** [`GET /v3/video-translations/proofreads/{proofread_id}`](https://heygen-1fa696a7.mintlify.site/reference/get-proofread-session) until `completed`.

3. **Download and edit the SRT.** [`GET /v3/video-translations/proofreads/{proofread_id}/srt`](https://heygen-1fa696a7.mintlify.site/reference/download-proofread-srt) returns an `srt_url`. Edit the file locally, then upload the revised version with [Upload Proofread SRT](https://heygen-1fa696a7.mintlify.site/reference/upload-proofread-srt.md):

   ```bash theme={null}
   curl --request PUT \
     --url 'https://api.heygen.com/v3/video-translations/proofreads/<proofread_id>/srt' \
     --header 'x-api-key: <your-api-key>' \
     --header 'Content-Type: application/json' \
     --data '{ "srt": { "type": "url", "url": "<your_edited_srt_url>" } }'
   ```

4. **Generate the final video** with [`POST /v3/video-translations/proofreads/{proofread_id}/generate`](https://heygen-1fa696a7.mintlify.site/reference/generate-video-from-proofread), body `{ "captions": true }`. It returns a `video_translation_id` to poll as in step 3 of the Quick Start.

[`GET /v3/video-translations/proofreads`](https://heygen-1fa696a7.mintlify.site/reference/list-proofread-sessions) lists sessions and [`DELETE /v3/video-translations/proofreads/{proofread_id}`](https://heygen-1fa696a7.mintlify.site/reference/delete-proofread-session) removes one; see [Precision mode](https://heygen-1fa696a7.mintlify.site/docs/video-translation-precision.md#list-and-delete-proofread-sessions).

## Other Operations

[`GET /v3/video-translations`](https://heygen-1fa696a7.mintlify.site/reference/list-video-translations) lists translations (e.g. `?limit=10`), paged with `has_more` and `next_token`. [`DELETE /v3/video-translations/{video_translation_id}`](https://heygen-1fa696a7.mintlify.site/reference/delete-video-translation) removes one.

## When to Use Speed vs. Precision

| | Speed | [Precision](https://heygen-1fa696a7.mintlify.site/docs/video-translation-precision.md) |
| - | - | - |
| Processing Time | Faster | Slower |
| Translation | Adequate | Context- and Gender-Aware |
| Lip-Sync Quality | Standard | High |
| Best For | Faces with little movement, quick drafts | Faces with significant movement, side angles, or occlusions; final delivery videos |

For high-volume jobs across many source videos, see [Video Translation batches](https://heygen-1fa696a7.mintlify.site/batch-video-translations.md).


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