定制化翻译服务调用指南

机翻翻译自学习平台定制化翻译服务主要使用接口介绍。

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访问的身份验证。具体配置操作(或者配置环境变量),请参见https://help.aliyun.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();// 从环境变量读取访问凭证。
        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"
}
                        

4. 错误码

错误码

含义说明

200

正常返回

10001

参数校验异常

11009

调用额度已超出限制

13016

调用接口被限流(默认模型+用户维度10qps)

13017

模型鉴权失败

13018

未找到模型

13020

模型未发布成功

19999

服务器内部出现错误,请稍后重试或者联系客服人员帮忙解决。