1. 接口说明

以哈工大社会计算与信息检索研究中心研发的 “语言技术平台（LTP）” 为基础，为用户提供高效精准的中文自然语言处理服务。该自然语言基础处理服务包括：词法分析、依存句法分析、语义角色标注、语义依存 (依存树) 分析、语义依存 (依存图) 分析五类，其中词法分析又可以分为：中文分词、词性标注、命名实体识别。

模块简介：

• 中文分词(cws)

  中文分词(Chinese Word Segmentation, CWS)指的是将汉字序列切分成词序列。因为在汉语中，词是承载语义的最基本的单元。分词是信息检索、文本分类、情感分析等多项中文自然语言处理任务的基础。

• 词性标注(pos)

  词性标注(Part-of-speech Tagging, POS)是给句子中每个词一个词性类别的任务。这里的词性类别可能是名词、动词、形容词或其他。

• 命名实体识别(ner)

  命名实体识别(Named Entity Recognition, NER)是在句子的词序列中定位并识别人名、地名、机构名等实体的任务。

• 依存句法分析(dp)

  依存语法(Dependency Parsing, DP) 通过分析语言单位内成分之间的依存关系揭示其句法结构。直观来讲，依存句法分析识别句子中的“主谓宾”、“定状补”这些语法成分，并分析各成分之间的关系。

• 语义角色标注(srl)

  语义角色标注(Semantic Role Labeling, SRL) 是一种浅层的语义分析技术，标注句子中某些短语为给定谓词的论元 (语义角色)，如施事、受事、时间和地点等。其能够对问答系统、信息抽取和机器翻译等应用产生推动作用。

• 语义依存 (依存树) 分析(sdp)

  语义依存 (依存树) 分析(Semantic Dependency Parsing, SDP)，分析句子各个语言单位之间的语义关联，并将语义关联以依存结构呈现。使用语义依存刻画句子语义，好处在于不需要去抽象词汇本身，而是通过词汇所承受的语义框架来描述该词汇，而论元的数目相对词汇来说数量总是少了很多的。语义依存分析目标是跨越句子表层句法结构的束缚，直接获取深层的语义信息。

• 语义依存 (依存图) 分析(sdgp)

  语义依存 (依存图) 分析(Semantic Dependency Graph Parsing, SDGP) 是在语义依存树基础上做了突破，使得对连动、兼语、概念转位等汉语中常见的现象的分析更全面深入。

2. 接口地址

POST http[s]://ltpapi.xfyun.cn/v1/{func} HTTP/1.1
Content-Type:application/x-www-form-urlencoded; charset=utf-8

说明: 接口地址中{func}需替换为相应的功能模块名称，目前开放的功能模块有：中文分词(cws)、词性标注(pos)、依存句法分析(dp)、命名实体识别(ner)、语义角色标注(srl)、语义依存 (依存树) 分析(sdp)、语义依存 (依存图) 分析(sdgp)

3. 请求参数

在 Http Request Header 中配置授权认证参数，见【接口描述-授权认证】。其中 X-Param 为各配置参数组成的JSON串经BASE64编码之后的字符串，原始JSON串各字段说明如下：

X-Param生成示例：

原始JSON串：
{
    "type": "dependent"
}
BASE64编码（即X-Param）：
eyJ0eXBlIjoiZGVwZW5kZW50In0=

在 Http Request Body 中配置以下参数：

4. 返回值

返回值为json串，各字段如下：

其中sid字段主要用于追查问题，如果出现问题，可以提供sid给讯飞技术人员帮助确认问题。

data各字段说明如下：

结果示例如下：

失败结果：

{
    "code": "10105",
    "desc": "illegal access|invalid X-Appid",
    "data": {},
    "sid": "ltp0000a744@ch78290eb1e128000100"
}

成功结果：

中文分词(cws)

{
    "code": "0",
    "data": {
        "word": [
            "他",
            "叫",
            "汤姆",
            "去",
            "拿",
            "外衣",
            "。"
        ]
    },
    "desc": "success",
    "sid": "ltp00000006@ch7ea90e9a28b8000100"
}

词性标注(pos)

{
    "code": "0",
    "data": {
        "pos": [
            "r",
            "v",
            "nh",
            "v",
            "v",
            "n",
            "wp"
        ]
    },
    "desc": "success",
    "sid": "ltp00000007@ch7ea90e9a28ef000100"
}

"r", "v", "nh", "v", "v", "n", "wp" 分别对应cws返回结果中的"他", "叫", "汤姆", "去", "拿", "外衣", "。"

依存句法分析(dp)

{
    "code": "0",
    "data": {
        "dp": [
            {
                "parent": 1,
                "relate": "SBV"
            },
            {
                "parent": -1,
                "relate": "HED"
            },
            {
                "parent": 1,
                "relate": "DBL"
            },
            {
                "parent": 4,
                "relate": "ADV"
            },
            {
                "parent": 1,
                "relate": "VOB"
            },
            {
                "parent": 4,
                "relate": "VOB"
            },
            {
                "parent": 1,
                "relate": "WP"
            }
        ]
    },
    "desc": "success",
    "sid": "ltp00000005@ch7ea90e9a2858000100"
}

