> ## Documentation Index
> Fetch the complete documentation index at: https://www.vozo.ai/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Overview

> Visual Translate API

## Inputs & Outputs

Input:

* video\_url
* source language & target language
* \[optional] glossary\_ids
* \[optional] user\_prompt
* \[optional] project\_mode

Output:

* translated video\_url
* project\_url when `project_mode` is `editable`

## How it works

<Steps>
  <Step title="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.
  </Step>

  <Step title="Send a visual translation request">
    Include the source and target language codes, and optional glossary IDs or prompt instructions for terminology and style.
  </Step>

  <Step title="Wait or query status">
    Use your webhook callback or poll the API with the returned task ID until processing is complete.
  </Step>

  <Step title="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.
  </Step>
</Steps>

## 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.   |