定制化翻译服务调用指南

更新时间:
复制 MD 格式

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

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

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