定制化翻译服务主要使用接口介绍

1.定制模型调用接口

  • 请求URL:[http|https]://automl.cn-hangzhou.aliyuncs.com/api/automl/predict
  • 本接口(PredictMTModel)通过RPC方式,用于获取机翻自学习模型产出的结果

调试

点击这里在OpenAPI Explorer中可视化调试,并自动生成SDK调用示例

1.1 输入参数

参数名称 必选 类型 描述
ModelId Long 模型Id
Content String 需要翻译的内容
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调用示例

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() {
        String accessKeyId = "";
        String accessKeySecret = "";
        String regionId = "cn-hangzhou";
        try {
            // 创建DefaultAcsClient实例并初始化
            DefaultProfile profile = DefaultProfile.getProfile("cn-hangzhou", accessKeyId, accessKeySecret); // 您的AccessKey Secret
            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 原文
TargetText String 干预文本
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"
}
			

4. 错误码

错误码 含义说明
200 正常返回
10001 参数校验异常
11009 调用额度已超出限制
13016 调用接口被限流(默认模型+用户维度10qps)
13017 模型鉴权失败
13018 未找到模型
13020 模型未发布成功
19999 服务器内部出现错误,请稍后重试或者联系客服人员帮忙解决。