定制化翻譯服務(wù)調(diào)用指南
機翻翻譯自學習平臺定制化翻譯服務(wù)主要使用接口介紹。
1.定制模型調(diào)用接口
請求URL:[http|https]://automl.cn-hangzhou.aliyuncs.com/api/automl/predict。
本接口(PredictMTModel)通過RPC方式,用于獲取機翻自學習模型產(chǎn)出的結(jié)果。
1.1 輸入?yún)?shù)
參數(shù)名稱 | 必選 | 類型 | 描述 |
ModelId | 是 | Long | 模型Id |
Content | 是 | String | 需要翻譯的內(nèi)容,長度限制5000字節(jié) |
ModelVersion | 否 | String | 可以傳入模型的版本號,例如V1、V2等,不傳默認用最新版本 |
1.2 輸出參數(shù)
參數(shù)名稱 | 類型 | 描述 |
code | Int32 | 錯誤碼 |
message | String | 錯誤信息 |
success | Boolean | 結(jié)果是否正確 |
result | String | 譯文 |
示例
輸入:
{
"ModelId": "532",
"Content": "你好",
"ModelVersion": "V1" //可以傳入模型的版本號,例如V1、V2等,不傳默認用最新版本
}
輸出:
{"Data":["hello"],"RequestId":"fweo1j3931jd","Code":0}
定制模型SDK調(diào)用示例
阿里云賬號AccessKey擁有所有API的訪問權(quán)限,建議您使用RAM用戶進行API訪問或日常運維。
強烈建議不要把AccessKey ID和AccessKey Secret保存到工程代碼里,否則可能導(dǎo)致AccessKey泄露,威脅您賬號下所有資源的安全。本示例使用了阿里云Credentials工具托管AccessKey,來實現(xiàn)API訪問的身份驗證。具體配置操作(或者配置環(huán)境變量),請參見http://bestwisewords.com/document_detail/378659.html。
package com.alibaba.nlp.automl.modelcenter.service;
import com.aliyuncs.CommonRequest;
import com.aliyuncs.CommonResponse;
import com.aliyuncs.DefaultAcsClient;
import com.aliyuncs.IAcsClient;
import com.aliyuncs.http.MethodType;
import com.aliyuncs.profile.DefaultProfile;
public class PredictDemo {
private void predictModel() {
EnvironmentVariableCredentialsProvider credentialsProvider = CredentialsProviderFactory.newEnvironmentVariableCredentialsProvider();// 從環(huán)境變量讀取訪問憑證。
String regionId = "cn-hangzhou";
try {
// 創(chuàng)建DefaultAcsClient實例并初始化
DefaultProfile profile = DefaultProfile.getProfile("cn-hangzhou", credentialsProvider);
IAcsClient client = new DefaultAcsClient(profile);
// 創(chuàng)建API請求并設(shè)置參數(shù)
CommonRequest request = new CommonRequest();
request.setDomain("automl.cn-hangzhou.aliyuncs.com");
request.setVersion("2019-07-01");
request.setAction("PredictMTModel");
request.setMethod(MethodType.POST);
request.putQueryParameter("ModelId", "647");
request.putQueryParameter("ModelVersion", "V1");
request.putBodyParameter("Content", "hello");
CommonResponse response = client.getCommonResponse(request);
System.out.println(response);
} catch (Exception e) {
e.printStackTrace();
}
}
}
2. 干預(yù)接口
請求URL:[http|https]://automl.cn-hangzhou.aliyuncs.com/api/automl/addMtIntervenePackage。
本接口(AddMtIntervenePackage)通過RPC方式,用于獲取機翻自學習模型產(chǎn)出的結(jié)果。
2.1 輸入?yún)?shù)
參數(shù)名稱 | 必選 | 類型 | 描述 |
PackageName | 是 | String | 詞包名稱 |
ProjectId | 是 | Long | 項目id |
SourceLanguage | 是 | String | 源語種(zh,ja,en) |
TargetLanguage | 是 | String | 目標語種(zh,ja,en) |
2.2 輸出參數(shù)
參數(shù)名稱 | 類型 | 描述 |
code | Int32 | 返回代碼 |
message | String | 錯誤信息 |
RequestId | String | 請求Id |
PackageId | Long | 詞包Id |
輸入:
{
"PackageName": "test",
"ProjectId": "1",
"SourceLanguage": "zh",
"TargetLanguage": "en",
}
輸出:
{
"Code": "200",
"RequestId": "aare83jnn9wj3",
"Message": "",
"PackageId": "1"
}
3 干預(yù)詞新增接口
請求URL:[http|https]:[http|https]://automl.cn-hangzhou.aliyuncs.com/api/automl/addMTInterveneWord。
本接口(AddMTInterveneWord)通過RPC方式,用于獲取機翻自學習模型產(chǎn)出的結(jié)果。
3.1 輸入?yún)?shù)
參數(shù)名稱 | 必選 | 類型 | 描述 |
SourceText | 是 | String | 原文,長度限制1024字節(jié) |
TargetText | 是 | String | 干預(yù)文本,長度限制1024字節(jié) |
PackageId | 是 | Long | 詞包Id |
ProjectId | 是 | Long | 項目id |
3.2 輸出參數(shù)
參數(shù)名稱 | 類型 | 描述 |
code | Int32 | 返回代碼 |
message | String | 錯誤信息 |
RequestId | String | 請求Id |
WordId | Long | 詞Id |
輸入:
{
"PackageName": "test",
"ProjectId": "1"
}
輸出:
{
"Code": "200",
"RequestId": "aare83jnn9wj3",
"Message": "",
"PackageId": "1"
}
4 干預(yù)詞包綁定模型接口
請求URL:[http|https]:[http|https]://automl.cn-hangzhou.aliyuncs.com/api/automl/bindIntervenePackageAndModel。
本接口(BindIntervenePackageAndModel)通過RPC方式,用于獲取機翻自學習模型產(chǎn)出的結(jié)果。
4.1 輸入?yún)?shù)
參數(shù)名稱 | 必選 | 類型 | 描述 |
ModelId | 是 | Long | 模型Id |
ModelVersion | 否 | String | 模型版本,不傳入選擇最新版本 |
PackageId | 是 | Long | 詞包Id |
ProjectId | 是 | Long | 項目id |
4.2 輸出參數(shù)
參數(shù)名稱 | 類型 | 描述 |
code | Int32 | 返回代碼 |
message | String | 錯誤信息 |
RequestId | String | 請求Id |
Success | Long | 結(jié)果是否正確 |
輸入:
{
"PackageId": "1",
"ProjectId": "1",
"ModelId": "1",
"ModelVersion": "V1"
}
輸出:
{
"Code": "200",
"RequestId": "aare83jnn9wj3",
"Message": "",
"Success": "true"
}
4. 錯誤碼
錯誤碼 | 含義說明 |
200 | 正常返回 |
10001 | 參數(shù)校驗異常 |
11009 | 調(diào)用額度已超出限制 |
13016 | 調(diào)用接口被限流(默認模型+用戶維度10qps) |
13017 | 模型鑒權(quán)失敗 |
13018 | 未找到模型 |
13020 | 模型未發(fā)布成功 |
19999 | 服務(wù)器內(nèi)部出現(xiàn)錯誤,請稍后重試或者聯(lián)系客服人員幫忙解決。 |