评论观点抽取接口

接口描述

本接口已于2017年5月25日升级,如果您需要查阅旧版接口文档,请查看评论观点抽取接口(旧版),但建议您尽快升级到新版接口。

评论观点抽取接口(通用版):提取评论句子的关注点和评论观点,并输出评论观点标签及评论观点极性。

评论观点抽取接口(定制版):在通用版效果基础之上,用户可以在控制台中的【个性化定制】中选择【评论观点抽取定制】,通过定制版用户可以上传13个行业垂类的自定义评论词表,有效提高评论抽取的精度和召回率,同时支持用户自定义评论的“归一化标签”。

定制版接口的详细使用教程您可以查看链接:http://ai.baidu.com/forum/topic/show/869264

请求说明

请求示例

HTTP方法: POST

  • (通用版)请求URL: https://aip.baidubce.com/rpc/2.0/nlp/v2/comment_tag
  • (定制版)请求URL: https://aip.baidubce.com/rpc/2.0/nlp/v2/comment_tag_custom
  • URL参数:
参数
access_token 通过API Key和Secret Key获取的access_token,参考“Access Token获取

Header如下:

参数
Content-Type application/json

Body请求示例:

{
    "text":"三星电脑电池不给力",
    "type":13
}

请求格式

POST方式调用

注意:要求使用JSON格式的结构体来描述一个请求的具体内容。

body整体文本内容可以支持GBK和UTF-8两种格式的编码。

1、GBK支持:默认按GBK进行编码,输入内容为GBK编码,输出内容为GBK编码,否则会接口报错编码错误

2、UTF-8支持:若文本需要使用UTF-8编码,请在url参数中添加charset=UTF-8 (大小写敏感)
例如 https://aip.baidubce.com/rpc/2.0/nlp/v1/lexer?charset=UTF-8&access_token=24.f9ba9c5241b67688bb4adbed8bc91dec.2592000.1485570332.282335-8574074

请求参数

参数 是否必选 类型 描述
text 必选 string 评论内容,最大10240字节
type 可选 int 评论行业类型,默认为4(餐饮美食)

其中type包含13个类别,具体取值说明如下:

type参数 说明 实例
1 酒店 『酒店设备齐全、干净卫生』->『酒店设备齐全』、『干净卫生』
2 KTV 『环境一般般把,音响设备也一般,隔音太差』->『环境一般』、『音响设备一般』、『隔音差』
3 丽人 『手法专业,重要的是效果很棒』->『手法专业』、『效果不错』
4 美食餐饮 『但是味道太好啦,舍不得剩下』->『味道不错』
5 旅游 『景区交通方便,是不错的旅游景点』->『交通方便』、『旅游景点不错』
6 健康 『环境很棒,技师服务热情』->『环境不错』、『服务热情』
7 教育 『教学质量不错,老师很有经验』->『教学质量不错』、『老师有经验』
8 商业 『该公司服务好,收费低,效率高』->『服务好』、『收费低』、『效率高』
9 房产 『该房周围设施齐全、出行十分方便』->『设施齐全』、『出行方便』
10 汽车 『路宝的优点就是安全性能高、空间大』->『安全性能高』、『空间大』
11 生活 『速度挺快、服务态度也不错』->『速度快』、『服务好』
12 购物 『他家的东西还是挺贵的』->『消费贵』
13 3C 『手机待机时间长』->『待机时间长』

返回格式

JSON格式

默认返回内容为GBK编码

若用户指定输入为UTF-8编码(通过指定charset参数),则返回内容为UTF-8编码

返回参数

参数 类型 描述
log_id uint64 请求唯一标识码
prop string 匹配上的属性词
adj string 匹配上的描述词
sentiment int 该情感搭配的极性(0表示消极,1表示中性,2表示积极)
begin_pos int 该情感搭配在句子中的开始位置
end_pos int 该情感搭配在句子中的结束位置
abstract string 对应于该情感搭配的短句摘要

返回示例

{
    "items": [
        {
        "prop":"电池",  
        "adj": "不给力", 
        "sentiment": 0, 
        "begin_pos": 8, 
        "end_pos": 18,
        "abstract":"三星电脑<span>电池不给力</span>"
        }
    ]
}