接入说明

接入准备

• 登录DUI控制台
• 创建基础技术产品
• 配置授权
• 发布产品

连接上需要携带的公共参数

云端对接云端的授权参数

一条完整的云端对接云端的连接示例:

http://translation.duiopen.com/runtime/v1/translation/translate?from=zh&to=en&q=%e4%bd%a0%e5%a5%bd?&productId=278578090&apikey=0ddddeeeeeeeeeeee88888888260c8ab 

接口说明 

文本翻译接口

 请求方式

GET/POST

注意：

GET方式需要将参数q进行url encode；

POST方式只接受Content-Type为application/json格式；参数q无需url encode；

请求uri

/runtime/v1/translation/translate?公共参数&授权参数

请求参数

返回值

JSON格式

请求示例

GET请求

curl 'http://translation.duiopen.com/runtime/v1/translation/translate?productId=1000001&userId=9527&apikey=0ddddeeeeeeeeeeee88888888260c8ab&from=zh&to=en&q=%e4%bd%a0%e5%a5%bd'

{
    "errId":"0",  //业务状态码
    "errMsg":"success", //状态码描述信息
    "recordId" : "RECORD-ID",
    "data": {
        "from": "zh",  //源语言
        "to": "en",    //目标语言
        "src": "你好",   //翻译文本
        "transResults": [
            {
                "dst": "Hello"   //翻译结果
            }
        ]
    }
}


POST请求


curl 'http://translation.duiopen.com/runtime/v1/translation/translate?productId=1000001&userId=9527&apikey=0ddddeeeeeeeeeeee88888888260c8ab' \
 -d '{"from" : "zh", "to" : "en", "q" : "你好"}' -H 'Content-Type: application/json' -XPOST

{
    "errId":"110023",  //业务状态码
    "errMsg":"request translation engine timeout", //状态码描述信息
    "recordId" : "RECORD-ID",
}

创建定制库

请求方式

POST

请求uri

/runtime/v1/translation/sub-account/create?公共参数&授权参数

请求参数

返回值

JSON格式

请求示例

curl -XPOST 'http://translation.duiopen.com/runtime/v1/translation/sub-account/create?productId=1000001&userId=9527&apikey=0ddddeeeeeeeeeeee88888888260c8ab'
{
  "errId":"0",
  "errMsg":"success",
  "recordId" : "RECORD-ID"
}

添加术语词典

请求方式

POST

请求uri

/runtime/v1/translation/customize/dict/add?公共参数&授权参数

请求参数

注意事项

1. 所有字段必须为UTF-8编码

   2. 为保证服务质量，srcText/dstText长度不能超过255字符

返回值

JSON格式

请求示例

curl -XPOST 'http://translation.duiopen.com/runtime/v1/translation/customize/dict/add?productId=1000001&userId=9527&apikey=0ddddeeeeeeeeeeee88888888260c8ab' -d \
'{ "srcText" : "你是个好人", "dstText" : "good man", "from" : "zh", "to" : "en" }'
{
  "errId":"0",
  "errMsg":"success",
  "recordId" : "RECORD-ID"，
  "data" : {"dictId" : ""}
}

更新术语词典

 请求方式

PUT

请求uri

/runtime/v1/translation/customize/dict/update?公共参数&授权参数

请求参数

注意事项

1. 所有字段必须为UTF-8编码

   2. 为保证服务质量，srcText/dstText长度不能超过255字符

返回值

JSON格式

请求示例

curl -XPUT 'http://translation.duiopen.com/runtime/v1/translation/customize/dict/update?productId=1000001&userId=9527&apikey=0ddddeeeeeeeeeeee88888888260c8ab' -d \
'{ "dictId" : 1, "dstText" : "good man"}'
{
  "errId":"0",
  "errMsg":"success",
  "recordId" : "RECORD-ID"，
  "data" : {"dictId" : ""}
}

删除术语词典

 请求方式

POST

请求uri

/runtime/v1/translation/customize/dict/delete?公共参数&授权参数

请求参数

返回值

JSON格式

请求示例

curl -XPOST 'http://translation.duiopen.com/runtime/v1/translation/customize/dict/delete?productId=1000001&userId=9527&apikey=0ddddeeeeeeeeeeee88888888260c8ab' -d \
'{ "dictId" : 1}'
{
  "errId":"0",
  "errMsg":"success",
  "recordId" : "RECORD-ID"
}

查询术语词典

请求方式

POST

请求uri

/runtime/v1/translation/customize/dict/list?公共参数&授权参数

请求参数

注意事项

1. 所有字段必须为UTF-8编码

   2. 为保证服务质量，srcText/dstText长度不能超过255字符

返回值

JSON格式

请求示例

curl -XPOST 'http://translation.duiopen.com/runtime/v1/translation/customize/dict/list?productId=1000001&userId=9527&apikey=0ddddeeeeeeeeeeee88888888260c8ab'
{
    "errMsg": "success",
    "errId": "0",
    "data": {
        "totalPage": 1,             
        "totalCount": 1,            
        "page": 1,                  
        "pageSize": 12,             
        "dictList": [
            {
                "dictId": 1,
                "srcText": "你是个好人",
                "from": "zh",
                "createTime": "2019-12-03 11:04:42",
                "to": "en",
                "dstText": "good man"
            }
        ]
    },
    "recordId": "0c31f876-4eb2-4b62-ab8f-73958c5c5a62"
}

