跳转到主要内容

输入与输出

输入:
  • video_url
  • 源语言和目标语言
  • [可选] glossary_ids
  • [可选] user_prompt
  • [可选] project_mode
输出:
  • 翻译后的视频 video_url
  • project_modeeditable 时返回 project_url

工作原理

1

将你的视频托管到可公开访问的 URL

上传你的输入视频,以便我们的服务器可以获取。视频时长不得超过 20 分钟。
2

发送画面翻译请求

包括源语言和目标语言代码,以及用于术语和风格的可选术语表 ID 或提示说明。
3

等待或查询状态

使用你的 webhook 回调,或使用返回的任务 ID 轮询 API,直到处理完成。
4

下载翻译后的视频

任务完成后,从 video_url 获取翻译后的视频。如果你创建的是可编辑项目,可打开 project_url 在网页工作台中查看或编辑。

使用限制

  • 只有能够创建 API Key 的用户才可以使用此 API。
  • 需要 Studio 方案;非 Studio 用户不允许使用。
  • 输入必须为视频文件。不支持仅导出音频。
  • 支持的最长输入时长为 20 分钟。
  • 不支持自动检测源语言。请显式传入受支持的源语言代码。
  • 语言代码遵循 IETF BCP 47 风格,例如 en-USzh-CNzh-CN-GUANGXI

API 错误代码

CodeDescription
5无效的请求参数。
7无请求权限。
104点数不足。
814你的账号不是成员,不允许调用该 API。
1000服务器内部错误。
1301回调验证失败。
1302API key 已被撤销。
1304API key 已达到最大并发请求数。
1503你的账号未获授权调用该 API。
1305仅允许 Studio 方案。

任务错误代码

CodeDescription
40002上传的文件没有视频流。
40010转码失败。
40050翻译失败。
40020OCR 提取失败。
40032视频中没有有效的标注框。
40040OCR 与标注框匹配失败。
40041未能将任何标注框匹配到 OCR。
40060标注框优化失败。
40061在优化过程中提取样式失败。
40080生成预览视频失败。
最后修改于 2026年7月9日