Skip to main content

​
Inputs & Outputs

Input:
  • media_url
  • source language & target language
  • [optional] subtitle_url or ocr_text_box (for more accurate speech recognition)
Output:
  • media (video or audio)
  • translated subtitle_url (SRT)

​
How it works

1

Host your assets at a publicly accessible URL

Upload your video or audio, and optional subtitle (.srt) so our servers can retrieve them.
2

Optionally provide OCR text region

If there is on‑screen text to translate, specify a normalized OCR box (x, y, width, height) from 0–1; origin at the top‑left of the frame.
3

Send an API request with the appropriate parameters

Include source/target languages (e.g., en‑US → zh‑CN), speaker range if needed, and export type.
4

Wait or query status

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

Download outputs

Retrieve translated video/audio and the translated subtitle (.srt) from the provided URLs.

​
Usage Limitation

  • Only users who can create API Keys may use this API.
  • Business plan is required; non‑business users are not allowed.
  • Concurrency is limited independently from LipSync; queued requests are counted.
  • Language code follows IETF BCP 47 standard, e.g., en‑US.

​
API Error Codes

CodeDescription
5Invalid request parameters.
7No permission to request.
104Insufficient credits.
814Your account is not a member and is not allowed to call the API.
1000Internal Server Error.
1301Callback Challenge failed.
1302API key has been revoked.
1304API key has reached the maximum number of concurrent requests.
1503Your account is not authorized to call the API.
1305Only business plan is allowed.

​
Job Error Codes

CodeDescription
10001Uploaded file has no video stream
10002Uploaded video has no audio stream
10003Transcoding failed
10004Failed to generate HLS output
10005Video cropping failed
10010Voice separation failed (speech vs. background)
10020Automatic speech recognition (ASR) failed
10021Multi‑speaker ASR failed
10022Speaker diarization (Chinese) failed
10023Failed to generate full subtitles
10030Translation failed
10031Mixed languages detected; aggregation failed after punctuation adjustment
10032OCR extraction failed
10033OCR language not supported
10034Subtitle (SRT) alignment failed
10040Voice cloning failed
10041No recognized speech content
10042No speech detected
10043Re‑cloning voice failed
10044Preview text for TTS is empty
10045Failed to generate preview audio

​
Supported Languages

​
Source Languages

