Video Translation API Reference
Video Translation Submission API
GET/POST/ai/video/translation
Request Parameters
Parameter
Type
Required
Description
videoData
String
Yes
Video URL. Supported specifications: Video formats: mp4, mov, webm, avi, mkv Video file size limit: up to 200MB Video duration limit: 6 minutes Maximum resolution supported: 1080P
sourceLanguage
String
Yes
Source language code
mode
String
Yes
"translate_audio_only": Translates audio only; suitable for videos that have vocals but no on-screen text."translate_video_only": Translates on-screen text only; suitable for videos that have on-screen text but no vocals or only music."translate_audio_and_video": Translates both audio and on-screen text simultaneously."remove_video_and_translate_audio": Removes on-screen text before translating the audio; can enable the captions parameter to generate new subtitles.
targetLanguage
String
Yes
Target language code
captions
String
No
Effective only when translating audio. By default, subtitles are not embedded;Pass "embed" to generate embedded subtitles based on the audio translation results;
Sample Request
The API's maximum response time is 30s. When calling the API, it's recommended to set the request timeout to no more than 30s.
For other programming languages, please refer to Quick Start.
In beta testing, please contact the account manager.Response Parameters
Parameter
Type
Description
resCode
Number
Response code； 200 indicates a successful call, other response codes can be referred to the error code information.
data
Object
Structured information of the returned translation result.
data.result.taskId
String
Task ID.
requestId
String
Request ID: used to identify a unique request call.
success
Boolean
Success status; true indicates success, false indicates failure.
resMessage
String
Error message, like "content has sensitive data, please try other input".
Video Translation Query API
GET/POST/ai/video/translation/result
Request Parameters
Parameter
Type
Required
Description
taskId
String
Yes
Task ID.
Response Parameters
Parameter
Type
Description
resCode
Number
Response code； 200 indicates a successful call, other response codes can be referred to the error code information.
data
Object
Structured information of the returned translation result.
data.videoUrl
String
Processed video link.
requestId
String
Request ID: used to identify a unique request call.
success
Boolean
Success status; true indicates success, false indicates failure.
resMessage
String
Error message，like "content has sensitive data, please try other input".
Response Example
In beta testing, please contact the account manager.Error Code
Error Code
Error Message
Description
500
system error
System error.
501
rate limit exceed
The current interface has reached the current limit. Please search for the Aidge Product Consultation & Service Group on WeChat using the group number: 105455001046. Join the group to contact us about increasing the current limitation values.
700
video duration exceeds the limit
Video duration exceeds the limit.
701
the video file size exceeds the limit
Video file size exceeds the limit.
702
video format not supported
Video format is not supported.
703
video resolution is not supported
Video resolution is not supported.
801
model failed
Internal call exception. Please search for the Aidge Product Consultation & Service Group on WeChat using the group number: 105455001046. Join the group to contact us for troubleshooting.
1000
content has sensitive data, please try other input
The request parameters contain sensitive information and cannot be processed at this time. Please try a different input.
1001
content control failed, please retry
The risk control service failed. Please search for the Aidge Product Consultation & Service Group on WeChat using the group number: 105455001046. Join the group to contact us.
1002
content risk filter failed, please contact us
Content risk filter failed. Please search for the Aidge Product Consultation & Service Group on WeChat using the group number: 105455001046. Join the group to contact us.
Languages Supported for Video Screen Translation
Source Language Code
Target Language Code
zh
ar/bn/de/es/fr/he/hi/id/it/ja/ko/ms/nl/tl/pl/pt/ru/th/tr/uk/ur/vi/en
en
ar/bn/de/es/fr/he/hi/id/it/ja/ko/ms/nl/tl/pl/pt/ru/th/tr/uk/ur/vi/zh
Languages Supported for Video Audio Translation
Source Language Code
Target Language Code
zh
ar/bn/cs/da/de/en/et/fi/fr/hi/id/it/ja/ko/mt/nl/fa/pl/pt/ro/ru/sk/es/sv/sw/te/tl/th/tr/uk/ur/uz/vi
en
ar/bn/cs/zh/da/de/et/fi/fr/hi/id/it/ja/ko/mt/nl/fa/pl/pt/ro/ru/sk/es/sv/sw/te/tl/th/tr/uk/ur/uz/vi
de/es/ru/ko/fr/ja/pt/tr/pl/ca/nl/ar/sv/it/id/hi/fi/vi/he/uk/el/ms/cs/ro/da/hu/ta/no/th/ur/hr/bg/lt/la/mi/ml/cy/sk/te/fa/lv/bn/sr/az/sl/kn/et/mk
en
de/es/ru/ko/fr/ja/pt/tr/pl/ca/nl/ar/sv/it/id/hi/fi/vi/he/uk/el/ms/cs/ro/da/hu/ta/no/th/ur/hr/bg/lt/la/mi/ml/cy/sk/te/fa/lv/bn/sr/az/sl/kn/et/mk
zh
Appendix
Language Name(English)
Language Code
Language Name(Chinese)
English
en
英语
Chinese
zh
中文
German
de
德语
Spanish
es
西班牙语
Russian
ru
俄语
Korean
ko
韩语
French
fr
法语
Japanese
ja
日语
Portuguese
pt
葡萄牙语
Turkish
tr
土耳其语
Polish
pl
波兰语
Catalan
ca
加泰罗尼亚语
Dutch
nl
荷兰语
Arabic
ar
阿拉伯语
Swedish
sv
瑞典语
Italian
it
意大利语
Indonesian
id
印度尼西亚语
Hindi
hi
印地语
Finnish
fi
芬兰语
Vietnamese
vi
越南语
Hebrew
he
希伯来语
Ukrainian
uk
乌克兰语
Greek
el
希腊语
Malay
ms
马来语
Czech
cs
捷克语
Romanian
ro
罗马尼亚语
Danish
da
丹麦语
Hungarian
hu
匈牙利语
Tamil
ta
泰米尔语
Norwegian
no
挪威语
Thai
th
泰语
Urdu
ur
乌尔都语
Croatian
hr
克罗地亚语
Bulgarian
bg
保加利亚语
Lithuanian
lt
立陶宛语
Latin
la
拉丁语
Māori
mi
毛利语
Malayalam
ml
马拉雅拉姆语
Welsh
cy
威尔士语
Slovak
sk
斯洛伐克语
Telugu
te
泰卢固语
Persian
fa
波斯语
Latvian
lv
拉脱维亚语
Bengali
bn
孟加拉语
Serbian
sr
塞尔维亚语
Azerbaijani
az
阿塞拜疆语
Slovenian
sl
斯洛文尼亚语
Kannada
kn
卡纳达语
Estonian
et
爱沙尼亚语
Macedonian
mk
马其顿语
Last updated
Was this helpful?