检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
配置OBS访问权限 OBS服务 OBS全称Object Stroage Service（对象存储服务），提供海量、安全、高可靠、低成本的数据存储能力，可供用户存储任意类型和大小的数据。 EI企业智能服务对于图片、语音等多媒体文件支持直接使用华为云OBS服务的数据处理方式，以减少服
构造请求 本节介绍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
返回结果 状态码 请求发送以后，您会收到响应，包含状态码、响应消息头和消息体。 状态码是一组从1xx到5xx的数字代码，状态码表示了请求响应的状态，完整的状态码列表请参见状态码。 对于NLP服务接口，如果调用后返回状态码为“200”，则表示请求成功。 响应消息头 对应请求消息头，响应同
Postman是网页调试与辅助接口调用的工具，具有界面简洁清晰、操作方便快捷的特性，可以处理用户发送的HTTP请求，例如：GET，PUT、POST，DELETE等，支持用户修改HTTP请求中的参数并返回响应数据。 Token是用户的访问令牌，承载了用户的身份、权限等信息，用户调用API接口时，需要使用Token进行鉴权。
NLP服务所需Token获取可参考下文，如需了解更多获取Token方式，请参考获取用户Token。 获取用户Token接口请求构造如下，您可以从接口的请求部分看到所需的请求参数及参数说明。获取Token消息头只需填写“Content-Type”，将消息体加入后的请求如下所示。
有哪些途径可以使用自然语言处理的API？ 共有三种方式可以基于已构建好的请求消息发起请求。 cURL cURL是一个命令行工具，用来执行各种URL操作和信息传输。cURL充当的是HTTP客户端，可以发送HTTP请求给服务端，并接收响应消息。cURL适用于接口调试。关于cURL详细信息请参见https://curl
用户首次使用需要先申请开通。服务只需要开通一次即可，后面使用时无需再次申请。如未开通服务，调用服务时会提示ModelArts.4204报错，请在调用服务前先进入控制台开通服务，并注意开通服务区域与调用服务的区域保持一致。 URI URI格式 POST /v1/{project_id}/
表1 URI参数说明 参数名 必选 说明 project_id 是 项目ID。获取方法请参见获取项目ID。 请求消息 请求参数如表2所示。 表2 请求参数 参数名 参数类型 必选 说明 text1 String 是 待计算文本1，长度1~64，文本编码为UTF-8。 text2 String
该指标用于统计用户请求服务成功次数，以“次每分钟”为单位。 ≥0次每分钟 自然语言处理 调用服务失败次数 该指标用于统计用户请求服务失败次数，以“次每分钟”为单位。 ≥0次每分钟 自然语言处理 每个子服务都有调用成功次数和失败次数两个指标。 对象存储服务 对象存储服务（Object Storage
在使用本API之前，需要您完成服务申请和认证鉴权，具体操作流程请参见申请服务和认证鉴权章节。 用户首次使用需要先申请开通。服务只需要开通一次即可，后面使用时无需再次申请。如未开通服务，调用服务时会提示ModelArts.4204报错，请在调用服务前先进入控制台开通服务，并注意开通服务区域与调用服务的区域保持一致。
状态码 正常 200 异常 返回值 说明 400 Bad Request 请求错误，具体返回错误码请参考错误码。 401 Unauthorized 鉴权失败。 403 Forbidden 没有操作权限。 500 Internal Server Error 服务内部错误。 503 Service
null OBSClient为空。 服务后台错误，请联系技术支持。 500 NLP.0402 obs closed failed OBSClient关闭失败。 服务后台错误，请联系技术支持。 500 NLP.0403 upload file for obs failed OBS上传文件失败。
实现，对相同文本，基础版和领域版的结果有所差别。根据测试数据，领域版效果一般优于基础版。 自然语言处理基础版接口和领域版接口所支持的计费模式也有所区别，详情请见计费说明。 表1 区分基础版和领域版的接口 接口类型 接口 自然语言处理基础服务接口 命名实体识别（基础版） 命名实体识别（领域版）
必选 说明 project_id 是 项目ID。获取方法请参见获取项目ID。 请求消息 请求参数如表2所示。 表2 请求参数 参数名 参数类型 必选 说明 lang String 否 支持的文本语言类型，目前支持中文（zh）和英文（en），默认为中文。 title String 否
终端节点 终端节点即调用API的请求地址，不同服务不同区域的终端节点不同，您可以从地区和终端节点中查询所有服务的终端节点。 目前自然语言处理基础、语言生成、语言理解和机器翻译服务支持以下地区和终端节点： 表1 自然语言处理基础、语言生成、语言理解和机器翻译服务 区域名称 区域 终端节点（Endpoint）
调用说明 自然语言处理服务提供了REST（Representational State Transfer）风格API，支持您通过HTTPS请求调用，调用方法请参见如何调用API。 父主题： 使用前必读
具体操作流程请参见申请服务和认证鉴权章节。 用户首次使用需要先申请开通。服务只需要开通一次即可，后面使用时无需再次申请。如未开通服务，调用服务时会提示ModelArts.4204报错，请在调用服务前先进入控制台开通服务，并注意开通服务区域与调用服务的区域保持一致。 URI URI格式
存放在OBS的文档文件路径，私密文件推荐使用临时授权URL调用服务，如何获取OBS文件URL和临时授权URL请参见配置OBS访问权限。OBS的region要和请求服务的region保持一致，region不一致则OBS不可用，即使obs是公开访问权限。存放在OBS的文档文件名必须是英文字母。 from String
在使用本API之前，需要您完成服务申请和认证鉴权，具体操作流程请参见申请服务和认证鉴权章节。 用户首次使用需要先申请开通。服务只需要开通一次即可，后面使用时无需再次申请。如未开通服务，调用服务时会提示ModelArts.4204报错，请在调用服务前先进入控制台开通服务，并注意开通服务区域与调用服务的区域保持一致。
长按/截图保存，微信识别二维码
或者关注公众号“华为云”
