文档中心 > 命名实体识别
命名实体识别

最近更新时间:2021-03-12

1 功能描述

命名实体识别又称作“专名识别”,是指识别文本中具有特定意义的实体,主要包括人名、地名、机构名、时间、数词等。

2 请求说明

2.1 请求方式

调用地址:https://apim.unicloud.com/api/nlp/namedentity/1.0.0/

请求方式:POST

返回类型:JSON

2.2 请求参数

Header如下:

参数说明
Content-Typeapplication/json--
AuthorizationBearer参考Token获取

Body如下:

参数是否必选类型可选值范围说明
texttruestring-待分析文本,长度建议不超过1000个汉字,超过上限则报错

注:Body是raw-json格式

2.3 请求示例

curl -H "Authorization:Bearer 2735fbc9-b797-31ad-812c-d8e9e903f6e3" \
-H "Content-Type:application/json" \
-d '{"text": "交大学生明天去上海看周杰伦的演唱会"}' \
https://apim.unicloud.com/api/nlp/namedentity/1.0.0/

3 返回说明

3.1 返回参数

字段类型说明
datadict返回结果数据
+textstring待分析文本
+namedentityarray of objects命名实体识别结果数组
++nestring实体
++offsetint实体起始位置
++lengthint实体长度
++typestring实体类型。包括ORG(机构名),PER(人名),LOC(地点),TIM(时间点)。
++subtypestring实体子类型
codeint返回码:
0表示成功
1001表示错误的命令请求格式:如JSON格式错误
2000 表示请求的操作超时终止:如模块处理超时
2001 表示未执行请求的操作:如文本超过指定长度
messagestring返回信息

3.2 返回示例

{    
    "data": {        
        "text": "交大学生明天去上海看周杰伦的演唱会",        
            "namedentity": [
            {                
                "ne": "上海",                
                "offset": 7,                
                "length": 2,                
                "type": "LOC",                
                "subType": "CITY"
            },
            {                
                "ne": "交大",                
                "offset": 0,                
                "length": 2,                
                "type": "ORG",                
                "subType": "SCHOOL"
            },
            {                
                "ne": "明天",                
                "offset": 4,                
                "length": 2,                
                "type": "TIM",                
                "subType": "TIM"
            },
            {                
                "ne": "周杰伦",                
                "offset": 10,                
                "length": 3,                
                "type": "PER",                
                "subType": "PER"
            }
        ]
    },    
    "code": 0,    
    "message": "success"
}

3.3 实体标签说明

标签释义举例说明
PER人名王蒙、刘教授
LOC地点天安门、南京
TIM时间点昨天、两点半
ORG机构名北京大学、华为