检测到您已登录华为云国际站账号,为了您更好的体验,建议您访问国际站服务网站 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
有哪些途径可以使用自然语言处理的API? 共有三种方式可以基于已构建好的请求消息发起请求。 cURL cURL是一个命令行工具,用来执行各种URL操作和信息传输。cURL充当的是HTTP客户端,可以发送HTTP请求给服务端,并接收响应消息。cURL适用于接口调试。关于cURL详细信息请参见https://curl
返回结果 状态码 请求发送以后,您会收到响应,包含状态码、响应消息头和消息体。 状态码是一组从1xx到5xx的数字代码,状态码表示了请求响应的状态,完整的状态码列表请参见状态码。 对于NLP服务接口,如果调用后返回状态码为“200”,则表示请求成功。 响应消息头 对应请求消息头,响应同
quest Body中请求参数填写正确后重新发送请求。 如果您的调试结果异常,提示“Header Overflow”,可以参考故障处理解决Header溢出问题。 故障处理 目前发现v7.25.0、v7.26.0及以上版本Postman由于配置问题,无法正常获取用户Token,会有Header
调用说明 自然语言处理服务提供了REST(Representational State Transfer)风格API,支持您通过HTTPS请求调用,调用方法请参见如何调用API。 父主题: 使用前必读
终端节点 终端节点即调用API的请求地址,不同服务不同区域的终端节点不同,您可以从地区和终端节点中查询所有服务的终端节点。 目前自然语言处理基础、语言生成、语言理解和机器翻译服务支持以下地区和终端节点: 表1 自然语言处理基础、语言生成、语言理解和机器翻译服务 区域名称 区域 终端节点(Endpoint)
取Token方式,请参考获取用户Token。 获取用户Token接口请求构造如下,您可以从接口的请求部分看到所需的请求参数及参数说明。获取Token消息头只需填写“Content-Type”,将消息体加入后的请求如下所示。 加粗的斜体字段需要根据实际值填写,其中username为
如何访问自然语言处理服务 公有云提供了Web化的服务管理平台,即管理控制台和基于HTTPS请求的API(Application programming interface)管理方式。 API方式 如果用户需要将公有云平台上的自然语言处理服务集成到第三方系统,用于二次开发,请使用A
NLP.0301 query param error 请求参数异常。 检查请求参数字段名,修改正确后重新尝试。 400 NLP.0303 request method not support http请求方式不支持。 检查请求方式,修改正确后重新尝试。 400 NLP.0304 http
欠费说明 用户在使用NLP时,账户的可用额度小于待结算的账单,即被判定为账户欠费。欠费后,可能会影响NLP资源的正常调用,请及时充值。 欠费原因 已购买资源包,但使用量超出资源包额度,进而产生按需费用,同时账户中的余额不足以抵扣产生的按需费用。 未购买资源包,在按需计费模式下账户的余额不足。
续费概述 自然语言处理套餐包到期后不会影响API的正常调用,但会自动转为按需计费。如果想继续使用折扣套餐包的资源,需要在指定的时间内为API套餐包续费。 续费操作仅适用于折扣套餐包资源,按需计费API资源不需要续费,只需要保证账户余额充足即可。 NLP资源在到期前续费成功,所有资
项目ID。获取方法请参见获取项目ID。 请求消息 请求参数如表2所示。 表2 请求参数 名称 是否必选 参数类型 说明 content 是 String 请求文本,用于检查指定实体(entity)在该请求文本中的正负面分析。 仅支持中文,文本编码要求为utf-8。请求文本内容不能为空,且请求文本与请求实体的长度
效。 Body 通过切换输入方式可以选择表单填写或文本输入请求体。 表单填写:通过表单填写完成请求体,无需了解JSON语法,参考示例填写参数值。 文本输入:通过文本输入完成请求体,可以直接在编辑框内编写JSON格式的请求体。 { "auth": { "identity":
参数说明 表1 URI参数说明 参数名 必选 说明 project_id 是 项目ID。获取方法请参见获取项目ID。 请求消息 请求参数如表 请求参数所示。 表2 请求参数 参数名 参数类型 必选 说明 text String 是 待分析文本,长度为1~64,文本编码为UTF-8。 lang
参数说明 表1 URI参数说明 名称 是否必选 说明 project_id 是 项目ID。获取方法请参见获取项目ID。 请求消息 请求参数如下所示。 表2 请求参数 名称 是否必选 参数类型 说明 type 是 Integer 诗歌类型,取值如下: 0:五言绝句 1:七言绝句 2:五言律诗
项目ID。获取方法请参见获取项目ID。 请求消息 请求参数如表 请求参数所示。 表2 请求参数 参数名 参数类型 必选 说明 text String 是 待分析文本,长度为1~512,文本编码为UTF-8。 limit integer 否 返回关键词的最大数量,默认为5。 如果请求文本的词汇数量小于该值,则返回实际词汇数量。
参数说明 表1 URI参数说明 参数名 必选 说明 project_id 是 项目ID。获取方法请参见获取项目ID。 请求消息 请求参数如表2所示。 表2 请求参数 参数名 参数类型 必选 说明 text1 String 是 待计算文本1,长度1~64,文本编码为UTF-8。 text2
参数说明 表1 URI参数说明 参数名 必选 说明 project_id 是 项目ID。获取方法请参见获取项目ID。 请求消息 请求参数如表2所示。 表2 请求参数 参数名 参数类型 必选 说明 content String 是 待分析文本。文本编码要求为utf-8。 限定180