Inputs & Outputs
Input:- video_url
- source language & target language
- [optional] glossary_ids
- [optional] user_prompt
- [optional] project_mode
- translated video_url
- project_url when
project_modeiseditable
How it works
1
Host your video at a publicly accessible URL
Upload your input video so our servers can retrieve it. The video must be no longer than 20 minutes.
2
Send a visual translation request
Include the source and target language codes, and optional glossary IDs or prompt instructions for terminology and style.
3
Wait or query status
Use your webhook callback or poll the API with the returned task ID until processing is complete.
4
Download the translated video
When the job is done, retrieve the translated video from
video_url. If you created an editable project, open project_url to review or edit it in the web dashboard.Usage Limitation
- Only users who can create API Keys may use this API.
- Studio plan is required; non-Studio users are not allowed.
- Input must be a video file. Audio-only export is not supported.
- The maximum supported input duration is 20 minutes.
- Source language auto-detection is not supported. Pass a supported source language code explicitly.
- Language code follows IETF BCP 47 style, e.g.,
en-US,zh-CN,zh-CN-GUANGXI.