检测到您已登录华为云国际站账号,为了您更好的体验,建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
构造请求 本节介绍REST API请求的组成,讲述如何调用API接口。 请求示例如下所示,一个请求主要由请求URL、请求方法、请求消息头和请求消息体几部分组成,各个部分将在下文详细解释。 图1 请求示例图 请求URI 请求URI由如下部分组成。 {URI-scheme} :// {Endpoint}
公共请求参数 表1 公共请求消息头 参数名 说明 必选 示例 Content-type 发送的实体的MIME类型。 是 application/json Content-Length 请求body长度,单位为Byte。 POST/PUT请求为可选, GET不包含。 3495 X-Auth-Token
状态码 正常 200 异常 返回值 说明 400 Bad Request 请求错误,具体返回错误码请参考错误码。 401 Unauthorized 鉴权失败。 403 Forbidden 没有操作权限。 500 Internal Server Error 服务内部错误。 503 Service
返回结果 状态码 请求发送以后,您会收到响应,包含状态码、响应消息头和消息体。 状态码是一组从1xx到5xx的数字代码,状态码表示了请求响应的状态,完整的状态码列表请参见状态码。 对于NLP服务接口,如果调用后返回状态码为“200”,则表示请求成功。 响应消息头 对应请求消息头,响应同
情况购买资源包,购买后对应区域的资源将自动转为包年包月计费方式。如果超出当前已购买资源包的额度,超出部分将自动转为按需计费。 欠费 按需购买的接口是按照API调用次数阶梯价格计费,当余额不足,无法对当前产生费用进行扣费,就会导致欠费,欠费后有保留期。您续费后可继续正常使用,请注意
如果多个云服务一起搭配使用,需要注意: 不同区域的弹性云服务器、关系型数据库、对象存储服务内网不互通。 不同区域的弹性云服务器不支持跨区域部署在同一负载均衡器下。 资源的价格 不同区域的资源价格可能有差异,请参见华为云服务价格详情。 如何选择可用区? 是否将资源放在同一可用区内,主要取决于您对容灾能力和网络时延的要求。
how, where PU 标点符号 , . : 请求示例 请求示例(开启词性标注功能进行分词,支持PKU分词规范) “endpoint”、“project_id”、“token”等请求参数获取方式可参考快速入门,参数详情请见构造请求。 Request Header: Content-Type:
有哪些途径可以使用自然语言处理的API? 共有三种方式可以基于已构建好的请求消息发起请求。 cURL cURL是一个命令行工具,用来执行各种URL操作和信息传输。cURL充当的是HTTP客户端,可以发送HTTP请求给服务端,并接收响应消息。cURL适用于接口调试。关于cURL详细信息请参见https://curl
0301 query param error 请求参数异常。 检查请求参数字段名,修改正确后重新尝试。 400 NLP.0303 request method not support http请求方式不支持。 检查请求方式,修改正确后重新尝试。 400 NLP.0304 http
取Token方式,请参考获取用户Token。 获取用户Token接口请求构造如下,您可以从接口的请求部分看到所需的请求参数及参数说明。获取Token消息头只需填写“Content-Type”,将消息体加入后的请求如下所示。 加粗的斜体字段需要根据实际值填写,其中username为
项目ID。获取方法请参见获取项目ID。 请求消息 请求参数如表2所示。 表2 请求参数 名称 是否必选 参数类型 说明 content 是 String 请求文本,用于检查指定实体(entity)在该请求文本中的正负面分析。 仅支持中文,文本编码要求为utf-8。请求文本内容不能为空,且请求文本与请求实体的长度
参数说明 表1 URI参数说明 参数名 必选 说明 project_id 是 项目ID。获取方法请参见获取项目ID。 请求消息 请求参数如表2所示。 表2 请求参数 参数名 参数类型 必选 说明 content String 是 待分析文本。文本编码要求为utf-8。 限定180
要计费信息。 计费模式 NLP提供免费试用、折扣套餐包和按需计费三种计费方式,以满足不同场景下的用户需求。 免费试用只支持部分API,需要购买免费试用套餐包后才能使用。 折扣套餐包是一种预付费模式,即先付费再使用,从购买之日起生效,有效期1年,到期自动结束。 按需计费是一种后付费
计费模式概述 自然语言处理NLP提供免费试用、按需计费和折扣套餐包三种计费模式,以满足不同场景下的用户需求。 免费试用:部分API支持首次免费试用,需要购买免费试用套餐包后使用。免费试用套餐包只允许每个用户免费购买一次,一经退订无法再购买,但可以以原价续费。 折扣套餐包:一种预付费模式
Token鉴权时,可以先缓存起来,避免频繁调用。 如果返回错误码,例如401,表示认证失败,请确认Request Body中请求参数填写正确后重新发送请求。 如果您的调试结果异常,提示“Header Overflow”,可以参考故障处理解决Header溢出问题。 故障处理 目前发现v7
调用说明 自然语言处理服务提供了REST(Representational State Transfer)风格API,支持您通过HTTPS请求调用,调用方法请参见如何调用API。 父主题: 使用前必读
参数说明 表1 URI参数说明 参数名 必选 说明 project_id 是 项目ID。获取方法请参见获取项目ID。 请求消息 请求参数如表2所示。 表2 请求参数 参数名 参数类型 必选 说明 content String 是 待分析文本,UTF-8编码,限定400个字符以内,
参数说明 表1 URI参数说明 参数名 必选 说明 project_id 是 项目ID。获取方法请参见获取项目ID。 请求消息 请求参数如表2所示。 表2 请求参数 参数名 参数类型 必选 说明 content String 是 待分析文本。文本编码要求为utf-8,目前仅支持中文。
获取账号ID 在调用接口的时候,部分URL中需要填入账号ID(domain-id),所以需要先在管理控制台上获取到账号ID。账号ID获取步骤如下: 登录NLP控制台。 单击用户名,在下拉列表中单击“我的凭证”。 在“我的凭证”页面的项目列表中查看账号ID。 图1 查看账号ID 父主题:
参数说明 表1 URI参数说明 名称 是否必选 说明 project_id 是 项目ID。获取方法请参见获取项目ID。 请求消息 请求参数如表2所示。 表2 请求参数 名称 是否必选 参数类型 说明 content 是 String 待分析文本。仅支持中文,文本编码要求为utf-8。