# 华为机器翻译
华为机器翻译连接器基于华为云自然语言处理 NLP进行集成开发，包含"文本翻译"、"文档翻译"、"文档翻译状态查询"、"语种识别"等执行动作。
#### 连接参数
华为机器翻译连接器使用IAM认证，连接参数说明如[表1]所示。
 表1连接参数说明 
| 名称   | 必填 | 说明                                                                                                      | 示例值/默认值                                      |
|:---|:---|:---|:---|
| 连接名称 | 是  | 设置连接名称。                                                                                                 | 华为机器翻译的连接                                    |
| 描述   | 否  | 对于连接的信息描述说明。                                                                                            | description                                  |
| 租户名  | 是  | IAM用户所属账号信息。了解[账号与IAM用户的关系](https://support.huaweicloud.com/productdesc-iam/iam_01_0023.html#section2)。 | domain                                       |
| 用户名  | 是  | IAM用户名。                                                                                                 | name                                         |
| 密码   | 是  | IAM用户的登录密码。                                                                                             | -                                            |
| 项目ID | 是  | 系统为用户自动生成的项目ID，单击"我的凭证 \> API凭证"，根据项目获取。                                                                | e9993fc787\*\*\*\*\*\*\*\*\*\*\*\*a340f9c0f4 |
| 站点   | 是  | 站点。                                                                                                     | iam.cn-north-4.myhuaweicloud.com             |
   
#### 文本翻译
文本翻译是为了实现语种间的转换。对于用户输入原始语种的文本，转换为目标语种的文本。
接口功能及调用方法请参见[文本翻译](https://support.huaweicloud.com/api-nlp/nlp_03_0024.html)。
- 输入参数 用户配置文本翻译执行动作，相关参数说明如[表2]所示。
   表2文本翻译输入参数说明 
  | 参数     | 必填 | 说明                                   |
  |:---|:---|:---|
  | 待翻译文本  | 是  | 待翻译文本，长度不超过5000字符。                   |
  | 翻译原语言  | 是  | 翻译原语言，有下拉框和输入框模式，填写在默认输入模式下可以选到的选项。  |
  | 翻译目标语言 | 是  | 翻译目标语言，有下拉框和输入框模式，填写在默认输入模式下可以选到的选项。 |
     
  

- 输出参数 用户可以在之后的执行动作中调用该输出参数，输出参数说明请参考[表3]。
   表3文本翻译输出参数说明 
  | 参数   | 说明         |
  |:---|:---|
  | 翻译原文 | 输入的翻译原文。   |
  | 调用结果 | 文本翻译的调用结果。 |
  | 源语种  | 翻译原文的源语种。  |
  | 目标语种 | 翻译的目标语种。   |
     
  
 
#### 文档翻译(创建翻译任务)
由于文档翻译会需要较长的时间，因此翻译是异步的，也即接口分为创建翻译任务和查询任务状态两个接口。
- 输入参数 用户配置文档翻译执行动作，相关参数说明如[表4]所示。
   表4文档翻译输入参数说明 
  | 参数       | 必填 | 说明                                                                                                                                                                                                                                                                                                      |
  |:---|:---|:---|
  | 文档文件存放路径 | 是  | 存放在OBS的文档文件路径。 选择文件所存放的桶时，必须为公共桶，不能选择私有桶。 单击公共桶名称进入后，单击所存放的文件右侧的"分享"，进入分享文件界面后，"链接信息"为文档文件存放路径。如下图举例所示： 图1文档存放路径 ![](https://support.huaweicloud.com/usermanual-mssi/zh-cn_image_0000001497509277.png "点击放大") |
  | 翻译原语言    | 是  | 翻译原语言，有下拉框和输入框模式，填写在默认输入模式下可以选到的选项。                                                                                                                                                                                                                                                                     |
  | 翻译目标语言   | 是  | 翻译目标语言，有下拉框和输入框模式，填写在默认输入模式下可以选到的选项。                                                                                                                                                                                                                                                                    |
  | 文档格式     | 是  | 文档格式，当前仅支持翻译"docx"、"pptx"和"txt"格式的文档。                                                                                                                                                                                                                                                                   |
     
  

- 输出参数 用户可以在之后的执行动作中调用该输出参数，输出参数说明请参考[表5]。
   表5文档翻译输出参数说明 
  | 参数   | 说明       |
  |:---|:---|
  | 任务标识 | 创建的任务标识。 |
     
  
 
#### 文档翻译状态查询
该接口用于获取文档翻译识别状态以及临时url，临时url可以用于获取翻译后的文档，每个临时url有效期为十分钟。本API调用限制为20次/秒。
- 输入参数 用户配置文档翻译状态查询执行动作，相关参数说明如[表6]所示。
   表6文档翻译状态查询输入参数说明 
  | 参数   | 必填 | 说明         |
  |:---|:---|:---|
  | 任务标识 | 是  | 文档翻译的任务标识。 |
     
  

- 输出参数 用户可以在之后的执行动作中调用该输出参数，输出参数说明请参考[表7]。
   表7文档翻译状态查询输出参数说明 
  | 参数       | 说明                          |
  |:---|:---|
  | 当前翻译状态   | 当前的翻译状态。                    |
  | 下载结果的url | 临时url，使用GET请求下载翻译结果，有效期十分钟。 |
     
  
#### 语种识别
语种识别是为了识别文本所属的语种。对于用户输入的文本，返回识别出的所属语种。
- 输入参数 用户配置语种识别执行动作，相关参数说明如[表8]所示。
   表8语种识别输入参数说明 
  | 参数     | 必填 | 说明                     |
  |:---|:---|:---|
  | 待识别的文本 | 是  | 需要识别语种的文本，长度不超过1000字符。 |
     
  

- 输出参数 用户可以在之后的执行动作中调用该输出参数，输出参数说明请参考[表9]。
   表9语种识别输出参数说明 
  | 参数   | 说明           |
  |:---|:---|
  | 调用结果 | 语种识别行动的调用结果。 |