4.4 机器翻译服务接口说明
4.4.1 文本翻译
"confidence": 1, "label": "stock"
} ] }
– 失败响应示例
{ "error_code": "NLP.0101",
"error_msg": "Authentication failed. Please verify the token"
}
状态码
状态码请参见状态码。
错误码
错误码请参见错误码。
4.4 机器翻译服务接口说明
4.4.1 文本翻译
功能介绍
文本翻译是为了实现语种间的转换。对于用户输入原始语种的文本，转换为目标语种 的文本。
说明
文本翻译支持一次性提交多个任务，服务会根据资源排队处理。
文本翻译接口具体Endpoint请参见终端节点。
调用华为云NLP服务会产生费用，本API按字符数阶梯计费，文本翻译不支持套餐包抵 扣，用户可以在自然语言处理价格计算器价格详情页了解具体计费说明。
调试
您可以在API Explorer中调试该接口。
前提条件
在使用本API之前，需要您完成服务申请和认证鉴权，具体操作流程请参见申请服务和
认证鉴权章节。
说明
用户首次使用需要先申请开通。服务只需要开通一次即可，后面使用时无需再次申请。如未开通 服务，调用服务时会提示ModelArts.4204报错，请在调用服务前先进入控制台开通服务，并注 意开通服务区域与调用服务的区域保持一致。
URI
● URI格式
POST /v1/{project_id}/machine-translation/text-translation
● 参数说明
表4-87 URI 参数说明
参数名 必选 说明
project_id 是 项目编号。获取方法，请参见获取项目ID。
请求消息
请求参数说明请参见表4-88。
表4-88 请求参数说明
参数名 参数类型 必选 说明
text String 是 仅支持utf-8编码，长度不超过2000 字符。一个汉字、英文字母、标点 符号等，均计为一个字符。
from String 是 翻译原语言，具体取值见表4-89。
to String 是 翻译目标语言，具体取值见表
4-89。
scene String 否 默认为“common”，当前只有通 用场景。
表4-89 文本翻译支持的语言列表
语言 说明
zh 中文
en 英文
ja 日文
ru 俄文
ko 韩语
fr 法语
es 西班牙语
de 德语
ar 阿拉伯语
语言 说明
auto 自动检测输入语种并翻译成目标语种，您需要指定目
标语种。
响应消息
响应参数说明请参见表4-90。
表4-90 响应参数说明
参数名 参数类型 说明
src_text String 调用成功时表示翻译原文，编码格式为UTF-8。
调用失败时无此字段。
translated_text String 调用成功时表示调用结果，编码格式为UTF-8。
调用失败时无此字段。
from String 调用成功时表示源语种（源语种输入为auto时，显 示语种识别结果），编码格式为UTF-8。
调用失败时无此字段。
to String 调用成功时表示目标语种，编码格式为UTF-8。
调用失败时无此字段。
error_code String 调用失败时的错误码，具体请参见错误码。
调用成功时无此字段。
error_msg String 调用失败时的错误信息。
调用成功时无此字段。
示例
● 请求示例
POST https://{endpoint}/v1/{project_id}/machine-translation/text-translation Request Header:
Content-Type:application/json X-Auth-Token:
MIINRwYJKoZIhvcNAQcCoIINODCCDTQCAQExDTALBglghkgBZQMEAgEwgguVBgkqhkiG...
Request Body:
{
"text": "欢迎使用机器翻译服务", "from": "zh",
"to": "en", "scene":"common"
}
● Python3语言请求代码示例
# coding: utf-8
-*-# 此demo仅供测试使用，建议使用sdk。需提前安装requests，执行pip install requests import requests
import json def nlp_demo():
url = 'https://{endpoint}/v1/{project_id}/machine-translation/text-translation' # endpoint和 project_id需替换
resp = requests.post(url, data=json.dumps(body), headers=header) print(resp.text)
if __name__ == '__main__':
nlp_demo() */public class NLPDemo {
public void nlpDemo() { try {
//endpoint和projectId需要替换成实际信息。
URL url = new URL("https://{endpoint}/v1/{project_id}/machine-translation/text-translation");
String token = "对应region的token";
HttpURLConnection connection = (HttpURLConnection) url.openConnection();
connection.setRequestMethod("POST");
connection.setDoInput(true);
connection.setDoOutput(true);
connection.addRequestProperty("Content-Type", "application/json");
connection.addRequestProperty("X-Auth-Token", token);
//输入参数
OutputStreamWriter osw = new OutputStreamWriter(connection.getOutputStream(),
"UTF-8");
osw.append(body);
osw.flush();
InputStream is = connection.getInputStream();
BufferedReader br = new BufferedReader(new InputStreamReader(is, "UTF-8"));
while (br.ready()) {
public static void main(String[] args) { NLPDemo nlpDemo = new NLPDemo();
nlpDemo.nlpDemo();
} }
● 成功响应示例
{ "src_text": "欢迎使用机器翻译服务",
"translated_text": "Welcome to use machine translation services", "from": "zh",
"to": "en"
}
● 失败响应示例
{ "error_code": "NLP.0101",
"error_msg": "Authentication failed. Verify the token."
}
状态码
状态码请参见状态码。
错误码
错误码请参见错误码。