Skip to navigation
REST API ReferenceEndpointsTools

Translate a video's speech

Translate the speech in a video into another language, keeping the original speakers’ voices. Returns one translated video file. To build an editable project with one video per language, use POST /v1/workflows/translate-video instead.

Authentication

AuthorizationBearer

API key from app.videogen.io/api. The full key is only shown once when you create it.

Request

This endpoint expects an object.
videoFileIdstringRequired

File id of the source video (e.g. vg_file_...), up to 8 minutes long. Upload a file first via POST /v1/files/upload, then pass the returned id here.

targetLanguagestringRequired

Language to translate the speech into, as a language code (e.g. es, fr, ja). Must differ from sourceLanguage.

sourceLanguagestring or nullOptional

Language spoken in the source video, as a language code (e.g. en). Omit or pass null to detect it automatically.

isOutputTemporarybooleanOptionalDefaults to false

When true, generated files are temporary. Temporary files are guaranteed to be available for 24 hours, after which they may be archived at any time. Temporary files are not analyzed (no description, transcript, or embedding will be generated), so they will not appear in search results. Defaults to false.

Response

Execution accepted; poll until complete.

toolExecutionIdstring

Execution id (e.g. vg_tool_...).