检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
用户直接调用自然语言处理SDK提供的接口函数即可实现使用自然语言处理业务能力的目的。目前自然语言处理的SDK支持JAVA和Python版本，其他语言可通过REST API方式调用对应服务。
本地调用API 本章节以分词为例，介绍如何使用NLP Python SDK在本地进行开发。 该接口可以对文本进行分词处理，并将识别结果以JSON格式返回给用户。 前提条件 已注册华为账号并开通华为云，并完成实名认证，账号不能处于欠费、冻结、被注销等异常状态。 已开通服务。 操作步骤
X-Language 请求语言类型。 否，默认为zh-cn。 en-us 其它header属性，请遵照https协议。 父主题： 数据结构
欠费说明 用户在使用NLP时，账户的可用额度小于待结算的账单，即被判定为账户欠费。欠费后，可能会影响NLP资源的正常调用，请及时充值。 欠费原因 已购买资源包，但使用量超出资源包额度，进而产生按需费用，同时账户中的余额不足以抵扣产生的按需费用。 未购买资源包，在按需计费模式下账户的余额不足
操作步骤 进入自然语言处理NLP主页，单击“立即使用”。 进入自然语言处理控制台。 在自然语言处理控制台“总览”页面，选择需要使用的服务，在操作列单击“开通服务”。 在弹出的对话框中单击“确定”。 服务开通成功后，开通状态显示“已开通”。
停止计费 折扣套餐包资源 对于折扣套餐包计费模式的资源，例如基础套餐包和领域套餐包，用户在购买时会一次性付费，服务将在到期后自动转为按需计费。 如果在计费周期内不再使用折扣套餐包资源，您可以执行退订操作，系统将根据资源是否属于五天无理由退订、是否使用代金券和折扣券等条件返还一定金额到您的账户
翻译 通过文本语言分析，准确翻译语句内容，从而帮助用户跨语言沟通。
以上价格仅供参考，实际计算请以自然语言处理价格详情中的价格为准。
调用说明 自然语言处理服务提供了REST（Representational State Transfer）风格API，支持您通过HTTPS请求调用，调用方法请参见如何调用API。 父主题： 使用前必读
为什么报APIG.0101？ 问题描述 用户在调用语义理解api时，为什么报“The API does not exist or has not been published in the environment“错误？ 接口调用地址url: https://nlp-ext.cn-north
计费模式 计费模式概述 折扣套餐包 按需计费
使用前必读 概述 调用说明 终端节点 约束与限制 基本概念
统计API使用量 自然语言处理NLP控制台“服务监控”页面，支持查看API的总调用量、调用成功量、调用失败量。 如果您购买了套餐包，可在“套餐包管理”页面，查看已有的套餐包及使用详情。套餐包费用扣减规则请参见计费说明。 图1 服务监控
调用API API Explore在线调试 本地调用API
数据结构 公共请求参数 公共响应参数
状态码 正常 200 异常 返回值 说明 400 Bad Request 请求错误，具体返回错误码请参考错误码。 401 Unauthorized 鉴权失败。 403 Forbidden 没有操作权限。 500 Internal Server Error 服务内部错误。 503 Service
修订记录 发布日期 修改说明 2024-01-17 修改示例代码 2021-02-26 删除 文本生成 2021-01-30 修改 文本翻译 2020-08-03 新增 事件抽取 2020-07-06 修改 命名实体识别（领域版） 2019-12-13 新增 诗歌生成 4.2.4-
与其他服务之间的关系 介绍了自然语言处理与其他服务的关系。 图1 自然语言处理服务与其他服务关系示意图 统一身份认证服务 统一身份认证服务（Identity and Access Management，简称IAM），自然语言处理使用统一身份认证服务（IAM）进行鉴权。
目前自然语言处理基础、语言生成、语言理解和机器翻译服务的API均支持“华北-北京四”区域。 图1 IAM区域与终端节点 访问网址：获取用户Token，获取API接口的URI。
考虑到数据的安全，自然语言处理服务无法直接获取到用户数据，需要用户开启公共读授权。 开启公共读授权 开启公共授权，则数据全网可见，所有用户均可访问。一般私密数据不建议用此方法，数据隐私及过期时间请客户自行保证。 配置公共读可参考配置标准桶策略，将桶策略设置为“公共读”。
长按/截图保存，微信识别二维码
或者关注公众号“华为云”
