4.3 语言理解服务接口说明
4.3.8 文档分类
],
"text": "来一首周杰伦的青花瓷"
} }
– 失败响应示例
{ "error_code": "NLP.0101",
"error_msg": "Authentication failed. Please verify the token"
}
状态码
状态码请参见状态码。
错误码
错误码请参见错误码。
4.3.8 文档分类
功能介绍
文档分类接口对用户输入的文本自动分类，给文本具体的分类。用户只要提供待处理 的文本，而不用关注具体实现。主要应用场景：新闻内容分类，广告识别等。
具体Endpoint请参见终端节点。
调用华为云NLP服务会产生费用，本API支持使用基础套餐包，购买时请在自然语言处
理价格计算器中查看基础套餐包和领域套餐包支持的API范围。
调试
您可以在API Explorer中调试该接口。
前提条件
在使用本API之前，需要您完成服务申请和认证鉴权，具体操作流程请参见申请服务和
认证鉴权章节。
说明
用户首次使用需要先申请开通。服务只需要开通一次即可，后面使用时无需再次申请。如未开通 服务，调用服务时会提示ModelArts.4204报错，请在调用服务前先进入控制台开通服务，并注 意开通服务区域与调用服务的区域保持一致。
URI
● URI格式
POST /v1/{project_id}/nlu/doc-classification
● 参数说明
表4-83 URI 参数说明
名称 是否必选 说明
project_id 是 项目编号。获取方法，请参见获取项目ID。
请求消息
请求参数如表4-84所示。
表4-84 请求参数
名称 是否必选 参数类型 说明
content 是 String 输入的文档，最大长度10000, 长度超过10000字符截取前 10000个字符。
lang 否 String 预留字段，支持的文本语言类
型，当前只支持zh（中文），默 认zh。
响应消息
响应参数如表4-85所示。
表4-85 响应参数
名称 参数类型 说明
result Result object 调用成功时的返回标签列表。
调用失败时无此字段。
请参见表4-86。
error_code string 调用失败时的错误码。
调用成功时无此字段。
error_msg string 调用失败时的错误码。
调用成功时无此字段。
表4-86 result 字段数据结构说明
参数名 参数类型 说明
label String 输入的文档标签，包括 sport（体育）, anime
（动漫）, hospital（医院）, history（历史）, advertising （广告）, entertainment（娱乐）, religion（宗教）, novel（小说）, estate（地 产）, recruitment（招聘）, education（教 育）, tourism（旅游）, automobile（汽车）, game（游戏）, technology（科技）, joke（笑 话）, health（健康）, gourmet（美食）, stock
（股票）, parenting（育儿）, pornography
（色情）, finance（金融）
confidence Float 标签label的置信度。
示例
情感分析。
● 请求示例
POST https://nlp-ext.cn-north-4.myhuaweicloud.com/v1/{project_id}/nlu/doc-classification Request Header:
Content-Type: application/json
-*-# 此demo仅供测试使用，建议使用sdk。需提前安装requests，执行pip install requests import requests
import json def nlp_demo():
url = 'https://{endpoint}/v1/{project_id}/nlu/doc-classification' # endpoint和project_id需替换 token = '用户对应region的token'
是新面孔。深科技创下了20年新高，与14年的深圳华强很像，可能是条潜在的大鱼，未来几个月，需要密
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/doc-classification");
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 + "\",\"lang\":\"zh\"}";
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()) {
public static void main(String[] args) { NLPDemo nlpDemo = new NLPDemo();
{
"confidence": 1, "label": "stock"
} ] }
– 失败响应示例
{ "error_code": "NLP.0101",
"error_msg": "Authentication failed. Please verify the token"
}
状态码
状态码请参见状态码。
错误码
错误码请参见错误码。