跳转到主要内容

输入与输出

输入:
  • media_url
  • 源语言与目标语言
  • [可选] subtitle_url 或 ocr_text_box (以提高语音识别的准确性)
输出:
  • 媒体(视频或音频)
  • 翻译的 subtitle_url (SRT)

工作原理

1

将您的资产托管在一个公开可访问的 URL 上

上传您的视频或音频,以及可选的字幕(.srt),以便我们的服务器可以检索它们。
2

可选提供 OCR 文本区域

如果有屏幕上的文本需要翻译,请指定一个标准化的 OCR 框(x, y, 宽度, 高度),范围从 0–1;原点位于框的左上角。
3

发送包含适当参数的 API 请求

包括源语言/目标语言(例如,en‑US → zh‑CN),如有需要还可包括讲师范围和导出类型。
4

等待或查询状态

使用我们的 webhook 回调或使用您的任务 ID 轮询 API,直到处理完成。
5

下载输出

从提供的 URL 中检索翻译后的视频/音频和翻译后的字幕(.srt)。

使用限制

  • 只有可以创建 API 密钥的用户才能使用此 API。
  • 需要商业计划;不允许非商业用户。
  • 并发量与口型同步独立限制;排队请求会被计数。
  • 语言代码遵循 IETF BCP 47 标准,例如,en‑US。

API 错误代码

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.

任务错误代码

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

支持的语言

源语言

注意:支持 “auto” 自动检测源语言,并在检测时更新 SourceLanguage。
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)

目标语言

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