本文档介绍如何通过文档翻译API进行文档翻译。

功能介绍

文档翻译，支持解析文档中的文本内容，并调用机器翻译引擎，将文本翻译成另一种语言，并将翻译结果重新生成和原始文档格式一样的文件。

使用限制

  • 文档语种支持：参考语种code
  • 文档类型支持：doc，docx，xls，xlsx，csv，ppt，pptx，txt，srt，html，htm，xml，xhtml，json，xliff，tmx，dita，md，markdown，idml，pdf
  • 文件大小：50M内
  • 文件URL(FileUrl）访问权限需要为公开，URL中只能使用域名，不能使用IP地址，url中不可包含空格，请尽量避免使用中文。
  • 结果回调URL(CallbackUrl）访问权限需要为公开，URL中只能使用域名，不能使用IP地址，URL中不可包含空格。
  • 结果文件URL(TranslateFileUrl）有效性是1小时，查询文档翻译任务成功之后，需要在1小时内下载结果文件。

使用步骤

  • 创建文档翻译任务（CreateDocTranslateTask）

  • 通过调用CreateDocTranslateTask接口，创建一个文档翻译任务。文档地址通过FileUrl参数传入，FileUrl需要是公开可以访问的URL地址，一般建议将文档托管在OSS对象存储产品上，通过生成签名URL可以让机器翻译服务进行文档读取。

  • 文档翻译任务创建成功之后，接口返回任务IDTaskId。GetDocTranslateTask接口，通过TaskId可以查询到文档翻译任务状态。

  • GetDocTranslateTask接口查询到任务状态已经翻译完成（translated）之后，通过返回字段TranslateFileUrl参数，可以获取到翻译之后的文档地址。

任务状态码

状态状态码说明
ready准备中任务已经创建成功，等待翻译中。
translating翻译中正在翻译中。
translated翻译完成文档已经翻译成功。
error翻译错误文档翻译出错。