下面介绍文本图谱API的使用方式。Texsmart的其他API参见:文本理解API和文本匹配API。
文本图谱API支持通过HTTP-POST方式访问,API地址为 https://texsmart.qq.com/api/text_graph。
输入的post-data需要是JSON格式,输出也是JSON格式。
推荐使用Postman来查看API的结果。
obj = { "text": 高兴, "lang": "zh", "relation": "synonym_of", "k": 10 }调用API的示例代码: Python代码 | Java代码 | C++代码 | C#代码
{ "header":{"time_cost_ms":0.671,"time_cost":0.000671,"core_time_cost_ms":0.639,"ret_code":"succ"}, "item_list":[ {"order":1,"text":"快乐"}, {"order":2,"text":"开心"}, {"order":3,"text":"兴奋"}, {"order":4,"text":"喜悦"}, {"order":5,"text":"愉悦"}, {"order":6,"text":"喜乐"}, {"order":7,"text":"喜滋滋"}, {"order":8,"text":"欣喜"}, {"order":9,"text":"高高兴兴"}, {"order":10,"text":"欢愉"} ] }其中,header给出的是一些说明API调用的辅助信息(耗时、错误码等),item_list给出了“高兴”的置信度前k(这里k=10)个同义词结果。
输入JSON对象支持的字段说明如下:
字段名称 | 数据类型 | 字段说明 |
---|---|---|
text | str | 拟查询的词汇。 |
lang | str | 拟查询词汇所属的语言,支持"zh"和"en"两种语言。 |
relation | str | 拟查询的关系,支持:”synonym_of”(同义词),”antonym_of”(反义词),”instance_of”(下位词)、”class_of”(上位词)、”similar_to”(相似词)。 |
k | int | 返回结果的条数。
注:(1)当知识库中结果条数少于k时,返回数量以实际结果数为准。 (2)当k>20时,仅返回前20个结果。 |
输出JSON对象的各个字段说明如下:
字段名称 | 数据类型 | 字段说明 |
---|---|---|
header | JSON Object | 调用执行后返回的辅助信息
time_cost_ms字段:处理请求所花的时间,以毫秒(ms)计算。 time_cost字段:处理请求所花的时间,以秒来计算。 core_time_cost_ms字段:处理核心模块所花的时间,以毫秒(ms)来计算。 ret_code字段:返回码,"succ"表示成功,其它为错误码。主要错误为:error.invalid_mode: 请求关系不在预定义关系集合内。 |
item_list | JSON 列表 | 输出的结果。
该结果是一个JSON的列表,每条结果包含序号(order)和结果(text)两部分。 |
# -*- coding: utf8 -*- import json import http.client import requests obj = { "text": 高兴, "lang": "zh", "relation": "synonym_of", "k": 10 } r = requests.post(url="https://texsmart.qq.com/api/text_graph", json= obj) print(r.text)
[TBD]
[TBD]
[TBD]
TexSmart是腾讯AI Lab自然语言处理团队所构建的一个自然语言文本理解系统,用以对中文和英文两种语言的文本进行词法、句法和语义分析。 除了支持分词、词性标注、命名实体识别(NER)、句法分析、语义角色标注等常见功能外,TexSmart还提供细粒度命名实体识别、语义联想、深度语义表达等特色功能。