Vozo Help Center

The Visual Translate API localizes on-screen text in videos while preserving its layout, style, and animations. Use it to automate visual text translation for presentations, product demos, marketing videos, and other videos with embedded text. The API returns a translated video and can optionally create an editable project in the Vozo web app.

Inputs

Field	Values	Requirement	Description
`video_url`	Publicly accessible video URL	Required	URL of the input video. The maximum supported duration is 20 minutes.
`source_language`	Supported language code	Required	Source language of the on-screen text. Automatic detection is not supported.
`target_language`	Supported language code, with an optional locale	Required	Target language for the translated on-screen text.
`glossary_ids`	Array of up to 3 IDs	Optional	Applies glossaries created in the Vozo web app to keep terminology consistent.
`user_prompt`	String	Optional	Provides instructions for the visual text translation style.
`project_mode`	`none`, `editable`	Optional	Controls whether an editable Visual Translate project is created in the Vozo web app. Defaults to `none`.
`callback_url`	URL	Optional	Receives a webhook whenever the job status changes.

Outputs

translated video_url
project_url when project_mode is editable

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

Provide the required inputs and any optional settings needed for the job.

Wait or query status

Use your webhook callback or poll the API with the returned task ID until processing is complete.

Download the translated video

When the job is done, retrieve the translated video from the provided URL. If you created an editable project, open the 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.
The default concurrency limit is 10 jobs. The limit is shared by all members of a team. See Concurrency limits for details.
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.

Supported Languages

Source Languages

Automatic detection is not supported. Pass one of the following language codes:

Code	Name
sq-AL	Albanian
az-AZ	Azerbaijani
eu-ES	Basque
bs-BA	Bosnian
ca-ES	Catalan
zh-CN	Chinese (Simplified)
zh-TW	Chinese (Traditional)
hr-HR	Croatian
cs-CZ	Czech
da-DK	Danish
nl-NL	Dutch
en-US	English
et-EE	Estonian
fi-FI	Finnish
fr-FR	French
gl-ES	Galician
de-DE	German
hi-IN	Hindi
hu-HU	Hungarian
is-IS	Icelandic
id-ID	Indonesian
ga-IE	Irish
it-IT	Italian
ja-JP	Japanese
ko-KR	Korean
lv-LV	Latvian
lt-LT	Lithuanian
ms-MY	Malay
mt-MT	Maltese
nb-NO	Norwegian
fa-IR	Persian
pl-PL	Polish
pt-PT	Portuguese
ro-RO	Romanian
ru-RU	Russian
sr-RS	Serbian
sk-SK	Slovak
sl-SI	Slovenian
es-ES	Spanish
sw-KE	Swahili
sv-SE	Swedish
fil-PH	Filipino
tr-TR	Turkish
uz-UZ	Uzbek
vi-VN	Vietnamese

Target Languages

Code	Name	Locale variants
en	English	en‑US, en‑GB, en‑AU, en‑CA, en‑HK, en‑KE, en‑NZ, en‑NG, en‑PH, en‑SG, en‑ZA, en‑TZ
zh	Chinese	zh‑CN, zh‑HK, zh‑TW, zh‑CN‑shandong, zh‑CN‑liaoning, zh‑CN‑sichuan, zh‑CN‑henan, zh‑CN‑shaanxi, zh‑CN‑GUANGXI
wuu	Wu Chinese	wuu‑CN
es	Spanish	es‑ES, es‑MX, es‑US, es‑AR, es‑BO, es‑CL, es‑CO, es‑CR, es‑CU, es‑DO, es‑EC, es‑SV, es‑GQ, es‑GT, es‑HN, es‑NI, es‑PA, es‑PY, es‑PE, es‑PR, es‑UY, es‑VE
ar	Arabic	ar‑DZ, ar‑BH, ar‑IQ, ar‑JO, ar‑KW, ar‑LB, ar‑LY, ar‑MA, ar‑OM, ar‑QA, ar‑SY, ar‑TN, ar‑AE, ar‑YE
ru	Russian	ru‑RU
pt	Portuguese	pt‑PT, pt‑BR
fr	French	fr‑FR, fr‑CA, fr‑BE, fr‑CH
de	German	de‑DE, de‑AT, de‑CH
ko	Korean	ko‑KR
ja	Japanese	ja‑JP
hi	Hindi	hi‑IN
tr	Turkish	tr‑TR
fil	Filipino	fil‑PH
fi	Finnish	fi‑FI
cs	Czech	cs‑CZ
da	Danish	da‑DK
nl	Dutch	nl‑BE
pl	Polish	pl‑PL
ro	Romanian	ro‑RO
sk	Slovak	sk‑SK
sv	Swedish	sv‑SE
hr	Croatian	hr‑HR
id	Indonesian	id‑ID
it	Italian	it‑IT, it‑CH
bg	Bulgarian	bg‑BG
el	Greek	el‑GR
ms	Malay	ms‑MY
ta	Tamil	ta‑IN, ta‑MY, ta‑SG, ta‑LK
uk	Ukrainian	uk‑UA
th	Thai	th‑TH
vi	Vietnamese	vi‑VN
am	Amharic	am‑ET
bn	Bengali	bn‑IN, bn‑BD
as	Assamese	as
bs	Bosnian	bs‑BA
ca	Catalan	ca‑ES
et	Estonian	et‑EE
eu	Basque	eu‑ES
gl	Galician	gl‑ES
gu	Gujarati	gu
he	Hebrew	he‑IL
hu	Hungarian	hu‑HU
iu	Inuktitut	iu‑CANS‑CA, iu‑LATN‑CA
jv	Javanese	jv‑ID
mk	Macedonian	mk‑MK
mr	Marathi	mr
nb	Norwegian Bokmål	nb‑NO
ne	Nepali	ne‑NP
or	Oriya	or
pa	Punjabi	pa
ps	Pashto	ps‑AF
sl	Slovenian	sl‑SI
sw	Swahili	sw‑KE, sw‑TZ
te	Telugu	te‑IN
ur	Urdu	ur, ur‑IN, ur‑PK
zu	Zulu	zu‑ZA

Overview

Translate & Dub API

Visual Translate API

LipSync API

Reusable LipSync API

Overview

Inputs

Outputs

How it works

Usage Limitation

API Error Codes

Job Error Codes

Supported Languages

Source Languages

Target Languages

​Inputs

​Outputs

​How it works

​Usage Limitation

​API Error Codes

​Job Error Codes

​Supported Languages

​Source Languages

​Target Languages

Inputs

Outputs

How it works

Usage Limitation

API Error Codes

Job Error Codes

Supported Languages

Source Languages

Target Languages