输入与输出
输入：- media_url
- 源语言与目标语言
- [可选] subtitle_url 或 ocr_text_box （以提高语音识别的准确性）
- [可选] 术语表_ids
- 媒体（视频或音频）
- 翻译后的字幕_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 | 回调挑战失败。 |
| 1302 | API 密钥已被撤销。 |
| 1304 | API 密钥已达到最大并发请求数量。 |
| 1503 | 您的账户未被授权调用 API。 |
| 1305 | 仅允许使用 Studio 方案。 |
任务错误代码
| Code | Description |
|---|---|
| 10001 | Uploaded file has no video stream |
| 10002 | Uploaded video has no audio stream |
| 10003 | Transcoding failed |
| 10004 | Failed to generate HLS output |
| 10005 | Video cropping failed |
| 10010 | Voice separation failed (speech vs. background) |
| 10020 | Automatic speech recognition (ASR) failed |
| 10021 | Multi‑speaker ASR failed |
| 10022 | Speaker diarization (Chinese) failed |
| 10023 | Failed to generate full subtitles |
| 10030 | Translation failed |
| 10031 | Mixed languages detected; aggregation failed after punctuation adjustment |
| 10032 | OCR extraction failed |
| 10033 | OCR language not supported |
| 10034 | Subtitle (SRT) alignment failed |
| 10040 | Voice cloning failed |
| 10041 | No recognized speech content |
| 10042 | No speech detected |
| 10043 | Re‑cloning voice failed |
| 10044 | Preview text for TTS is empty |
| 10045 | Failed to generate preview audio |
源语言
注意：支持 “auto” 自动检测源语言，并在检测时更新 SourceLanguage。
注意：“auto” 支持自动检测源语言，并在检测到时更新 SourceLanguage。| Code | Name |
|---|---|
| auto | Auto Detect |
| en-US | English (United States) |
| en-GB | English (United Kingdom) |
| en-AU | English (Australia) |
| en-CA | English (Canada) |
| en-GH | English (Ghana) |
| en-HK | English (Hong Kong) |
| en-IE | English (Ireland) |
| en-IN | English (India) |
| en-KE | English (Kenya) |
| en-NG | English (Nigeria) |
| en-NZ | English (New Zealand) |
| en-PH | English (Philippines) |
| en-SG | English (Singapore) |
| en-TZ | English (Tanzania) |
| en-ZA | English (South Africa) |
| zh-CN | Chinese (China, Simplified) |
| zh-HK | Chinese (Hong Kong, Traditional) |
| zh-TW | Chinese (Taiwan, Traditional) |
| es-ES | Spanish (Spain) |
| es-MX | Spanish (Mexico) |
| es-US | Spanish (United States) |
| es-AR | Spanish (Argentina) |
| es-BO | Spanish (Bolivia) |
| es-CL | Spanish (Chile) |
| es-CO | Spanish (Colombia) |
| es-CR | Spanish (Costa Rica) |
| es-CU | Spanish (Cuba) |
| es-DO | Spanish (Dominican Republic) |
| es-EC | Spanish (Ecuador) |
| es-GQ | Spanish (Equatorial Guinea) |
| es-GT | Spanish (Guatemala) |
| es-HN | Spanish (Honduras) |
| es-NI | Spanish (Nicaragua) |
| es-PA | Spanish (Panama) |
| es-PE | Spanish (Peru) |
| es-PR | Spanish (Puerto Rico) |
| es-PY | Spanish (Paraguay) |
| es-SV | Spanish (El Salvador) |
| es-UY | Spanish (Uruguay) |
| es-VE | Spanish (Venezuela) |
| ar-EG | Arabic (Egypt) |
| ar-SA | Arabic (Saudi Arabia) |
| ar-AE | Arabic (United Arab Emirates) |
| ar-MA | Arabic (Morocco) |
| ar-SY | Arabic (Syria) |
| ru-RU | Russian (Russia) |
| pt-PT | Portuguese (Portugal) |
| pt-BR | Portuguese (Brazil) |
| fr-BE | French (Belgium) |
| fr-CA | French (Canada) |
| fr-CH | French (Switzerland) |
| fr-FR | French (France) |
| de-DE | German (Germany) |
| de-AT | German (Austria) |
| de-CH | German (Switzerland) |
| ko-KR | Korean (South Korea) |
| ja-JP | Japanese (Japan) |
| hi-IN | Hindi (India) |
| tr-TR | Turkish (Turkey) |
| ur-IN | Urdu (India) |
| fil-PH | Filipino (Philippines) |
| fi-FI | Finnish (Finland) |
| cs-CZ | Czech (Czech Republic) |
| hu-HU | Hungarian (Hungary) |
| da-DK | Danish (Denmark) |
| nl-BE | Dutch (Belgium) |
| pl-PL | Polish (Poland) |
| ro-RO | Romanian (Romania) |
| sk-SK | Slovak (Slovakia) |
| sv-SE | Swedish (Sweden) |
| hr-HR | Croatian (Croatia) |
| id-ID | Indonesian (Indonesia) |
| it-IT | Italian (Italy) |
| it-CH | Italian (Switzerland) |
| bg-BG | Bulgarian (Bulgaria) |
| el-GR | Greek (Greece) |
| ms-MY | Malay (Malaysia) |
| ta-IN | Tamil (India) |
| uk-UA | Ukrainian (Ukraine) |
| sq-AL | Albanian (Albania) |
| az-AZ | Azerbaijani (Azerbaijan) |
| eu-ES | Basque (Spain) |
| bn-IN | Bengali (India) |
| bs-BA | Bosnian (Bosnia and Herzegovina) |
| yue-CN | Cantonese (China) |
| ca-ES | Catalan (Spain) |
| gl-ES | Galician (Spain) |
| gu-IN | Gujarati (India) |
| is-IS | Icelandic (Iceland) |
| kn-IN | Kannada (India) |
| kk-KZ | Kazakh (Kazakhstan) |
| lv-LV | Latvian (Latvia) |
| lt-LT | Lithuanian (Lithuania) |
| mk-MK | Macedonian (North Macedonia) |
| ml-IN | Malayalam (India) |
| mt-MT | Maltese (Malta) |
| mr-IN | Marathi (India) |
| mn-MN | Mongolian (Mongolia) |
| ne-NP | Nepali (Nepal) |
| nb-NO | Norwegian Bokmål (Norway) |
| pa-IN | Punjabi (India) |
| sl-SI | Slovenian (Slovenia) |
| so-SO | Somali (Somalia) |
| sr-RS | Serbian (Serbia) |
| sw-KE | Swahili (Kenya) |
| sw-TZ | Swahili (Tanzania) |
| uz-UZ | Uzbek (Uzbekistan) |
| vi-VN | Vietnamese (Vietnam) |
| he-IL | Hebrew (Israel) |
| fa-IR | Persian (Iran) |
| th-TH | Thai (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ål | nb‑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 |