文档首页 > > API参考> API> 机器翻译服务接口说明> 文档翻译任务创建

文档翻译任务创建

分享
更新时间: 2020/07/31 GMT+08:00

功能介绍

由于文档翻译会需要较长的时间,因此翻译是异步的,也即接口分为创建翻译任务和查询任务状态两个接口。创建翻译任务接口创建任务完成后返回,然后用户通过调用查询任务状态接口来获得翻译状态和临时URL。 用户可以使用临时URL下载翻译好的文件,每个临时URL有效期为10分种。翻译结果会保存24小时(从翻译完成的时间算起)。24小时后如果再访问,将会返回 "task id is not found"错误。

该接口用于提交文档翻译任务,其中要翻译的文档保存在用户的OBS桶中。用户使用文档翻译服务时,服务需要拥有读取用户OBS桶权限(将OBS桶设置为公开读),授权方法见配置OBS访问权限

具体Endpoint请参见终端节点

URI

  • URI格式
    POST /v1/{project_id}/machine-translation/file-translation/jobs
  • 参数说明
    表1 URI参数说明

    参数名

    必选

    说明

    project_id

    项目编号。获取方法,请参见获取项目ID

请求消息

请求参数说明请参见 表2
表2 请求参数说明

参数名

参数类型

必选

说明

url

String

存放在OBS的文档文件路径,私密文件推荐使用临时授权URL调用服务,如何获取OBS文件URL和临时授权URL请参见配置OBS访问权限。OBS的region要和请求服务的region保持一致,region不一致则OBS不可用,即使obs是公开访问权限。存放在OBS的文档文件名必须是英文字母。

from

String

翻译原语言,文档翻译服务当前仅支持中英互译。

to

String

翻译目标语言,文档翻译服务当前仅支持中英互译。

type

String

文档格式,当前仅支持翻译“docx”“pptx”格式的文档。

表3 支持的语言列表

语言(from)

语言(to)

说明

zh

en

中文翻译为英文。

en

zh

英文翻译为中文。

响应消息

响应参数说明请参见 表 响应参数说明
表4 响应参数说明

参数名

参数类型

说明

job_id

String

创建的任务标识, 如果创建任务成功时必存在。创建失败无此参数。

error_code

String

参见错误码列表,调用成功无此参数。

error_msg

String

返回错误信息,调用成功无此参数。

示例

  • 请求示例
    POST https://{endpoint}/v1/{project_id}/machine-translation/file-translation
    Request Header:  
        Content-Type:application/json
        X-Auth-Token: MIINRwYJKoZIhvcNAQcCoIINODCCDTQCAQExDTALBglghkgBZQMEAgEwgguVBgkqhkiG...   
    
    Request Body:
        {
            "url": "https://****.obs.cn-north-4.huawei.com/***.docx", 
            "from": "zh", 
            "to": "en",
            "type":"docx"
        }
     
  • 成功响应示例
    {
        "job_id": "567e6536-****-****-****-826321939656"
    }
  • 失败响应示例
    {
        "error_code": "NLP.0101",
        "error_msg": "Authentication failed. Verify the token."
    }
分享:

    相关文档

    相关产品

文档是否有解决您的问题?

提交成功!

非常感谢您的反馈,我们会继续努力做到更好!

反馈提交失败,请稍后再试!

*必选

请至少选择或填写一项反馈信息

字符长度不能超过200

提交反馈 取消

如您有其它疑问,您也可以通过华为云社区问答频道来与我们联系探讨

智能客服提问云社区提问