检测到您已登录华为云国际站账号,为了您更好的体验,建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
公共响应参数 表1 公共响应消息头 参数名 说明 Content-Length 响应消息体的字节长度,单位为Byte。 Date 系统响应的时间。 Content-type 发送的实体的MIME类型。 父主题: 数据结构
如果返回错误码,例如401,表示认证失败,请确认Request Body中请求参数填写正确后重新发送请求。
调用API接口需要具备一定的编程开发能力,调用NLP服务后返回的结果为JSON格式,用户需要通过编程来处理识别结果。 您可以根据以下两种方式的介绍选择合适的使用方式: 通过可视化工具(如curl、Postman)发送请求调用NLP服务API。
公共请求参数 表1 公共请求消息头 参数名 说明 必选 示例 Content-type 发送的实体的MIME类型。 是 application/json Content-Length 请求body长度,单位为Byte。 POST/PUT请求为可选, GET不包含。
共有三种方式可以基于已构建好的请求消息发起请求。 cURL cURL是一个命令行工具,用来执行各种URL操作和信息传输。cURL充当的是HTTP客户端,可以发送HTTP请求给服务端,并接收响应消息。cURL适用于接口调试。
目前自然语言处理基础、语言生成、语言理解和机器翻译服务的API均支持“华北-北京四”区域。 图1 IAM区域与终端节点 访问网址:获取用户Token,获取API接口的URI。
如果您开启了登录保护并设置登录保护为MFA验证,请参考获取IAM用户Token(使用密码+虚拟MFA)获取IAM用户Token。
API同时支持使用AK/SK认证,AK/SK认证是使用SDK对请求进行签名,签名过程会自动往请求中添加Authorization(签名认证信息)和X-Sdk-Date(请求发送的时间)请求头。 AK/SK认证的详细说明请参见AK/SK认证。
开通服务操作 进入自然语言处理基础官网,单击“立即使用”,进入自然语言处理控制台。 在“总览”页面,选择需要使用的服务,在操作列单击“开通服务”。 图1 开通服务 在弹框中单击“确定”,确认开通服务。 服务开通成功后,开通状态将显示为“已开通”。 NLP服务开通后,暂不支持关闭。
您可以在管理控制台选择页面上方的“费用 > 费用账单”,进入费用中心后,在“总览”页面设置“可用额度预警”功能,当可用额度低于预警阈值时,系统自动发送短信和邮件提醒。 当产生欠费后,请您及时充值使可用额度大于0。
图1 套餐包自然语言处理API资源生命周期 到期预警 套餐包自然语言处理API资源在到期前第7天内,系统将向用户推送到期预警消息。预警消息将通过邮件、短信和站内信的方式通知到华为云账号的创建者。
服务开通成功后,开通状态显示“已开通”。 图1 开通服务 NLP服务开通后,暂不支持关闭。开通服务时,计费规则默认为“按需计费”,按需计费时,不使用NLP服务,则不收费。如果您购买了套餐包,套餐包扣减规则请参见价格计算器计费详情页。
返回结果 状态码 请求发送以后,您会收到响应,包含状态码、响应消息头和消息体。 状态码是一组从1xx到5xx的数字代码,状态码表示了请求响应的状态,完整的状态码列表请参见状态码。 对于NLP服务接口,如果调用后返回状态码为“200”,则表示请求成功。
图3 Token认证 单击右上角“Send”,发送“POST https://iam.cn-north-4.myhuaweicloud.com/v3/auth/tokens”获取返回结果Headers中的token值(Token有效期为24小时)。
当您的账户被扣为负值时,我们将通过邮件、短信和站内信的方式通知到华为云账号的创建者。 欠费后影响 当您的账号因按需NLP的API资源自动扣费导致欠费后,账号将变成欠费状态。欠费后,按需资源不会立即停止服务,资源进入宽限期。
语言理解服务接口说明 情感分析(基础版) 情感分析(领域版) 文本分类 属性级情感分析(领域版) 属性级情感分析(高级版) 实体级情感分析 意图理解 文档分类 父主题: API
如何开通自然语言服务? 目前自然语言服务所有接口均已商用。首次使用自然语言处理服务,需要开通服务,然后通过API的方式使用自然语言处理服务。 开通服务操作 进入自然语言处理基础官网,单击“立即使用”,进入自然语言处理控制台。
API方式 如果用户需要将公有云平台上的自然语言处理服务集成到第三方系统,用于二次开发,请使用API方式访问自然语言处理服务,具体操作请参见《自然语言处理服务接口参考》。 管理控制台方式 其他相关操作,请使用管理控制台方式访问自然语言处理服务。
与其他服务之间的关系 介绍了自然语言处理与其他服务的关系。 图1 自然语言处理服务与其他服务关系示意图 统一身份认证服务 统一身份认证服务(Identity and Access Management,简称IAM),自然语言处理使用统一身份认证服务(IAM)进行鉴权。
例如企业需要创建一个NLP服务的按需成本预算,每月预算金额为2000元,当预测金额高于预算金额的80%时发送预算告警。