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
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.
Send a visual translation request
Include the source and target language codes, and optional glossary IDs or prompt instructions for terminology and style.
Wait or query status
Use your webhook callback or poll the API with the returned task ID until processing is complete.
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.
API Error Codes
| Code | Description |
|---|---|
| 5 | Invalid request parameters. |
| 7 | No permission to request. |
| 104 | Insufficient credits. |
| 814 | Your account is not a member and is not allowed to call the API. |
| 1000 | Internal Server Error. |
| 1301 | Callback Challenge failed. |
| 1302 | API key has been revoked. |
| 1304 | API key has reached the maximum number of concurrent requests. |
| 1503 | Your account is not authorized to call the API. |
| 1305 | Only Studio plan is allowed. |
Job Error Codes
| Code | Description |
|---|---|
| 40002 | Uploaded file has no video stream. |
| 40010 | Transcoding failed. |
| 40050 | Translation failed. |
| 40020 | OCR extraction failed. |
| 40032 | No valid callouts in video. |
| 40040 | Matching ocr to callouts failed. |
| 40041 | Fail to match any callout to ocr. |
| 40060 | Failed to refine callouts. |
| 40061 | Failed to extract style in refine. |
| 40080 | Generating preview video failed. |