添加翻译记忆

请求方式

POST

请求uri

/runtime/v1/translation/customize/memory/add?公共参数&授权参数

请求参数

注意事项

1. 所有字段必须为UTF-8编码

   2. 为保证服务质量，srcText/dstText长度不能超过255字符

返回值

JSON格式

请求示例

curl -XPOST 'http://translation.duiopen.com/runtime/v1/translation/customize/memory/add?productId=1000001&userId=9527&apikey=0ddddeeeeeeeeeeee88888888260c8ab' -d \
'{ "srcText" : "你是个好人", "dstText" : "good man", "from" : "zh", "to" : "en" }'
{
  "errId":"0",
  "errMsg":"success",
  "recordId" : "RECORD-ID"，
  "data" : {"memoryId" : ""}
}

更新翻译记忆

请求方式

PUT

请求uri

/runtime/v1/translation/customize/memory/update?公共参数&授权参数

请求参数

注意事项

1. 所有字段必须为UTF-8编码

   2. 为保证服务质量，srcText/dstText长度不能超过255字符

返回值

JSON格式

请求示例

curl -XPUT 'http://translation.duiopen.com/runtime/v1/translation/customize/memory/update?productId=1000001&userId=9527&apikey=0ddddeeeeeeeeeeee88888888260c8ab' -d \
'{ "memoryId" : 1, "dstText" : "good man"}'
{
  "errId":"0",
  "errMsg":"success",
  "recordId" : "RECORD-ID"，
  "data" : {"memoryId" : ""}
}

删除翻译记忆

请求方式

POST

请求uri

/runtime/v1/translation/customize/memory/delete?公共参数&授权参数

请求参数

返回值

JSON格式

请求示例

curl -XPOST 'http://translation.duiopen.com/runtime/v1/translation/customize/memory/delete?productId=1000001&userId=9527&apikey=0ddddeeeeeeeeeeee88888888260c8ab' -d \
'{ "memoryId" : 1}'
{
  "errId":"0",
  "errMsg":"success",
  "recordId" : "RECORD-ID"
}

查询翻译记忆

请求方式

POST

请求uri

/runtime/v1/translation/customize/memory/list?公共参数&授权参数

请求参数

注意事项

1. 所有字段必须为UTF-8编码

   2. 为保证服务质量，srcText/dstText长度不能超过255字符

返回值

JSON格式

请求示例

curl -XPOST 'http://translation.duiopen.com/runtime/v1/translation/customize/memory/list?productId=1000001&userId=9527&apikey=0ddddeeeeeeeeeeee88888888260c8ab'
{
    "errMsg": "success",
    "errId": "0",
    "data": {
        "totalPage": 1,             
        "totalCount": 1,            
        "page": 1,                  
        "pageSize": 12,             
        "memoryList": [
            {
                "memoryId": 1,
                "srcText": "你是个好人",
                "from": "zh",
                "createTime": "2019-12-03 11:04:42",
                "to": "en",
                "dstText": "good man"
            }
        ]
    },
    "recordId": "0c31f876-4eb2-4b62-ab8f-73958c5c5a62"
}

语言支持列表接口

请求方式

GET

请求uri

/runtime/v1/translation/language?公共参数&授权参数

请求参数

DICTIONARY

返回值

JSON格式

请求示例

curl 'http://translation.duiopen.com/runtime/v1/translation/language?productId=1000001&userId=9527&apikey=0ddddeeeeeeeeeeee88888888260c8ab'
{
    "errId":"0",  //业务状态码
    "errMsg":"success", //状态码描述信息
    "data" : {
        "n" : [           //语言中文的首字母
            {
                "chinesePrefix" : "n",
                "code" : "af",
                "description" : "南非荷兰语"
            },
            ...
        ],
       "j" : [            //语言中文的首字母
           {
                "chinesePrefix" : "j",
                "code" : "ca",
                "description" : "加泰罗尼亚语"
           },
           ...
       ],
       ...
    }
    
}

自定义翻译内容

概念说明

在翻译功能使用过程中，如果觉得系统对某个术语（单词/词组）或句子翻译结果不准确，可以通过“术语词典”和“翻译记忆”功能自定义术语译文。重新定义后，系统的翻译结果均会采用您自定义的结果。其中：术语词典是专门用于定制词汇；翻译记忆则用于定制句子。

自定义翻译内容中涉及两个概念：

【源语】：您需要翻译的词；以中译英为例，“你好”；

【目标语】：您需要得到的翻译结果；以中译英为例，您可以自定义“你好”的翻译结果为“hello world”。

术语词典

1. 在您的基础技术产品详情页，点击【机器翻译】，进入机器翻译产品详情页。

2. 在详情页，点击【术语词典】TAB，可以通过【添加术语】完成自定义翻译结果的添加。如下图：

翻译记忆

1. 在您的基础技术产品详情页，点击【机器翻译】，进入机器翻译产品详情页。

2. 在详情页，点击【翻译记忆】TAB，可以通过【添加记忆】完成自定义翻译结果的添加。如下图：

错误码信息

支持术语词典和翻译记忆的语言列表

支持文本翻译的语言列表