跳转到主要内容

输入与输出

输入:
  • 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。
  • 需要购买 Studio 方案;不允许非 Studio 用户使用。
  • 并发限制独立于口型同步;排队请求被计数。
  • 语言代码遵循 IETF BCP 47 标准,例如,en‑US。

API 错误代码

代码描述
5请求参数无效。
7无权限请求。
104积分不足。
814您的账户不是会员,不允许调用 API。
1000服务器内部错误。
1301回调挑战失败。
1302API 密钥已被撤销。
1304API 密钥已达到最大并发请求数量。
1503您的账户未被授权调用 API。
1305仅允许使用 Studio 方案。

任务错误代码

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)

目标语言

代码名称地区变体
en英语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中文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吴语wuu‑CN
es西班牙语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阿拉伯语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俄语ru‑RU
pt葡萄牙语pt‑PT, pt‑BR
fr法语fr‑FR, fr‑CA, fr‑BE, fr‑CH
de德语de‑DE, de‑AT, de‑CH
ko韩语ko‑KR
ja日语ja‑JP
hi印地语hi‑IN
tr土耳其语tr‑TR
fil菲律宾语fil‑PH
fi芬兰语fi‑FI
cs捷克语cs‑CZ
da丹麦语da‑DK
nl荷兰语nl‑BE
pl波兰语pl‑PL
ro罗马尼亚语ro‑RO
sk斯洛伐克语sk‑SK
sv瑞典语sv‑SE
hr克罗地亚语hr‑HR
id印尼语id‑ID
it意大利语it‑IT, it‑CH
bg保加利亚语bg‑BG
el希腊语el‑GR
ms马来语ms‑MY
ta泰米尔语ta‑IN, ta‑MY, ta‑SG, ta‑LK
uk乌克兰语uk‑UA
th泰语th‑TH
vi越南语vi‑VN
am阿姆哈拉语am‑ET
bn孟加拉语bn‑IN, bn‑BD
as阿萨米语as
bs波斯尼亚语bs‑BA
ca加泰罗尼亚语ca‑ES
et爱沙尼亚语et‑EE
eu巴斯克语eu‑ES
gl加利西亚语gl‑ES
gu古吉拉特语gu
he希伯来语he‑IL
hu匈牙利语hu‑HU
iu因纽特语iu‑CANS‑CA, iu‑LATN‑CA
jv爪哇语jv‑ID
mk马其顿语mk‑MK
mr马拉地语mr
nb挪威博克målnb‑NO
ne尼泊尔语ne‑NP
or奥里亚语or
pa旁遮普语pa
ps普什图语ps‑AF
sl斯洛文尼亚语sl‑SI
sw魏斯瓦希里语sw‑KE, sw‑TZ
te泰卢固语te‑IN
ur乌尔都语ur, ur‑IN, ur‑PK
zu祖鲁语zu‑ZA
最后修改于 2026年5月26日