本文檔介紹如何通過文檔翻譯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
文件大?。?0M內,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 | 翻譯錯誤 | 文檔翻譯出錯。 |