Translates a video into one or more target languages with voice cloning and lip-sync. Returns one video_translation_id per language. Use mode: ‘speed’ (default) for fast turnaround or ‘precision’ for higher lip-sync quality.
Documentation Index
Fetch the complete documentation index at: https://heygen-1fa696a7.mintlify.app/llms.txt
Use this file to discover all available pages before exploring further.
HeyGen API key. Obtain from your HeyGen dashboard.
Request body for POST /v3/video-translations.
Asset input via publicly accessible HTTPS URL.
Target language names (e.g. 'Chinese (Cantonese, Traditional)', 'Spanish (Spain)', 'English'). Use GET /v3/video-translations/languages for valid values. Use one for single translation, multiple for batch.
1Title for the translation job
Asset input via publicly accessible HTTPS URL.
Source language code (auto-detected if omitted)
Only translate audio, keep original video
Number of speakers (improves speaker separation)
Translation quality mode: 'speed' (faster) or 'precision' (higher quality, uses avatar inference)
speed, precision Webhook URL for completion notifications
ID included in webhook payload
Generate captions for translated video
Preserve the source video's encoding specs (resolution, bitrate).
Allow dynamic duration adjustment
Remove background music
Enhance speech quality
Add watermark to output
Start time in seconds for partial translation
End time in seconds for partial translation
Custom brand voice ID. Requires brand voice setup.
Opt into Stock TTS instead of Voice Clone. Set use_stock_voice=true to route the request to a stock voice; optionally pin specific voices via preferred_stock_voice_ids. Gated by per-space and per-locale Nacos allowlists.
Asset input via publicly accessible HTTPS URL.
Which video the subtitle applies to: 'input' (source) or 'output' (translated). Enterprise plan only.
input, output Frame rate mode: 'vfr', 'cfr', or 'passthrough'. Only valid with audio.
Project/folder ID to organize translation into
Successful response
Response for POST /v3/video-translations.