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

# Multilingual Content

> Localize video content into 175+ languages with the HeyGen API. Preserves voice characteristics and lipsync; pairs with translation for end-to-end global.

## See It in Action

One video, generated in English, then translated into multiple languages with lip-sync — stitched together:

[https://www.loom.com/embed/ad62bbbdbfef4961bcd6e8c110768c50](https://www.loom.com/embed/ad62bbbdbfef4961bcd6e8c110768c50)

## The Problem

Professional dubbing costs thousands of dollars per language. Most companies either skip localization entirely or settle for subtitles — missing the large audience that prefers content in their native language.

## How It Works

```
Create source video (Video Agent) → Translate (Video Translation API) → Distribute per region
```

Generate your video once in one language. Then translate it into as many languages as you need — with lip-sync so the avatar's mouth matches the translated audio.

## Build It

**1. Create your source video**

Generate the original video using any workflow — [social content](https://heygen-1fa696a7.mintlify.site/social-media-content-pipeline), [product demo](https://heygen-1fa696a7.mintlify.site/product-demo-videos), [training](https://heygen-1fa696a7.mintlify.site/training-and-onboarding-videos), etc.

```python theme={null}
import requests

resp = requests.post(
    "https://api.heygen.com/v3/video-agents",
    headers={
        "X-Api-Key": HEYGEN_API_KEY,
        "Content-Type": "application/json",
    },
    json={
        "prompt": "Create a 60-second product overview of TaskFlow, a project management app..."
    },
)
source_video_id = resp.json()["data"]["video_id"]
# ... poll until completed, get video_url
```

**2. Translate into multiple languages**

Use the Video Translation API to translate into multiple languages in a single request.

```python theme={null}
target_languages = ["Spanish", "French", "German", "Japanese", "Chinese", "Portuguese", "Korean", "Arabic", "Hindi"]

resp = requests.post(
    "https://api.heygen.com/v3/video-translations",
    headers={
        "X-Api-Key": HEYGEN_API_KEY,
        "Content-Type": "application/json",
    },
    json={
        "video": {"type": "url", "url": source_video_url},
        "output_languages": target_languages,
        "enable_caption": True,
        # "mode": "precision"  # For premium lip-sync quality
    },
)
translation_ids = resp.json()["data"]["video_translation_ids"]  # one per language
```

Language names come from [`GET /v3/video-translations/languages`](https://heygen-1fa696a7.mintlify.site/reference/list-supported-translation-languages) — pass names (e.g. `"Spanish (Spain)"`), not ISO codes.

See [Video Translation docs](https://heygen-1fa696a7.mintlify.site/docs/video-translate.md) for all supported languages and options.

**3. Choose your quality mode**

Two modes with different quality tradeoffs:

| Mode | Lip-sync quality | Best for |
| - | - | - |
| **Speed** (default) | Good | Most content, fast turnaround |
| **Precision** | Premium | Face-heavy videos, brand content |

**4. Generate captions**

Get subtitle files for each translated version.

```python theme={null}
# After translation is complete (enable_caption was set at create time)
for translation_id in translation_ids:
    job = requests.get(
        f"https://api.heygen.com/v3/video-translations/{translation_id}",
        headers={"X-Api-Key": HEYGEN_API_KEY},
    ).json()["data"]
    srt_url = job["srt_caption_url"]   # or job["vtt_caption_url"]
```

> [!NOTE]
>
> Caption URLs expire after 7 days but are regenerated each time you request them.

**5. Distribute per region**

Now you have the source video + 9 translated versions + captions for each. Distribute based on your audience's region.

```python theme={null}
# Example: organize outputs by language
for lang in target_languages:
    print(f"{lang}: video_url=..., caption_url=...")
    # Upload to regional CDN, post to regional social accounts, etc.
```

## Real-World Results

These results are reported by companies via [HeyGen's customer stories](https://www.heygen.com/customer-stories):

| Company | What they did | Reported result |
| - | - | - |
| **Trivago** | Localized TV ads across 30 markets | Halved post-production time |
| **Würth** | Translated employee training | Reported 80% reduction in translation costs |
| **McDonald's** | "Grandma McFlurry" campaign translated globally | Used HeyGen for multi-language distribution |

## Workflow: Translate Everything You Generate

Once you have a translation pipeline, apply it to every video you create:

```
Social Media Pipeline → Generate 5 English videos → Translate each to 9 languages = 45 videos
Training Pipeline → Generate 10 module videos → Translate to 7 languages = 70 training videos
Product Demo → Generate 1 demo → Translate to 5 key markets = 5 localized demos
```

The marginal cost per additional language is minimal compared to the reach it unlocks.

## Variations

* **Audio-only translation:** Keep the original video visuals, just change the voiceover — useful when lip-sync isn't critical
* **Subtitle-only:** Generate captions without re-rendering the video — cheapest option for supplementary languages
* **Regional adaptation:** Use different Video Agent prompts per region (not just translation but cultural adaptation) for high-priority markets

***

## Next Steps

> [card] [Training & Onboarding](https://heygen-1fa696a7.mintlify.site/training-and-onboarding-videos)
>
> Generate the training content that feeds into this pipeline.

> [card] [Social Media Pipeline](https://heygen-1fa696a7.mintlify.site/social-media-content-pipeline)
>
> Multiply your social content across languages.


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