本文档介绍如何通过文档翻译API进行文档翻译。
功能介绍
文档翻译,支持解析文档中的文本内容,并调用机器翻译引擎,将文本翻译成另一种语言,并将翻译结果重新生成和原始文档格式一样的文件。
pdf格式的原文档翻译完成后会返回docx格式的文档。
使用限制
文档语种支持:参考语种code
文档类型支持:doc,docx,xls,xlsx,csv,ppt,pptx,txt,srt,html,htm,xml,xhtml,json,xliff,tmx,dita,md,markdown,idml,pdf
文件大小:50M内,doc,docx,csv,txt,srt,pdf、html,htm,xml,xhtml,json,xliff,tmx,dita,md,markdown,idml格式100万字符内,xls、xlsx格式10万单元格内
文件URL(
FileUrl)访问权限需要为公开,URL中只能使用域名,不能使用IP地址,url中不可包含空格,请尽量避免使用中文。结果回调URL(
CallbackUrl)访问权限需要为公开,URL中只能使用域名,不能使用IP地址,URL中不可包含空格。结果文件URL(
TranslateFileUrl)有效性是1小时,查询文档翻译任务成功之后,需要在1小时内下载结果文件。
使用步骤
创建文档翻译任务(
CreateDocTranslateTask)通过调用
CreateDocTranslateTask接口,创建一个文档翻译任务。文档地址通过FileUrl参数传入,FileUrl需要是公开可以访问的URL地址,一般建议将文档托管在OSS对象存储产品上,通过有关Object命令可以让机器翻译服务进行文档读取。文档翻译任务创建成功之后,接口返回任务ID
TaskId。GetDocTranslateTask接口,通过TaskId可以查询到文档翻译任务状态。GetDocTranslateTask接口查询到任务状态已经翻译完成(translated)之后,通过返回字段TranslateFileUrl参数,可以获取到翻译之后的文档地址。
任务状态码
状态  | 状态码  | 说明  | 
ready  | 准备中  | 任务已经创建成功,等待翻译中。  | 
translating  | 翻译中  | 正在翻译中。  | 
translated  | 翻译完成  | 文档已经翻译成功。  | 
error  | 翻译错误  | 文档翻译出错。  |