Skip to navigation
REST API ReferenceEndpointsWorkflows

Translate video

Creates a project from an uploaded video and translates its speech into one or more languages, keeping the original speakers’ voices. Each language becomes its own editable video in the project, built in parallel; a language that fails does not stop the others. The run fails only when every language fails. Pass the video as videoFileId (up to 8 minutes). Returns immediately with a workflow run id; poll GET /v1/workflows/runs/{workflowRunId} and read outputs for each language’s editableVideoId, then pass it to POST /v1/projects/{projectId}/export.

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

Id of the video to translate (e.g. vg_file_...), uploaded via POST /v1/files/upload. Must be 8 minutes or shorter.

outputLanguageslist of stringsRequired

Languages to translate into, as language codes (e.g. ["es", "fr"]). At least one supported language, none equal to sourceLanguage. Repeated languages are translated once, keeping their first occurrence. The run’s outputs follow this order, and the first language that succeeds is the project’s default video for export and edit.

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, the generated OUTPUT files (the translated videos) are created as temporary: guaranteed available for 24 hours, after which they may be archived and later deleted. Use this when your integration downloads or re-hosts the results itself and does not need VideoGen to retain them. The project and its metadata are unaffected. Defaults to false.

autoExportbooleanOptionalDefaults to false

When true, VideoGen exports an MP4 of the first language that succeeds after the videos are built (and after any videoEdits on this request finish). The workflow run stays running until that export succeeds or fails. On success, poll GET /v1/workflows/runs/{workflowRunId} and use downloadUrl. Export the other languages with POST /v1/projects/{projectId}/export and each output’s editableVideoId. Defaults to false.

exportOptionsobjectOptional

Export settings used when autoExport is true. Ignored when autoExport is false. Omitted fields use the same defaults as POST /v1/projects/{projectId}/export. editableVideoId is not accepted here.

videoEditslist of objectsOptional

Optional edits applied after the videos are built, in order. Each action runs on every language’s video. The response returns one video edit id per action. See the video edits guide.

Response

Workflow run accepted.
workflowRunIdstring

Opaque workflow run id (e.g. vg_work_...).

projectIdstring

Id of the project created for this workflow run (e.g. vg_proj_...).

projectUrlstringformat: "uri"

Deep link to open this project in the VideoGen web editor. Not required for an API-only integration: store projectId and use the Projects API (export, edit, metadata). Use projectUrl when a person should open the project in the app to review or edit it manually. The project is visible only to members of your team and any project collaborators, the same access model as a project created in the dashboard.

videoEditIdslist of strings