4.3 语言理解服务接口说明
4.3.2 情感分析(领域版)
功能介绍
领域情感分析,针对电商,汽车领域,自适应领域(通用、电商、汽车)的用户评论 进行情感分析。
具体Endpoint请参见终端节点。
调用华为云NLP服务会产生费用,本API支持使用领域套餐包,购买时请在自然语言处
理价格计算器中查看基础套餐包和领域套餐包支持的API范围。
调
您可以在API Explorer中调试该接口。
前提条件
在使用本API之前,需要您完成服务申请和认证鉴权,具体操作流程请参见申请服务和
认证鉴权章节。
说明
用户首次使用需要先申请开通。服务只需要开通一次即可,后面使用时无需再次申请。如未开通 服务,调用服务时会提示ModelArts.4204报错,请在调用服务前先进入控制台开通服务,并注 意开通服务区域与调用服务的区域保持一致。
URI
● URI格式
POST /v1/{project_id}/nlu/sentiment/domain
● 参数说明
表4-59 URI 参数说明
参数名 必选 说明
project_id 是 项目编号。获取方法,请参见获取项目ID。
请求消息
请求参数如表4-60所示。
表4-60 请求参数
参数名 参数类
型
必选 说明
content String 是 待分析文本。文本编码要求为utf-8,目前仅支 持中文。
● type为0(自适应领域),1(电商领域评 论)时,限定200个字符以内,文本长度超 过200个字符时,只检测前200个字符。
● type为2(汽车领域评论)时,限定400个字 符以内,文本长度超过400个字符时,只检 测前400个字符。
type Integer 否 取值如下,默认值为0:
0:自适应领域,根据输入内容自动识别适应领 域。
1:电商领域,适用于电商领域评论。
2:汽车领域,适用于汽车领域评论。
响应消息
响应参数如表4-61所示。
表4-61 响应参数
参数名 参数类型 说明
result Result object 调用成功时的返回情感信息。
调用失败时无此字段。
请参见表4-62。
error_code String 调用失败时的错误码。
调用成功时无此字段。
error_msg String 调用失败时的错误信息。
调用成功时无此字段。
表4-62 result 字段数据结构说明
参数名 参数类型 说明
content String 待分析文本。
label Integer 正负标签。
● 1:positive
● 0:negative
参数名 参数类型 说明
confidence Float 标签label的置信度。
示例
● 请求示例
POST https://{endpoint}/v1/{project_id}/nlu/sentiment/domain Request Header:
Content-Type: application/json
X-Auth-Token:MIINRwYJKoZIhvcNAQcCoIINODCCDTQCAQExDTALBglghkgBZQMEAgEwgguVBgkqhkiG...
Request Body:
{
-*-# 此demo仅供测试使用,建议使用sdk。需提前安装requests,执行pip install requests import requests
import json def nlp_demo():
url = 'https://{endpoint}/v1/{project_id}/nlu/sentiment/domain' # endpoint和project_id需替换 token = '用户对应region的token'
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}/nlu/sentiment/domain");
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);
//输入参数
String content = "你好,房先生,我喜欢这款车。";
String body = "{\"content\":\"" + content + "\" ,\"type\":0}";
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()) {
System.out.println(br.readLine());
}
} catch (Exception e) { e.printStackTrace();
} }
public static void main(String[] args) { NLPDemo nlpDemo = new NLPDemo();
nlpDemo.nlpDemo();
} }
● 响应示例
– 成功响应示例
{
"result": {
"content":"很不错的一款车,可以改变生活方式。", "label": 1,
"confidence": 0.96399385 }
}
– 失败响应示例
{ "error_code": "NLP.0101",
"error_msg": "Authentication failed. Please verify the token"
}
状态码
状态码请参见状态码。
错误码
错误码请参见错误码。