跳转到主要内容

输入与输出

输入:
  • media_url
  • 源语言与目标语言
  • [可选] subtitle_url 或 ocr_text_box (以提高语音识别的准确性)
  • [可选] 术语表_ids
术语表 Pn 输出:
  • 媒体(视频或音频)
  • 翻译后的字幕_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。

注意:“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