检测到您已登录华为云国际站账号,为了您更好的体验,建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
数据结构 公共请求参数 公共响应参数
公共响应参数 表1 公共响应消息头 参数名 说明 Content-Length 响应消息体的字节长度,单位为Byte。 Date 系统响应的时间。 Content-type 发送的实体的MIME类型。 父主题: 数据结构
API 自然语言处理基础服务接口说明 语言生成服务接口说明 语言理解服务接口说明 机器翻译服务接口说明
命名实体识别(领域版) 4.3.4-意图理解(废弃) 删除 实体链接 2019-07-08 新增机器翻译内容: 使用前必读 API概览 机器翻译服务接口说明 错误码 2019-06-28 刷新错误码。 2019-03-22 增加接口: 文本相似度(基础版) 句向量 老接口修改为废弃接口。
对于折扣套餐包计费模式的资源,例如基础套餐包和领域套餐包,用户在购买时会一次性付费,服务将在到期后自动转为按需计费。 如果在计费周期内不再使用折扣套餐包资源,您可以执行退订操作,系统将根据资源是否属于五天无理由退订、是否使用代金券和折扣券等条件返还一定金额到您的账户。详细的退订规则请参见云服务退订规则概览。
如何使自然语言处理停止计费? 自然语言处理服务是按接口调用来收费,计费模式分为按需计费和折扣套餐包计费,详情请见计费说明。 如果您不进行接口调用,不会产生额外的费用,无需停止计费。
统计API使用量 自然语言处理NLP控制台“服务监控”页面,支持查看API的总调用量、调用成功量、调用失败量。 如果您购买了套餐包,可在“套餐包管理”页面,查看已有的套餐包及使用详情。套餐包费用扣减规则请参见计费说明。 图1 服务监控
调用自然语言处理的API失败时怎么处理? 解决方案 根据API调用返回结果或者错误码查找原因,错误码详情请见错误码。 检查Token是否填写正确或者已过期,详情请见Token认证。 检查API调用方法是否正确,可参考快速入门。 如果无法确定原因和解决问题,请联系技术服务人员。
com,请保证使用SDK的环境放通访问域名的访问限制。 在线生成SDK代码 API Explorer能根据需要动态生成SDK代码功能,降低您使用SDK的难度,推荐使用。 SDK列表 表1提供了NLP服务支持的SDK列表,您可以在GitHub仓库查看SDK更新历史、获取安装包以及查看指导文档。
调用接口出错后,将不会返回结果数据。调用方可根据每个接口对应的错误码来定位错误原因。当调用出错时,HTTPS请求返回一个4xx或5xx的HTTPS状态码。返回的消息体中是具体的错误代码及错误信息。 错误响应Body体格式说明 当接口调用出错时,会返回错误码及错误信息说明,错误响应的Body体格式如下所示。 {
自然语言处理是否支持离线使用? 暂不支持离线使用,调用SDK必须能够访问外网才可以的,因为自然语言处理接口部署在华为云云端,所以需要您的网络可以访问外网才可以调用服务接口。 调用自然语言处理SDK请参见SDK参考。调用自然语言处理API接口请参见API参考。
选择支付方式,并支付。 服务开通后,您可以按照官方文档调用API或SDK步骤继续完成实际服务需求。 此时的计费方式采用套餐包计费,购买的套餐包在生效期内,扣费方式是先扣除已购买的套餐包内的额度后,超出部分以按需计费的方式进行结算。 购买套餐包后只有调用成功才会计算调用次数,其中返回的2xx状态
、被注销等异常状态。 已开通自然语言处理服务。 操作步骤 登录API Explorer。 登录后,“X-Auth-Token”和“project_id”参数会自动填充,无需填写。 确保“Region”和开通服务时的区域保持一致。例如开通服务时所在区域为“华北-北京四”,“Region”需设置为“华北-北京四”。
获取分词SDK示例代码。 登录API Explorer,在“代码示例”中选择“Python”。 图1 代码示例 填写待分词的文本数据。 复制代码示例至PyCharm中。 获取AK/SK,替换代码示例中的“<YOUR AK>”、“<YOUR SK>”参数。 登录访问密钥页面,新增访问密钥,或使用已有的访
业及开发者提供的用于文本分析及挖掘的云服务,通过开放API的方式提供给用户使用,旨在帮助用户高效的处理文本。 SDK概述 自然语言处理软件开发工具包(Natural Language Processing Development Kit)是对自然语言处理服务提供的REST API
提供快速准确的翻译服务,帮助用户跨语言沟通,可用于文档翻译等场景中。 优势 功能全面 提供多种常用自然语言类的算法模型及解决方案,可覆盖不同行业的各类需求。 高效准确 可快速分析大数据量的文本,深度理解文本语义,更加准确的挖掘出文本中的关键信息。 简单易用 简单易用的API接口。
自然语言处理基础版和领域版的区别 自然语言处理基础版接口和领域版接口基于不同算法实现,对相同文本,基础版和领域版的结果有所差别。根据测试数据,领域版效果一般优于基础版。 自然语言处理基础版接口和领域版接口所支持的计费模式也有所区别,详情请见计费说明。 表1 区分基础版和领域版的接口 接口类型
{Endpoint}为IAM的终端节点,可以从地区和终端节点获取。接口的认证鉴权请参见认证鉴权。 响应示例如下,例如,自然语言处理服务部署的区域为“cn-north-4”,响应消息体中查找“name”为“cn-north-4”,其中projects下的“id”即为项目ID。 {
支持变更为按需计费或折扣套餐包计费模式。 - 支持变更为折扣套餐包计费模式。 适用场景 适用于想了解NLP服务且初次体验的使用者。 适用于可预估资源使用周期的场景,价格比按需计费模式更优惠。对于长期使用者,推荐该方式。 适用于计算资源需求波动的场景,可以随时开通。 父主题: 计费模式
公共请求参数 表1 公共请求消息头 参数名 说明 必选 示例 Content-type 发送的实体的MIME类型。 是 application/json Content-Length 请求body长度,单位为Byte。 POST/PUT请求为可选, GET不包含。 3495 X-Auth-Token