HeyGen Video Translate API

About HeyGen Video Translate

HeyGen Video Translate dubs a spoken video into another language and redraws the lips to match. It covers 178 languages and dialects, takes clips up to 120 seconds, and keeps a voice close to the original speaker.

Call it with the model name heygen/video-translate/video-translate on POST /jobs/createTask, from $0.048.

Introduction

HeyGen Video Translate changes the language of speech in a short video and syncs the lips to the translation. HeyGen says it supports 175+ languages and dialects with realistic AI voices, and that voice cloning carries the speaker’s tone across languages.

Get consent before sending footage: use a recording of yourself or people who agreed to this use. Translation makes them appear to say words in another language in a voice like their own. The first run on the model page requires acceptance of a consent notice.

Provide a spoken MP4 or WebM no longer than 120 seconds. Set target_language and, if needed, generation_mode; there is no prompt to write. English and Precision are the defaults.

Key features

• Lip movement changes with the speech. In our tests, source and translated frames at matching moments had different mouth shapes, while faces, clothing and the scene stayed the same.
• Choose a regional target. The 178 options include Spanish (Mexico), French (Canada) and Chinese (Cantonese, Traditional), alongside base languages.
• Two modes set the tradeoff. Precision aims for higher-quality lip sync, while Speed aims for a faster result and uses half the per-second rate.
• English accent choices are available. Targets include “English - Your Accent” and “English - American Accent.”
• Frame size is retained in our tests. We received MP4 with AAC audio; a 1280x720 input returned at the same size.

Request parameters

Pricing

Prices are in USD. The API uses a separate USD balance. Website credits cannot be used or transferred to it, and API funds cannot be transferred to website credits. When a task is accepted, we reserve the maximum quoted amount from your API balance. On completion, we charge for actual usage, never more than the hold, and release the remainder. If the task fails, the hold is released.

Send the same request body to POST /jobs/quote to see the estimated and maximum USD charge before running. A quote does not run the task or charge your balance.

Use cases

• Course welcome in Spanish: translate your own recorded introduction so Spanish-speaking students can hear the welcome with matching lip movement.
• French product demonstration: get your presenter’s consent, then translate a short walkthrough for French-speaking customers.
• Japanese creator announcement: adapt your spoken update for Japanese-speaking viewers using the same source recording.

Prompt guide & pro tips

• Check permission first. Obtain agreement from everyone who will appear to speak translated lines; do not use a celebrity, public figure or acquaintance without permission.
• Select the target deliberately. Check whether a base language or regional dialect suits your viewers, rather than leaving the English default by accident.
• Choose Precision for its lip-sync quality aim. It is the default and carries twice the Speed rate, so include that difference in your decision.
• Choose Speed when its rate and timing aim suit the task. It aims to finish sooner at half the per-second rate; actual completion time can vary.
• Allow space for longer translated speech. In our tests, an 8.00-second recording returned as 8.68 seconds in Spanish; check the finished duration before editing it into a sequence.

API quick start

Call the HeyGen Video Translate API in three steps

1. Create an API key. Sign in to PopNow and create a key in the API console. Keys start with sk-popnow-. API calls use your separate USD balance.
2. Send the request. POST /jobs/createTask with model heygen/video-translate/video-translate and an input object that follows the parameter table. The response returns a task ID straight away.
3. Get the result. Poll GET /jobs/recordInfo with the task ID, or pass a callBackUrl and we post the result to it. Download the output links when the task succeeds.

# 1. Create the task. Keep the Idempotency-Key if you retry after a network error.
export IDEMPOTENCY_KEY="$(uuidgen)"
curl -X POST https://api.popnow.ai/api/v1/jobs/createTask \
  -H "Authorization: Bearer $POPNOW_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $IDEMPOTENCY_KEY" \
  -d '{
  "model": "heygen/video-translate/video-translate",
  "input": {
    "video_url": "https://media.popnow.ai/effects/flower-bloom-1abd6efb.mp4",
    "target_language": "English",
    "generation_mode": "precision"
  }
}'

# 2. Copy data.taskId from the response, then poll until state is succeeded, failed, canceled or expired.
TASK_ID="TASK_ID_FROM_RESPONSE"
curl "https://api.popnow.ai/api/v1/jobs/recordInfo?taskId=$TASK_ID" \
  -H "Authorization: Bearer $POPNOW_API_KEY"

Replace the prompt and any links with your own. The API tab has the response, polling and callback reference.

HeyGen Video Translate API questions

Other video APIs

• MiniMax H3 APIExpressive clips with audio, up to 30 seconds or 2KFrom $0.125 for a 5-second clip
• Video Translator APIDub a clip into 28 languages with subtitles, billed per minuteFrom $0.005 per second

More about HeyGen Video Translate

Try it

HeyGen Video Translate AI Image Generator onlineCreate videos with HeyGen Video Translate in PopNow

Docs

HeyGen Video Translate model ID and input schema in the API docsPopNow API quickstart: send your first requestImage to video guide for the PopNow APIWebhooks: get HeyGen Video Translate results without polling