# 自然语言处理 NLP

> 用于处理文本、文本分析及挖掘的云服务

## 产品介绍

- [什么是自然语言处理](https://support.huaweicloud.com/productdesc-nlp/nlp_04_0001.md): 自然语言处理（Natural Language Processing，简称NLP）是一款基于人工智能技术，针对各类企业及开发者提供的用于文本分析及挖掘的云服务，旨在帮助用户高效地处理文本，常用于翻译等场景。用户需要具备编程能力，熟悉Java、Python编程语言。NLP服务需要用户通过调用API接口，将需要文件识别成可编辑的文本，然后返回
- [功能介绍](https://support.huaweicloud.com/productdesc-nlp/nlp_04_0016.md): 自然语言处理包含如下子服务。机器翻译（Machine Translation，简称MT），为用户提供快速准确的翻译服务，帮助用户跨语言沟通，可用于文档翻译等场景中。机器翻译（Machine Translation，简称MT），为用户提供快速准确的翻译服务，帮助用户跨语言沟通，可用于文档翻译等场景中。优势功能全面提供多种常用自然语言类的算法
- [应用场景](https://support.huaweicloud.com/productdesc-nlp/nlp_04_0002.md): 自然语言处理适用于翻译等场景。翻译通过文本语言分析，准确翻译语句内容，从而帮助用户跨语言沟通。通过文本语言分析，准确翻译语句内容，从而帮助用户跨语言沟通。
- [机器翻译](https://support.huaweicloud.com/productdesc-nlp/nlp_04_0011.md): 语种识别是为了识别文本所属的语种。对于用户输入的文本，返回识别出的所属语种。
- [计费说明](https://support.huaweicloud.com/productdesc-nlp/nlp_04_0015.md): 自然语言处理接口调用次数：调用自然语言处理的接口收费，提供按调用次数按需计费的方式。免费试用部分API支持首次免费试用，需要购买免费试用套餐包后使用。免费试用套餐包只允许每个用户免费购买一次，一经退订无法再购买，可以以原价续费。部分API支持首次免费试用，需要购买免费试用套餐包后使用。免费试用套餐包只允许每个用户免费购买一次，一经退订无法
- [与其他服务之间的关系](https://support.huaweicloud.com/productdesc-nlp/nlp_04_0007.md): 介绍了自然语言处理与其他服务的关系。统一身份认证服务（Identity and Access Management，简称IAM），自然语言处理使用统一身份认证服务（IAM）进行鉴权。IAM更多信息请参见统一身份认证服务IAM。云监控（Cloud Eye）可以监控自然语言处理的相关指标，具体如表1所示。用户可以通过指标及时了解自然语言处理的
- [约束与限制](https://support.huaweicloud.com/productdesc-nlp/nlp_04_0008.md): 自然语言处理目前支持的区域为“华北-北京一”和“华北-北京四”，其中机器翻译不支持“华北-北京一”区域。
- [如何访问自然语言处理服务](https://support.huaweicloud.com/productdesc-nlp/nlp_04_0009.md): 公有云提供了Web化的服务管理平台，即管理控制台和基于HTTPS请求的API（Application programming interface）管理方式。API方式如果用户需要将公有云平台上的自然语言处理服务集成到第三方系统，用于二次开发，请使用API方式访问自然语言处理服务，具体操作请参见《自然语言处理服务接口参考》。如果用户需要将公
- [自然语言处理的监控指标](https://support.huaweicloud.com/productdesc-nlp/nlp_04_0012.md): 本节定义了自然语言处理服务上报云监控服务的监控指标的命名空间，监控指标列表和维度定义，用户可以通过云监控服务提供管理控制台或API接口来检索自然语言处理服务产生的监控指标和告警信息。SYS.NLP
- [查看监控指标](https://support.huaweicloud.com/productdesc-nlp/nlp_04_0013.md): 登录管理控制台。选择管理与部署 > 云监控服务。展开左侧导航树的“云服务监控”，单击待查看的云服务。单击操作列查看监控指标，进入指标监控页面。在监控区域，您可以通过选择时长，查看对应时间的监控数据。当前支持查看云服务“近1小时”、“近3小时”、“近12小时”的监控数据。当前支持查看云服务“近1小时”、“近3小时”、“近12小时”的监控数据

## 快速入门

- [NLP服务使用简介](https://support.huaweicloud.com/qs-nlp/nlp_08_0001.md): NLP服务以开放API（Application Programming Interface，应用程序编程接口）的方式提供自然语言处理能力，用于文本分析及挖掘，常用于智能问答系统、文本分析、内容推荐、翻译等场景。调用API接口需要具备一定的编程开发能力，调用NLP服务后返回的结果为JSON格式，用户需要通过编程来处理识别结果。您可以根据以下
- [如何使用Postman调用华为云NLP服务](https://support.huaweicloud.com/qs-nlp/nlp_08_0003.md): 华为云NLP以开放API（Application Programming Interface，应用程序编程接口）的方式提供自然语言处理能力，支持使用Postman方式调用华为云NLP服务。本章节提供了通过Postman调用分词API的样例，详细介绍如何调用分词API接口，帮助您快速熟悉自然语言处理服务的使用方法。同时也提供视频帮助指导您端
- [如何使用SDK调用华为云NLP服务](https://support.huaweicloud.com/qs-nlp/nlp_08_0002.md): 自然语言处理服务软件开发工具包（NLP SDK）是对自然语言处理服务提供的REST API进行的封装，用户直接调用自然语言处理服务SDK提供的接口函数即可实现使用自然语言处理业务能力的目的，以简化用户的开发工作。NLP SDK目前支持Java和Python。本章节提供了通过Java SDK调用分词服务的样例，向用户介绍如何使用华为云NLP

## 用户指南

- [功能体验与试用](https://support.huaweicloud.com/usermanual-nlp/nlp_01_0001.md): 自然语言处理（Natural Language Processing，简称NLP）是一款基于人工智能技术，针对各类企业及开发者提供的用于文本分析及挖掘的云服务。自然语言处理提供分词、命名实体识别、关键词提取、文本相似度等自然语言相关的API，可用于智能问答、对话机器人、内容推荐、电商评价分析。在开通NLP之前，可进入体验中心体验服务功能。
- [使用流程](https://support.huaweicloud.com/usermanual-nlp/nlp_01_0002.md): 自然语言处理（Natural Language Processing，简称NLP）是一款基于人工智能技术，针对各类企业及开发者提供的用于文本分析及挖掘的云服务，旨在帮助用户高效地处理文本，常用于翻译等场景。NLP服务需要用户通过调用API接口，将需要文件识别成可编辑的文本，然后返回JSON格式的识别结果，用户需要通过编码将识别结果对接到业
- [开通服务](https://support.huaweicloud.com/usermanual-nlp/nlp_01_0003.md): 目前自然语言服务所有接口均已商用。首次使用自然语言处理服务，需要开通服务，然后通过API的方式使用自然语言处理服务。已注册华为账号并开通华为云，并完成实名认证，账号不能处于欠费、冻结、被注销等异常状态。进入自然语言处理基础官网，单击“立即使用”，进入自然语言处理控制台。在“总览”页面，选择需要使用的服务，在操作列单击“开通服务”。开通服务
- [购买套餐包（可选）](https://support.huaweicloud.com/usermanual-nlp/nlp_01_0004.md): 自然语言处理NLP支持按需计费和折扣套餐包计费两种计费模式，详情请见计费说明。折扣套餐包方式是用户可以购买套餐包，扣费时调用次数会先在套餐包内进行抵扣，抵扣完后的剩余调用量默认转回按需计费方式。折扣套餐包方式相对按需付费方式提供了更大的折扣，对于长期使用者，推荐该购买方式。调用自然语言处理API的时间需在套餐包生效期内，该次调用才可在套餐
- [API Explore在线调试](https://support.huaweicloud.com/usermanual-nlp/nlp_01_0006.md): API Explorer在线调试工具提供API的检索、调试、代码示例生成功能。同时，集成开发环境CloudIDE，可完成代码的构建、调试、运行。本章节以分词为例，介绍如何使用API Explorer调试API。已注册华为账号并开通华为云，并完成实名认证，账号不能处于欠费、冻结、被注销等异常状态。已开通自然语言处理服务。登录API Expl
- [本地调用API](https://support.huaweicloud.com/usermanual-nlp/nlp_01_0007.md): 本章节以分词为例，介绍如何使用NLP Python SDK在本地进行开发。该接口可以对文本进行分词处理，并将识别结果以JSON格式返回给用户。已注册华为账号并开通华为云，并完成实名认证，账号不能处于欠费、冻结、被注销等异常状态。已开通服务。获取并安装NLP Python SDK。以PyCharm为例，介绍如何安装SDK。在PyCharm中
- [统计API使用量](https://support.huaweicloud.com/usermanual-nlp/nlp_01_0008.md): 自然语言处理NLP控制台服务监控页面，支持查看API的总调用量、调用成功量、调用失败量。如果您购买了套餐包，可在“套餐包管理”页面，查看已有的套餐包及使用详情。套餐包费用扣减规则请参见计费说明。

## API参考

- [概述](https://support.huaweicloud.com/api-nlp/nlp_03_0030.md): 欢迎使用自然语言处理（Natural Language Processing） ，服务主要包括自然语言处理基础服务、语言生成服务、语言理解服务、机器翻译服务等功能。在调用自然语言处理服务API之前，请确保已经充分了解自然语言处理服务相关概念，详细信息请参见产品介绍。
- [调用说明](https://support.huaweicloud.com/api-nlp/nlp_03_0031.md): 自然语言处理服务提供了REST（Representational State Transfer）风格API。支持您通过HTTPS请求调用，调用方法请参见如何调用API。
- [终端节点](https://support.huaweicloud.com/api-nlp/nlp_03_0032.md): 终端节点即调用API的请求地址，不同服务不同区域的终端节点不同，您可以从地区和终端节点中查询所有服务的终端节点。目前自然语言处理基础、语言生成、语言理解和机器翻译服务支持以下地区和终端节点：
- [约束与限制](https://support.huaweicloud.com/api-nlp/nlp_03_0033.md): 约束与限制如下：更详细的限制请参见具体API的说明和产品介绍约束与限制。
- [基本概念](https://support.huaweicloud.com/api-nlp/nlp_03_0034.md): 账号用户注册华为云时的账号，账号对其所拥有的资源及云服务具有完全的访问权限，可以重置用户密码、分配用户权限等。由于账号是付费主体，为了确保账号安全，建议您不要直接使用账号进行日常管理工作，而是创建用户并使用创建的用户进行日常管理工作。用户注册华为云时的账号，账号对其所拥有的资源及云服务具有完全的访问权限，可以重置用户密码、分配用户权限等。
- [API概览](https://support.huaweicloud.com/api-nlp/nlp_03_0002.md): 自然语言处理提供了如下接口，方便用户对自然语言处理的使用。各类接口的说明如表1所示。
- [申请服务](https://support.huaweicloud.com/api-nlp/nlp_03_0004.md): 已注册华为账号并开通华为云，完成实名认证，且账号不能处于欠费、冻结、被注销等异常状态。进入自然语言处理NLP主页，单击立即使用。进入自然语言处理控制台。进入自然语言处理控制台。在自然语言处理控制台总览页面，选择需要使用的服务，在操作列单击开通服务。在弹出的对话框中单击确定。服务开通成功后，开通状态显示已开通。开通服务NLP服务开通后，暂不
- [构造请求](https://support.huaweicloud.com/api-nlp/nlp_03_0005.md): 本节介绍REST API请求的组成，讲述如何调用API接口。请求示例如下所示，一个请求主要由请求URL、请求方法、请求消息头和请求消息体几部分组成，各个部分将在下文详细解释。请求URI由如下部分组成。{URI-scheme} :// {Endpoint} / {resource-path} ? {query-string}尽管请求URI包
- [认证鉴权](https://support.huaweicloud.com/api-nlp/nlp_03_0050.md): 调用NLP服务接口目前支持Token认证进行认证鉴权。调用接口有如下两种认证方式，您可以选择其中一种进行认证鉴权。Token认证：通过Token认证调用请求。通过终端节点和Token调用API。不支持调用“中东-阿布扎比-OP5”Region的对象存储服务（OBS）、数据接入服务（DIS）、自然语言处理（NLP）、文字识别（OCR）和图像
- [返回结果](https://support.huaweicloud.com/api-nlp/nlp_03_0038.md): 请求发送以后，您会收到响应，包含状态码、响应消息头和消息体。状态码是一组从1xx到5xx的数字代码，状态码表示了请求响应的状态，完整的状态码列表请参见状态码。对于NLP服务接口，如果调用后返回状态码为200，则表示请求成功。对应请求消息头，响应同样也有消息头，如Content-type，x-request-id，NLP服务响应消息头无特殊
- [分词](https://support.huaweicloud.com/api-nlp/nlp_03_0009.md): 对文本进行分词和词性标注处理。具体Endpoint请参见终端节点。调用华为云NLP服务会产生费用，本API支持使用基础套餐包，购买时请在自然语言处理价格计算器中查看基础套餐包和领域套餐包支持的API范围。本API调用限制为20次/秒。您可以在API Explorer中调试该接口。在使用本API之前，需要您完成服务申请和认证鉴权，具体操作流
- [多粒度分词](https://support.huaweicloud.com/api-nlp/nlp_03_0075.md): 给定一个句子输入，输出不同粒度的所有单词的层次结构。以“华为技术有限公司的总部”为例，多粒度分词得到的层次结构如下图所示。其中白色圆形节点为字符单元，蓝色圆角矩阵节点为词汇单元。本API免费调用，调用限制为2次/秒。您可以在API Explorer中调试该接口。在使用本API之前，需要您完成服务申请和认证鉴权，具体操作流程请参见申请服务和
- [依存句法分析](https://support.huaweicloud.com/api-nlp/nlp_03_0059.md): 识别句子中词汇与词汇之间的相互依存关系。本API免费调用，调用限制为2次/秒。您可以在API Explorer中调试该接口。在使用本API之前，需要您完成服务申请和认证鉴权，具体操作流程请参见申请服务和认证鉴权章节。用户首次使用需要先申请开通。服务只需要开通一次即可，后面使用时无需再次申请。如未开通服务，调用服务时会提示ModelArts
- [命名实体识别（基础版）](https://support.huaweicloud.com/api-nlp/nlp_03_0010.md): 对文本进行命名实体识别分析，目前支持人名、地名、时间、组织机构类实体的识别。具体Endpoint请参见终端节点。调用华为云NLP服务会产生费用，本API支持使用基础套餐包，购买时请在自然语言处理价格计算器中查看基础套餐包和领域套餐包支持的API范围。本API调用限制为20次/秒。您可以在API Explorer中调试该接口。在使用本API
- [命名实体识别（领域版）](https://support.huaweicloud.com/api-nlp/nlp_03_0060.md): 对文本进行命名实体识别分析，目前支持通用、商务和娱乐领域。通用领域：支持人名、地名、组织机构、时间点、日期、百分比、货币额度、序数词、计量规格词、民族、职业、邮箱、国家、节日的实体的识别。商务领域：支持公司名、品牌名、职业、职位、邮箱、手机号码、电话号码、IP地址、身份证号、网址、专业的实体的识别。娱乐领域：支持电影名、动漫、书名、互联网
- [文本相似度（基础版）](https://support.huaweicloud.com/api-nlp/nlp_03_0025.md): 对文本进行语义相似度计算。具体Endpoint请参见终端节点。调用华为云NLP服务会产生费用，本API支持使用基础套餐包，购买时请在自然语言处理价格计算器中查看基础套餐包和领域套餐包支持的API范围。也可使用文本相似度（高级版）接口，详情请见文本相似度（高级版）。文本相似度基础版和高级版基于不同算法实现，对相同文本，基础版和高级版的结果有
- [文本相似度（高级版）](https://support.huaweicloud.com/api-nlp/nlp_03_0081.md): 对文本语义相似度计算。具体Endpoint请参见终端节点。本API免费调用，调用限制为2次/秒。文本相似度基础版和高级版基于不同算法实现，对相同文本，基础版和高级版的结果有所差别。根据测试数据，高级版效果一般优于基础版。您可以在API Explorer中调试该接口。在使用本API之前，需要您完成服务申请和认证鉴权，具体操作流程请参见申请服
- [句向量](https://support.huaweicloud.com/api-nlp/nlp_03_0026.md): 输入句子，返回对应的句向量。具体Endpoint请参见终端节点。调用华为云NLP服务会产生费用，本API支持使用基础套餐包，购买时请在自然语言处理价格计算器中查看基础套餐包和领域套餐包支持的API范围。本API调用限制为20次/秒。您可以在API Explorer中调试该接口。在使用本API之前，需要您完成服务申请和认证鉴权，具体操作流程
- [实体链接](https://support.huaweicloud.com/api-nlp/nlp_03_0061.md): 针对通用领域的文本进行实体链接分析，识别出其中的实体，并返回实体相关信息。具体Endpoint请参见终端节点。调用华为云NLP服务会产生费用，本API以定制版API定价按需计费，不支持使用套餐包，使用时请在自然语言处理价格计算器 按需计费-自然语言处理定制版API中查看费用详情。本API调用限制为20次/秒。您可以在API Explore
- [关键词抽取](https://support.huaweicloud.com/api-nlp/nlp_03_0084.md): 根据指定文本，抽取其中最能够反映文本主题或者意思的词汇。具体Endpoint请参见终端节点。调用华为云NLP服务会产生费用，本API支持使用基础套餐包，购买时请在自然语言处理价格计算器中查看基础套餐包和领域套餐包支持的API范围。本API调用限制为20次/秒。您可以在API Explorer中调试该接口。在使用本API之前，需要您完成服务
- [事件抽取](https://support.huaweicloud.com/api-nlp/nlp_03_0086.md): 事件抽取是指从自然语言文本中抽取指定类型的事件以及相关实体信息，并形成结构化数据输出的文本处理技术。目前只支持金融公告中会议召开、聘任、辞职、股票增持、股票减持5类事件以及相关要素的抽取。本API免费调用，调用限制为2次/秒。您可以在API Explorer中调试该接口。在使用本API之前，需要您完成服务申请和认证鉴权，具体操作流程请参见
- [成分句法分析](https://support.huaweicloud.com/api-nlp/nlp_03_0094.md): 识别句子中的成分以及成分之间的层次包含关系。本API免费调用，调用限制为2次/秒。您可以在API Explorer中调试该接口。在使用本API之前，需要您完成服务申请和认证鉴权，具体操作流程请参见申请服务和认证鉴权章节。用户首次使用需要先申请开通。服务只需要开通一次即可，后面使用时无需再次申请。如未开通服务，调用服务时会提示ModelAr
- [文本摘要（基础版）](https://support.huaweicloud.com/api-nlp/nlp_03_0013.md): 对文本生成摘要。文本摘要（基础版）和文本摘要（领域版）基于不同算法实现，对相同文本，基础版和领域版的结果有所差别。根据测试数据，领域版效果一般优于基础版。具体Endpoint请参见终端节点。调用华为云NLP服务会产生费用，本API支持使用基础套餐包，购买时请在自然语言处理价格计算器中查看基础套餐包和领域套餐包支持的API范围。本API调用
- [文本摘要（领域版）](https://support.huaweicloud.com/api-nlp/nlp_03_0071.md): 根据不同领域的语料训练特定领域的摘要模型，能有效提升文本摘要的效果。文本摘要（基础版）和文本摘要（领域版）基于不同算法实现，对相同文本，基础版和领域版的结果有所差别。根据测试数据，领域版效果一般优于基础版。本API免费调用，调用限制为2次/秒。您可以在API Explorer中调试该接口。在使用本API之前，需要您完成服务申请和认证鉴权，
- [诗歌生成](https://support.huaweicloud.com/api-nlp/nlp_03_0070.md): 根据用户的输入生成诗歌。具体Endpoint请参见终端节点。调用华为云NLP服务会产生费用，本API以定制版API定价按需计费，不支持使用套餐包，使用时请在自然语言处理价格计算器 按需计费-自然语言处理定制版API中查看费用详情。本API调用限制为2次/秒。您可以在API Explorer中调试该接口。在使用本API之前，需要您完成服务申
- [情感分析（基础版）](https://support.huaweicloud.com/api-nlp/nlp_03_0015.md): 针对通用领域的用户评论进行情感分析。具体Endpoint请参见终端节点。调用华为云NLP服务会产生费用，本API支持使用基础套餐包，购买时请在自然语言处理价格计算器中查看基础套餐包和领域套餐包支持的API范围。本API调用限制为20次/秒。您可以在API Explorer中调试该接口。在使用本API之前，需要您完成服务申请和认证鉴权，具体
- [情感分析（领域版）](https://support.huaweicloud.com/api-nlp/nlp_03_0056.md): 领域情感分析，针对电商，汽车领域，自适应领域（通用、电商、汽车）的用户评论进行情感分析。具体Endpoint请参见终端节点。调用华为云NLP服务会产生费用，本API支持使用领域套餐包，购买时请在自然语言处理价格计算器中查看基础套餐包和领域套餐包支持的API范围。本API调用限制为20次/秒。您可以在API Explorer中调试该接口。在
- [文本分类](https://support.huaweicloud.com/api-nlp/nlp_03_0017.md): 针对广告领域的自动分类，判断是否是广告。具体Endpoint请参见终端节点。调用华为云NLP服务会产生费用，本API支持使用基础套餐包，购买时请在自然语言处理价格计算器中查看基础套餐包和领域套餐包支持的API范围。使用前请进入NLP服务控制台开通本API。本API调用限制为20次/秒。您可以在API Explorer中调试该接口。在使用本
- [属性级情感分析（领域版）](https://support.huaweicloud.com/api-nlp/nlp_03_0090.md): 属性级情感分析（领域版），本产品适用于评论文本的属性级正负面分析，编码方式UTF-8。建议对数据预处理，对于文本为空的内容进行过滤，文本长度不超过1000字。具体Endpoint请参见终端节点。调用华为云NLP服务会产生费用，本API支持使用领域套餐包，购买时请在自然语言处理价格计算器中查看基础套餐包和领域套餐包支持的API范围。本API
- [属性级情感分析（高级版）](https://support.huaweicloud.com/api-nlp/nlp_03_0091.md): 属性情感分析高级版，本产品适用于评论文本的属性级正负面分析，文本长度不超过4096字，编码方式UTF-8。建议对数据预处理，对于文本为空的内容进行过滤。具体Endpoint请参见终端节点。调用华为云NLP服务会产生费用，本API以定制版API定价按需计费，不支持使用套餐包，使用时请在自然语言处理价格计算器 按需计费-自然语言处理定制版AP
- [实体级情感分析](https://support.huaweicloud.com/api-nlp/nlp_03_0092.md): 实体级情感分析，本接口用于检测指定实体（entity）在文本（content）中的正负面分析，适用于金融方面公司实体正负面新闻的分析。文本与实体长度的和不超过512字，编码方式UTF-8。建议对数据预处理，对于文本或实体为空的内容进行过滤。如果文本或实体为空，接口不支持。本API免费调用，调用限制为2次/秒。您可以在API Explore
- [意图理解](https://support.huaweicloud.com/api-nlp/nlp_03_0062.md): 针对天气类、报时、新闻类、笑话类、翻译类、提醒类、闹钟类、音乐类8个领域进行意图理解。意图理解包括对用户的问题，陈述进行领域识别以及对对应领域所包含的实体进行抽取。具体Endpoint请参见终端节点。调用华为云NLP服务会产生费用，本API支持使用基础套餐包，购买时请在自然语言处理价格计算器中查看基础套餐包和领域套餐包支持的API范围。本
- [文档分类](https://support.huaweicloud.com/api-nlp/nlp_03_0093.md): 文档分类接口对用户输入的文本自动分类，给文本具体的分类。用户只要提供待处理的文本，而不用关注具体实现。主要应用场景：新闻内容分类，广告识别等。具体Endpoint请参见终端节点。调用华为云NLP服务会产生费用，本API支持使用基础套餐包，购买时请在自然语言处理价格计算器中查看基础套餐包和领域套餐包支持的API范围。本API调用限制为20次
- [文本翻译](https://support.huaweicloud.com/api-nlp/nlp_03_0024.md): 文本翻译是为了实现语种间的转换。对于用户输入原始语种的文本，转换为目标语种的文本。本接口不支持对文档进行翻译，文档翻译请见文档翻译任务创建（即将下线）。文本翻译支持一次性提交多个任务，服务会根据资源排队处理。文本翻译接口具体Endpoint请参见终端节点。调用华为云NLP服务会产生费用，本API按字符数阶梯计费，文本翻译不支持套餐包抵扣，
- [语种识别（即将下线）](https://support.huaweicloud.com/api-nlp/nlp_03_0055.md): 语种识别是为了识别文本所属的语种。对于用户输入的文本，返回识别出的所属语种。语种识别接口具体Endpoint请参见终端节点。调用华为云NLP服务会产生费用，本API支持使用基础套餐包，购买时请在自然语言处理价格计算器中查看基础套餐包和领域套餐包支持的API范围。本API调用限制为20次/秒。您可以在API Explorer中调试该接口。在
- [文档翻译任务创建（即将下线）](https://support.huaweicloud.com/api-nlp/nlp_03_0073.md): 由于文档翻译会需要较长的时间，因此翻译是异步的，也即接口分为创建翻译任务和查询任务状态两个接口。创建翻译任务接口创建任务完成后返回，然后用户通过调用查询任务状态接口来获得翻译状态和临时URL。 用户可以使用临时URL下载翻译好的文件，每个临时URL有效期为10分钟。翻译结果会保存24小时（从翻译完成的时间算起）。24小时后如果再访问，将会
- [文档翻译状态查询（即将下线）](https://support.huaweicloud.com/api-nlp/nlp_03_0074.md): 该接口用于获取文档翻译识别状态以及临时url，临时url可以用于获取翻译后的文档，每个临时url有效期为十分钟。本API调用限制为20次/秒。您可以在API Explorer中调试该接口。在使用本API之前，需要您完成服务申请和认证鉴权，具体操作流程请参见申请服务和认证鉴权章节。用户首次使用需要先申请开通。服务只需要开通一次即可，后面使用
- [公共请求参数](https://support.huaweicloud.com/api-nlp/nlp_03_0019.md): 其它header属性，请遵照https协议。
- [公共响应参数](https://support.huaweicloud.com/api-nlp/nlp_03_0020.md): 华为云帮助中心，为用户提供产品简介、价格说明、购买指南、用户指南、API参考、最佳实践、常见问题、视频帮助等技术文档，帮助您快速上手使用华为云服务。
- [状态码](https://support.huaweicloud.com/api-nlp/nlp_03_0022.md): 正常200200异常返回值说明400 Bad Request请求错误，具体返回错误码请参考错误码。401 Unauthorized鉴权失败。403 Forbidden没有操作权限。500 Internal Server Error服务内部错误。503 Service Unavailable服务不可用。
- [错误码](https://support.huaweicloud.com/api-nlp/nlp_03_0021.md): 调用接口出错后，将不会返回结果数据。调用方可根据每个接口对应的错误码来定位错误原因。当调用出错时，HTTPS请求返回一个4xx或5xx的HTTPS状态码。返回的消息体中是具体的错误代码及错误信息。当接口调用出错时，会返回错误码及错误信息说明，错误响应的Body体格式如下所示。其中，error_code表示错误码，error_msg表示错误
- [获取项目ID](https://support.huaweicloud.com/api-nlp/nlp_03_0006.md): 在调用接口的时候，部分URL中需要填入项目ID，所以需要获取到项目ID。项目ID获取步骤如下：登录管理控制台。鼠标移动到右上角已登录的用户名上，在下拉列表中选择我的凭证。在我的凭证页面，可以查看用户名、账号名、项目ID，在项目列表中查看项目。查看项目ID多项目时，展开“所属区域”，从“项目ID”列获取子项目ID。项目编码需与NLP服务终端
- [获取账号ID](https://support.huaweicloud.com/api-nlp/nlp_03_0051.md): 在调用接口的时候，部分URL中需要填入账号ID（domain-id），所以需要先在管理控制台上获取到账号ID。账号ID获取步骤如下：登录NLP控制台。单击用户名，在下拉列表中单击“我的凭证”。在“我的凭证”页面的项目列表中查看账号ID。查看账号ID在“我的凭证”页面的项目列表中查看账号ID。查看账号ID
- [配置OBS访问权限](https://support.huaweicloud.com/api-nlp/nlp_03_0080.md): OBS全称Object Storage Service（对象存储服务），提供海量、安全、高可靠、低成本的数据存储能力，可供用户存储任意类型和大小的数据。EI企业智能服务对于图片、语音等多媒体文件支持直接使用华为云OBS服务的数据处理方式，以减少服务使用成本，降低服务的响应时长，提升服务使用的体验。考虑到数据的安全，自然语言处理服务无法直接

## SDK参考

- [SDK简介](https://support.huaweicloud.com/sdkreference-nlp/nlp_06_0001.md): 自然语言处理（Natural Language Processing，简称NLP）是一款基于人工智能技术、针对各类企业及开发者提供的用于文本分析及挖掘的云服务，通过开放API的方式提供给用户使用，旨在帮助用户高效的处理文本。自然语言处理软件开发工具包（Natural Language Processing Development Kit）
- [获取SDK](https://support.huaweicloud.com/sdkreference-nlp/nlp_06_0064.md): 本文介绍了NLP服务提供的SDK语言版本，列举了最新版本SDK的获取地址。使用SDK需要访问域名https://iam.cn-north-4.myhuaweicloud.com和https://nlp-ext.cn-north-4.myhuaweicloud.com，请保证使用SDK的环境放通访问域名的访问限制。API Explorer能
- [修订记录](https://support.huaweicloud.com/sdkreference-nlp/nlp_06_0030.md): 华为云帮助中心，为用户提供产品简介、价格说明、购买指南、用户指南、API参考、最佳实践、常见问题、视频帮助等技术文档，帮助您快速上手使用华为云服务。

## 常见问题

- [如何通过API Explorer获取用户Token](https://support.huaweicloud.com/nlp_faq/iam_01_0034.md): API Explorer是华为云为开发者提供的一站式API解决方案的统一平台，集成华为云服务开放API，支持全量快速检索、可视化调试、帮助文档，帮助开发者快速查找、学习API和定位修复错误。Token是用户的访问令牌，承载了用户的身份、权限等信息，用户调用API接口时，需要使用Token进行鉴权。本章节指导用户如何通过API Explor
- [如何通过Postman获取用户Token](https://support.huaweicloud.com/nlp_faq/iam_01_034.md): Postman是网页调试与辅助接口调用的工具，具有界面简洁清晰、操作方便快捷的特性，可以处理用户发送的HTTP请求，例如：GET，PUT、POST，DELETE等，支持用户修改HTTP请求中的参数并返回响应数据。Token是用户的访问令牌，承载了用户的身份、权限等信息，用户调用API接口时，需要使用Token进行鉴权。本章节指导用户如何通
- [调用自然语言处理的API失败时怎么处理？](https://support.huaweicloud.com/nlp_faq/nlp_02_0001.md): 根据API调用返回结果或者错误码查找原因，错误码详情请见错误码。检查Token是否填写正确或者已过期，详情请见Token认证。检查API调用方法是否正确，可参考快速入门。如果无法确定原因和解决问题，请联系技术服务人员。
- [有哪些途径可以使用自然语言处理的API？](https://support.huaweicloud.com/nlp_faq/nlp_02_0002.md): 共有三种方式可以基于已构建好的请求消息发起请求。cURLcURL是一个命令行工具，用来执行各种URL操作和信息传输。cURL充当的是HTTP客户端，可以发送HTTP请求给服务端，并接收响应消息。cURL适用于接口调试。关于cURL详细信息请参见https://curl.haxx.se/。编码通过编码调用接口，组装请求消息，并发送处理请求消
- [如何开通自然语言服务？](https://support.huaweicloud.com/nlp_faq/nlp_02_0003.md): 目前自然语言服务所有接口均已商用。首次使用自然语言处理服务，需要开通服务，然后通过API的方式使用自然语言处理服务。进入自然语言处理基础官网，单击“立即使用”，进入自然语言处理控制台。在“总览”页面，选择需要使用的服务，在操作列单击“开通服务”。如果操作列无开通服务选项，请使用华为云账号，即当前IAM账号的主账号登录自然语言处理控制台。开
- [自然语言处理是否支持私有化部署？](https://support.huaweicloud.com/nlp_faq/nlp_02_0007.md): 目前自然语言处理服务暂不支持私有化部署。
- [自然语言处理是否支持离线使用？](https://support.huaweicloud.com/nlp_faq/nlp_02_0008.md): 暂不支持离线使用，调用SDK必须能够访问外网才可以的，因为自然语言处理接口部署在华为云云端，所以需要您的网络可以访问外网才可以调用服务接口。调用自然语言处理SDK请参见SDK参考。调用自然语言处理API接口请参见API参考。
- [自然语言处理服务有哪些调用限制？](https://support.huaweicloud.com/nlp_faq/nlp_02_0009.md): 各API所需资源不同，因此对应的限制不同，具体参看下表：
- [自然语言处理基础版和领域版的区别](https://support.huaweicloud.com/nlp_faq/nlp_02_0010.md): 自然语言处理基础版接口和领域版接口基于不同算法实现，对相同文本，基础版和领域版的结果有所差别。根据测试数据，领域版效果一般优于基础版。自然语言处理基础版接口和领域版接口所支持的计费模式也有所区别，详情请见计费说明。
- [Token消息体中user name，domain name和project name分别指的是什么？](https://support.huaweicloud.com/nlp_faq/nlp_02_0005.md): user name指IAM用户名称。domain name指用户所属的账号名称。如果使用账号获取token，账号的user name和domain name相同。如果使用IAM用户获取token（账号可以创建多个IAM用户），user name和domain name不相同，user name为实际的用户名称。project name指项
- [区域与可用区域](https://support.huaweicloud.com/nlp_faq/nlp_02_0004.md): 使用区域和可用区来描述数据中心的位置，您可以在特定的区域、可用区创建资源。区域（Region）：从地理位置和网络时延维度划分，同一个Region内共享弹性计算、块存储、对象存储、VPC网络、弹性公网IP、镜像等公共服务。Region分为通用Region和专属Region，通用Region指面向公共租户提供通用云服务的Region；专属Re
- [自然语言处理服务需要开通什么权限？](https://support.huaweicloud.com/nlp_faq/nlp_02_0013.md): 自然语言处理服务需要开通什么权限？自然语言处理服务本身无权限限制，用户不需要额外添加任何权限，即可对自然语言处理服务执行操作。
- [调用文本翻译服务时，为何报错“非法token”？](https://support.huaweicloud.com/nlp_faq/nlp_02_0012.md): 已经获取到了token值，但是想要进行文本翻译的时候，报错，提示非法token是什么原因呐？是，请先更新token，因为token有效期是24小时，重新获取token，保证token在有效期内。否，执行2。是，充值后即可解决。否，联系技术支持工程师处理。
- [如何查看NLP套餐用量明细？](https://support.huaweicloud.com/nlp_faq/nlp_02_0015.md): 怎么查看NLP的套餐内使用量和消费金额详情？
- [为什么报APIG.0101？](https://support.huaweicloud.com/nlp_faq/nlp_02_0016.md): 用户在调用语义理解api时，为什么报“The API does not exist or has not been published in the environment“错误？接口调用地址url:https://nlp-ext.cn-north-4.myhuaweicloud.com/0ade47a66b8025572f42c0157
- [如何使自然语言处理停止计费？](https://support.huaweicloud.com/nlp_faq/nlp_02_0017.md): 自然语言处理服务是按接口调用来收费，计费模式分为按需计费和折扣套餐包计费，详情请见计费说明。如果您不进行接口调用，不会产生额外的费用，无需停止计费。
- [自然语言处理服务支持哪几种语言？](https://support.huaweicloud.com/nlp_faq/nlp_02_0020.md): 自然语言处理服务各个API接口支持的语言如表1所示。
- [获取Token失败怎么办？](https://support.huaweicloud.com/nlp_faq/nlp_02_0021.md): Token是用户的访问令牌，承载了用户的身份、权限等信息，用户调用API接口时，需要使用Token进行鉴权。Token获取失败可能是由于使用非华为云账号获取Token。如果您的华为云账号已升级为华为账号，将不支持获取账号Token，建议您为自己创建一个IAM用户，授予该用户必要的权限，获取IAM用户Token。创建IAM用户操作如下，详细
- [账密报错“The username or password is wrong.”](https://support.huaweicloud.com/nlp_faq/nlp_02_0022.md): 获取Token时出现“The username or password is wrong.”。请确认近期华为云账号是否有升级为华为账号。当前，如果您通过华为账号入口登录华为云账号，就会指引升级。华为云账号若已升级为华为账号，将不支持获取账号Token。建议您创建一个IAM账户，使用IAM账户获取Token。登录华为云控制台，在右上角用户名
- [如何查看NLP折扣套餐到期日？](https://support.huaweicloud.com/nlp_faq/nlp_02_0023.md): 如何查看NLP折扣套餐到期日？