# HeyGen Video Translate

> Run HeyGen Video Translate by heygen online or via API. $0.033/sec (speed), $0.067/sec (precision), $0.033/sec (audio-only), no setup.

**URL:** https://inference.sh/apps/heygen/video-translate
**Last updated:** 2026-11-11

---

Translate videos into 30+ languages with voice cloning and lip-sync using HeyGen. Supports speed and precision modes with optional captioning.

- app: `heygen/video-translate`
- maker: [heygen](https://inference.sh/apps/heygen.md)
- category: [video](https://inference.sh/apps/category/video.md)
- tasks: [lip sync](https://inference.sh/apps/tag/lip-sync.md), [voice cloning](https://inference.sh/apps/tag/voice-cloning.md), [dubbing](https://inference.sh/apps/tag/dubbing.md)
- price: $0.033/sec (speed), $0.067/sec (precision), $0.033/sec (audio-only)
- runs via: api, javascript and python sdk, belt cli, mcp

## video-translate API Guide

### About
translate videos into 30+ languages with voice cloning and lip-sync using heygen. supports speed and precision modes with optional captioning.

### Get an API Key
Create one in [settings → api keys](https://app.inference.sh/settings/keys). The examples read it from `INFERENCE_API_KEY`.

```bash
export INFERENCE_API_KEY="inf_your_key"
```

### 1. Calling the API

#### Install the Client

```bash
pip install inferencesh
```

#### Run and Get Result
Submit a request and wait for the final result.

```python
import os
from inferencesh import inference

client = inference(api_key=os.environ["INFERENCE_API_KEY"])

## version @00y6xwpn pinned
result = client.run({
        "app": "heygen/video-translate@00y6xwpn",
        "input": {
            "video": "https://example.com/file.png",
            "output_language": "Spanish (Spain)"
        }
    })

print(result["output"])
```

#### Stream Live Updates
Get real-time progress updates as the task runs.

```python
import os
from inferencesh import inference

client = inference(api_key=os.environ["INFERENCE_API_KEY"])

## version @00y6xwpn pinned
## stream=True yields updates as they arrive
for update in client.run({
        "app": "heygen/video-translate@00y6xwpn",
        "input": {
            "video": "https://example.com/file.png",
            "output_language": "Spanish (Spain)"
        }
    }, stream=True):
    if update.get("progress"):
        print(f"progress: {update['progress']}%")
    if update.get("output"):
        print(f"output: {update['output']}")
```

#### Run in the Background
Start the task and get its id back right away, then check on it with `GET /tasks/{id}`. It is done when `status` is 10 (completed), 11 (failed) or 12 (cancelled).

```python
import os
from inferencesh import inference, TaskStatus

client = inference(api_key=os.environ["INFERENCE_API_KEY"])

## returns as soon as the task is created
task = client.run({
        "app": "heygen/video-translate@00y6xwpn",
        "input": {
            "video": "https://example.com/file.png",
            "output_language": "Spanish (Spain)"
        }
    }, wait=False)

## later: read its current state
state = client.tasks.get(task["id"]).data
if state["status"] == TaskStatus.COMPLETED:
    print(state["output"])
```

### 2. Files

#### Automatic Upload

```python
## local file paths are automatically uploaded
result = client.run({
    "app": "heygen/video-translate@00y6xwpn",
    "input": {
        "image": "/path/to/local/image.png",  # detected & uploaded
        "audio": "https://example.com/audio.mp3",  # url passed through
    }
})
```

#### Manual Upload

```python
## upload and get a hosted URL
file = client.files.upload("/path/to/file.png")
print(file.uri)  # https://cloud.inference.sh/...
```

### 3. Schema

#### Input
- **video** (string) *required*: Source video to translate. Must be a publicly accessible URL.
- **output_language** (string) *required*: Target language for translation (e.g., 'Spanish (Spain)', 'Chinese (Mandarin, Simplified)', 'French').
- **title** (string): Title for the translation job.
- **input_language** (string): Source language. Auto-detected if not set.
- **mode** (string): Translation mode. 'speed' is faster, 'precision' is higher quality.
- **translate_audio_only** (boolean): Only translate the audio track, keep original video frames.
- **speaker_num** (integer): Number of speakers in the video for improved separation.
- **enable_caption** (boolean): Generate captions for the translated video.
- **enable_dynamic_duration** (boolean): Allow dynamic duration adjustment for natural pacing.
- **disable_music_track** (boolean): Remove background music from the output.
- **start_time** (number): Start time in seconds for partial translation.
- **end_time** (number): End time in seconds for partial translation.

#### Output
- **video** (string): The translated video.

## other video apps

- [Kling Video V4 Flash](https://inference.sh/apps/klingai/video-v4-flash.md): $0.094/s at 720p
- [Kling Video V4](https://inference.sh/apps/klingai/video-v4.md): $0.157/s at 720p, $0.235/s at 1080p
- [Pika H3 Flex (self-hosted)](https://inference.sh/apps/pika/pika-h3-flex-oss.md): GPU time, billed per millisecond
- [Pika H3 Flex Upscale](https://inference.sh/apps/pika/pika-h3-flex-upscale.md): $0.05-$0.14/sec (480p src), $0.03-$0.12/sec (768p src); 1080p/2K/4K targets
- [Pika H3 Flex Reference to Video](https://inference.sh/apps/pika/pika-h3-flex-reference.md): $0.06/sec 480p, $0.12/sec 768p, $0.15/sec 1080p, $0.16/sec 2k, $0.20/sec 4k (output+input video sec). Stems: $0.001/sec

## faq

### how much does HeyGen Video Translate cost?

$0.033/sec (speed), $0.067/sec (precision), $0.033/sec (audio-only). you pay per run from your inference shell credits. no subscription is required.

### how do I run HeyGen Video Translate via api?

call heygen/video-translate with the javascript or python sdk, the rest api, or `belt app run heygen/video-translate` from a terminal. the api reference on this page lists every input.

### who makes HeyGen Video Translate?

HeyGen Video Translate is made by heygen and runs on inference shell. every heygen app is listed at https://inference.sh/apps/heygen.

### can my agent use HeyGen Video Translate?

yes. agents call it as a tool through the inference shell mcp server (https://api.inference.sh/mcp), the belt cli or the sdk, and pay per run like you do.

### what are the alternatives to HeyGen Video Translate?

other video apps on inference shell include Kling Video V4 Flash, Kling Video V4, Pika H3 Flex (self-hosted), Pika H3 Flex Upscale. they run through the same api, so switching is a one-line change.