以dp[0]为例，"他"的父节点是"叫"，他们中间的关系为SBV，即主谓关系。

命名实体识别(ner)

{
    "code": "0",
    "data": {
        "ner": [
            "O",
            "O",
            "S-Nh",
            "O",
            "O",
            "O",
            "O"
        ]
    },
    "desc": "success",
    "sid": "ltp00000008@ch7ea90e9a2928000100"
}

"O", "O", "S-Nh", "O", "O", "O", "O" 分别对应cws返回结果中的"他", "叫", "汤姆", "去", "拿", "外衣", "。"

语义角色标注(srl)

{
    "code": "0",
    "data": {
        "srl": [
            {
                "beg": 0,
                "end": 0,
                "id": 1,
                "type": "A0"
            },
            {
                "beg": 2,
                "end": 2,
                "id": 1,
                "type": "A1"
            },
            {
                "beg": 3,
                "end": 5,
                "id": 1,
                "type": "A2"
            },
            {
                "beg": 5,
                "end": 5,
                "id": 4,
                "type": "A1"
            }
        ]
    },
    "desc": "success",
    "sid": "ltp0000a741@ch78290eb1df9e000100"
}

语义依存 (依存树) 分析(sdp)

{
    "code": "0",
    "data": {
        "sdp": [
            {
                "parent": 2,
                "relate": "Agt"
            },
            {
                "parent": 0,
                "relate": "Root"
            },
            {
                "parent": 2,
                "relate": "Datv"
            },
            {
                "parent": 2,
                "relate": "eSucc"
            },
            {
                "parent": 4,
                "relate": "ePurp"
            },
            {
                "parent": 5,
                "relate": "Pat"
            },
            {
                "parent": 2,
                "relate": "mPunc"
            }
        ]
    },
    "desc": "success",
    "sid": "ltp00000002@ch409d0e9a29ec000100"
}

以sdp[0]为例，"他"的父节点是"叫"，他们中间的关系为Agt，即施事关系。

语义依存 (依存图) 分析(sdgp)

{
    "code": "0",
    "data": {
        "sdgp": [
            {
                "id": 0,
                "parent": 1,
                "relate": "Agt"
            },
            {
                "id": 1,
                "parent": -1,
                "relate": "Root"
            },
            {
                "id": 2,
                "parent": 1,
                "relate": "Datv"
            },
            {
                "id": 2,
                "parent": 3,
                "relate": "Agt"
            },
            {
                "id": 2,
                "parent": 4,
                "relate": "Agt"
            },
            {
                "id": 3,
                "parent": 1,
                "relate": "eSucc"
            },
            {
                "id": 4,
                "parent": 3,
                "relate": "ePurp"
            },
            {
                "id": 5,
                "parent": 4,
                "relate": "Pat"
            },
            {
                "id": 6,
                "parent": 4,
                "relate": "mPunc"
            }
        ]
    },
    "desc": "success",
    "sid": "ltp0000000a@dx4f2f0f1f5931000100"
}

以sdgp[0]为例，"他"的父节点是"叫"，他们中间的关系为Agt，即施事关系。

5. 调用示例

python脚本示例(python3)

说明：将脚本中TEXT, API_KEY, APPID,{func}, 换成相应的待分析文本，讯飞开放平台提供的apiKey，讯飞开放平台应用的appid以及功能模块名称即可，运行脚本可打印相应结果。

#!/usr/bin/python
# -*- coding: UTF-8 -*-
import time
import urllib.request
import urllib.parse
import json
import hashlib
import base64
def main():
    body = urllib.parse.urlencode({'text': 'TEXT'}).encode('utf-8')
    url = 'http://ltpapi.xfyun.cn/v1/{func}'
    api_key = 'API_KEY'
    param = {"type": "dependent"}
    x_appid = 'APPID'
    x_param = base64.b64encode(json.dumps(param).replace(' ', '').encode('utf-8'))
    x_time = int(int(round(time.time() * 1000)) / 1000)
    x_checksum = hashlib.md5(api_key.encode('utf-8') + str(x_time).encode('utf-8') + x_param).hexdigest()
    x_header = {'X-Appid': x_appid,
                'X-CurTime': x_time,
                'X-Param': x_param,
                'X-CheckSum': x_checksum}
    req = urllib.request.Request(url, body, x_header)
    result = urllib.request.urlopen(req)
    result = result.read()
    print(result.decode('utf-8'))
    return
if __name__ == '__main__':
    main()

6. 附录

6.1. 词性标记集

6.2. 依存句法分析标注关系

6.3. 命名实体说明

前缀说明: 包含BIES四种前缀，分别表示 开始、中间、结束、独立

6.4. 语义角色列表

备注: 核心的语义角色为A0-5六种，A0通常表示动作的施事，A1通常表示动作的影响等，A2-5根据谓语动词不同会有不同的语义含义。

6.4.1. 语义依存关系说明

6.5. 调用示例

自然语言基础处理demo go语言

自然语言基础处理demo php语言

自然语言基础处理demo java语言

自然语言基础处理demo python3语言

自然语言基础处理demo c#语言

Copyright © iflytek.com 2018 all right reserved，powered by Gitbook该文件修订时间：2019-05-07 07:12:51