Note: “auto” is supported to automatically detect the source language and update SourceLanguage when detected.
CodeName
autoAuto Detect
en-USEnglish (United States)
en-GBEnglish (United Kingdom)
en-AUEnglish (Australia)
en-CAEnglish (Canada)
en-GHEnglish (Ghana)
en-HKEnglish (Hong Kong)
en-IEEnglish (Ireland)
en-INEnglish (India)
en-KEEnglish (Kenya)
en-NGEnglish (Nigeria)
en-NZEnglish (New Zealand)
en-PHEnglish (Philippines)
en-SGEnglish (Singapore)
en-TZEnglish (Tanzania)
en-ZAEnglish (South Africa)
zh-CNChinese (China, Simplified)
zh-HKChinese (Hong Kong, Traditional)
zh-TWChinese (Taiwan, Traditional)
es-ESSpanish (Spain)
es-MXSpanish (Mexico)
es-USSpanish (United States)
es-ARSpanish (Argentina)
es-BOSpanish (Bolivia)
es-CLSpanish (Chile)
es-COSpanish (Colombia)
es-CRSpanish (Costa Rica)
es-CUSpanish (Cuba)
es-DOSpanish (Dominican Republic)
es-ECSpanish (Ecuador)
es-GQSpanish (Equatorial Guinea)
es-GTSpanish (Guatemala)
es-HNSpanish (Honduras)
es-NISpanish (Nicaragua)
es-PASpanish (Panama)
es-PESpanish (Peru)
es-PRSpanish (Puerto Rico)
es-PYSpanish (Paraguay)
es-SVSpanish (El Salvador)
es-UYSpanish (Uruguay)
es-VESpanish (Venezuela)
ar-EGArabic (Egypt)
ar-SAArabic (Saudi Arabia)
ar-AEArabic (United Arab Emirates)
ar-MAArabic (Morocco)
ar-SYArabic (Syria)
ru-RURussian (Russia)
pt-PTPortuguese (Portugal)
pt-BRPortuguese (Brazil)
fr-BEFrench (Belgium)
fr-CAFrench (Canada)
fr-CHFrench (Switzerland)
fr-FRFrench (France)
de-DEGerman (Germany)
de-ATGerman (Austria)
de-CHGerman (Switzerland)
ko-KRKorean (South Korea)
ja-JPJapanese (Japan)
hi-INHindi (India)
tr-TRTurkish (Turkey)
ur-INUrdu (India)
fil-PHFilipino (Philippines)
fi-FIFinnish (Finland)
cs-CZCzech (Czech Republic)
hu-HUHungarian (Hungary)
da-DKDanish (Denmark)
nl-BEDutch (Belgium)
pl-PLPolish (Poland)
ro-RORomanian (Romania)
sk-SKSlovak (Slovakia)
sv-SESwedish (Sweden)
hr-HRCroatian (Croatia)
id-IDIndonesian (Indonesia)
it-ITItalian (Italy)
it-CHItalian (Switzerland)
bg-BGBulgarian (Bulgaria)
el-GRGreek (Greece)
ms-MYMalay (Malaysia)
ta-INTamil (India)
uk-UAUkrainian (Ukraine)
sq-ALAlbanian (Albania)
az-AZAzerbaijani (Azerbaijan)
eu-ESBasque (Spain)
bn-INBengali (India)
bs-BABosnian (Bosnia and Herzegovina)
yue-CNCantonese (China)
ca-ESCatalan (Spain)
gl-ESGalician (Spain)
gu-INGujarati (India)
is-ISIcelandic (Iceland)
kn-INKannada (India)
kk-KZKazakh (Kazakhstan)
lv-LVLatvian (Latvia)
lt-LTLithuanian (Lithuania)
mk-MKMacedonian (North Macedonia)
ml-INMalayalam (India)
mt-MTMaltese (Malta)
mr-INMarathi (India)
mn-MNMongolian (Mongolia)
ne-NPNepali (Nepal)
nb-NONorwegian Bokmål (Norway)
pa-INPunjabi (India)
sl-SISlovenian (Slovenia)
so-SOSomali (Somalia)
sr-RSSerbian (Serbia)
sw-KESwahili (Kenya)
sw-TZSwahili (Tanzania)
uz-UZUzbek (Uzbekistan)
vi-VNVietnamese (Vietnam)
he-ILHebrew (Israel)
fa-IRPersian (Iran)
th-THThai (Thailand)

​
Target Languages

CodeNameLocale variants
enEnglishen‑US, en‑GB, en‑AU, en‑CA
zhChinesezh‑CN, zh‑HK, zh‑TW
esSpanishes‑ES, es‑MX, es‑US
arArabicar‑EG, ar‑SA, ar‑AE, ar‑MA, ar‑SY
ruRussianru‑RU
ptPortuguesept‑PT, pt‑BR
frFrenchfr‑FR, fr‑CA, fr‑BE, fr‑CH
deGermande‑DE, de‑AT, de‑CH
koKoreanko‑KR
jaJapaneseja‑JP
hiHindihi‑IN
trTurkishtr‑TR
filFilipinofil‑PH
fiFinnishfi‑FI
csCzechcs‑CZ
daDanishda‑DK
nlDutchnl‑BE
plPolishpl‑PL
roRomanianro‑RO
skSlovaksk‑SK
svSwedishsv‑SE
hrCroatianhr‑HR
idIndonesianid‑ID
itItalianit‑IT, it‑CH
bgBulgarianbg‑BG
elGreekel‑GR
msMalayms‑MY
taTamilta‑IN
ukUkrainianuk‑UA
thThaith‑TH
viVietnamesevi‑VN
amAmharicam‑ET
bnBengalibn‑IN, bn‑BD
bsBosnianbs‑BA
caCatalanca‑ES
etEstonianet‑EE
euBasqueeu‑ES
glGaliciangl‑ES
heHebrewhe‑IL
huHungarianhu‑HU
jvJavanesejv‑ID
mkMacedonianmk‑MK
nbNorwegian Bokmålnb‑NO
neNepaline‑NP
psPashtops‑AF
slSloveniansl‑SI
swSwahilisw‑KE, sw‑TZ
teTelugute‑IN
zuZuluzu‑ZA