Video Translate API
Source: https://docs.heygen.com/docs/video-translate Generated: 2025-09-18 10:44:39
Testing or trial access is not available for the Video Translate API.
Request Body
| Field | Type | Description |
|---|---|---|
| video_url | str | The URL of the video file to be translated. Supports direct video file URLs, Google Drive URLs, and YouTube URLs. |
| title | str (optional) | Title of the video. |
| output_language | str | The target language in which the video will be translated. Cannot be used together with output_languages. |
| output_languages | List[str] (optional) | A list of multiple target languages to translate the same video in a single request. Enables faster batch processing. |
| translate_audio_only | bool (optional) | Translate only the audio, ignore the faces and only translate the voice track in this video. default: false |
| speaker_num | int (optional) | Number of speakers. |
| callback_id | string (optional) | A custom ID for callback purposes. |
| enable_dynamic_duration | bool (optional) | Enable dynamic duration, which stretches or shrinks portions of your video to enhance conversational fluidity and translation quality between languages with different speaking rates. |
| brand_voice_id | string (optional) | A Brand Voice that gets incorporated to the translation. |
| callback_url | string | |
| (optional) | An optional callback url. This is useful if your callback endpoint is dynamic and each video have it's separate callback url. | |
| Using webhook endpoint is still recommended because those offers more customizations on the callback endpoint such as secrets, and event filtering, etc |
Response
| Field | Type | Description |
|---|---|---|
| video_translate_id | str | ID of the video. |
__Shell __Node __Ruby __PHP __Python
Click Try It! to start a request and see the response here!