机翻翻译自学习平台定制化翻译服务主要使用接口介绍。
1.定制模型调用接口
请求URL:[http|https]://automl.cn-hangzhou.aliyuncs.com/api/automl/predict。
本接口(PredictMTModel)通过RPC方式,用于获取机翻自学习模型产出的结果。
1.1 输入参数
参数名称 | 必选 | 类型 | 描述 |
ModelId | 是 | Long | 模型Id |
Content | 是 | String | 需要翻译的内容,长度限制5000字节 |
ModelVersion | 否 | String | 可以传入模型的版本号,例如V1、V2等,不传默认用最新版本 |
1.2 输出参数
参数名称 | 类型 | 描述 |
code | Int32 | 错误码 |
message | String | 错误信息 |
success | Boolean | 结果是否正确 |
result | String | 译文 |
示例
输入:
{
"ModelId": "532",
"Content": "你好",
"ModelVersion": "V1" //可以传入模型的版本号,例如V1、V2等,不传默认用最新版本
}
输出:
{"Data":["hello"],"RequestId":"fweo1j3931jd","Code":0}
定制模型SDK调用示例
阿里云账号AccessKey拥有所有API的访问权限,建议您使用RAM用户进行API访问或日常运维。
强烈建议不要把AccessKey ID和AccessKey Secret保存到工程代码里,否则可能导致AccessKey泄露,威胁您账号下所有资源的安全。本示例使用了阿里云Credentials工具托管AccessKey,来实现API访问的身份验证。具体配置操作(或者配置环境变量),请参见身份验证配置。
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();
// 从环境变量读取访问凭证。
String regionId = "cn-hangzhou";
try {
// 创建DefaultAcsClient实例并初始化
DefaultProfile profile = DefaultProfile.getProfile("cn-hangzhou", credentialsProvider);
IAcsClient client = new DefaultAcsClient(profile);
// 创建API请求并设置参数
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. 干预接口
请求URL:[http|https]://automl.cn-hangzhou.aliyuncs.com/api/automl/addMtIntervenePackage。
本接口(AddMtIntervenePackage)通过RPC方式,用于获取机翻自学习模型产出的结果。
2.1 输入参数
参数名称 | 必选 | 类型 | 描述 |
PackageName | 是 | String | 词包名称 |
ProjectId | 是 | Long | 项目id |
SourceLanguage | 是 | String | 源语种(zh,ja,en) |
TargetLanguage | 是 | String | 目标语种(zh,ja,en) |
2.2 输出参数
参数名称 | 类型 | 描述 |
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. 干预词新增接口
请求URL:[http|https]:[http|https]://automl.cn-hangzhou.aliyuncs.com/api/automl/addMTInterveneWord。
本接口(AddMTInterveneWord)通过RPC方式,用于获取机翻自学习模型产出的结果。
3.1 输入参数
参数名称 | 必选 | 类型 | 描述 |
SourceText | 是 | String | 原文,长度限制1024字节 |
TargetText | 是 | String | 干预文本,长度限制1024字节 |
PackageId | 是 | Long | 词包Id |
ProjectId | 是 | Long | 项目id |
3.2 输出参数
参数名称 | 类型 | 描述 |
code | Int32 | 返回代码 |
message | String | 错误信息 |
RequestId | String | 请求Id |
WordId | Long | 词Id |
输入:
{
"PackageName": "test",
"ProjectId": "1"
}
输出:
{
"Code": "200",
"RequestId": "aare83jnn9wj3",
"Message": "",
"PackageId": "1"
}
4. 干预词包绑定模型接口
请求URL:[http|https]:[http|https]://automl.cn-hangzhou.aliyuncs.com/api/automl/bindIntervenePackageAndModel。
本接口(BindIntervenePackageAndModel)通过RPC方式,用于获取机翻自学习模型产出的结果。
4.1 输入参数
参数名称 | 必选 | 类型 | 描述 |
ModelId | 是 | Long | 模型Id |
ModelVersion | 否 | String | 模型版本,不传入选择最新版本 |
PackageId | 是 | Long | 词包Id |
ProjectId | 是 | Long | 项目id |
4.2 输出参数
参数名称 | 类型 | 描述 |
code | Int32 | 返回代码 |
message | String | 错误信息 |
RequestId | String | 请求Id |
Success | Long | 结果是否正确 |
输入:
{
"PackageId": "1",
"ProjectId": "1",
"ModelId": "1",
"ModelVersion": "V1"
}
输出:
{
"Code": "200",
"RequestId": "aare83jnn9wj3",
"Message": "",
"Success": "true"
}
5. 错误码
错误码 | 含义说明 |
200 | 正常返回 |
10001 | 参数校验异常 |
11009 | 调用额度已超出限制 |
13016 | 调用接口被限流(默认模型+用户维度10qps) |
13017 | 模型鉴权失败 |
13018 | 未找到模型 |
13020 | 模型未发布成功 |
19999 | 服务器内部出现错误,请稍后重试或者联系客服人员帮忙解决。 |