检测到您已登录华为云国际站账号,为了您更好的体验,建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
认证鉴权 调用NLP服务接口目前支持Token认证进行认证鉴权。 调用接口有如下两种认证方式,您可以选择其中一种进行认证鉴权。 Token认证:通过Token认证调用请求。 通过终端节点和Token调用API。不支持调用“中东-阿布扎比-OP5”Region的对象存储服务(OBS
则中文字符必须为UTF-8编码。 每个接口的请求消息体内容不同,也并不是每个接口都需要有请求消息体(或者说消息体为空),GET、DELETE操作类型的接口就不需要消息体,消息体具体内容需要根据具体接口而定。 对于文本分类接口,您可以从接口的请求部分看到所需的请求参数及参数说明。将消息体加入后的请求如下所示。
请求发送以后,您会收到响应,包含状态码、响应消息头和消息体。 状态码是一组从1xx到5xx的数字代码,状态码表示了请求响应的状态,完整的状态码列表请参见状态码。 对于NLP服务接口,如果调用后返回状态码为“200”,则表示请求成功。 响应消息头 对应请求消息头,响应同样也有消息头,如“Content-type”,“x
则不收费。如果您购买了套餐包,套餐包扣减规则请参见价格计算器计费详情页。 如未开通服务,直接调用NLP API会提示ModelArts.4204报错。 父主题: 如何调用API
调用自然语言处理的API失败时怎么处理? 解决方案 根据API调用返回结果或者错误码查找原因,错误码详情请见错误码。 检查Token是否填写正确或者已过期,详情请见Token认证。 检查API调用方法是否正确,可参考快速入门。 如果无法确定原因和解决问题,请联系技术服务人员。
自然语言处理是否支持离线使用? 暂不支持离线使用,调用SDK必须能够访问外网才可以的,因为自然语言处理接口部署在华为云云端,所以需要您的网络可以访问外网才可以调用服务接口。 调用自然语言处理SDK请参见SDK参考。调用自然语言处理API接口请参见API参考。
附录 状态码 错误码 获取项目ID 获取账号ID 配置OBS访问权限
错误码 调用接口出错后,将不会返回结果数据。调用方可根据每个接口对应的错误码来定位错误原因。当调用出错时,HTTPS请求返回一个4xx或5xx的HTTPS状态码。返回的消息体中是具体的错误代码及错误信息。 错误响应Body体格式说明 当接口调用出错时,会返回错误码及错误信息说明,错误响应的Body体格式如下所示。
使用前必读 概述 调用说明 终端节点 约束与限制 基本概念
com)时,项目对应需为cn-north-4。 调用API获取项目ID 项目ID还可通过调用查询指定条件下的项目信息API获取。 获取项目ID的接口为“GET https://{Endpoint}/v3/projects”,其中{Endpoint}为IAM的终端节点,可以从地区和终端节点获取。接口的认证鉴权请参见认证鉴权。
实体链接 2019-07-08 新增机器翻译内容: 使用前必读 API概览 机器翻译服务接口说明 错误码 2019-06-28 刷新错误码。 2019-03-22 增加接口: 文本相似度(基础版) 句向量 老接口修改为废弃接口。 句向量(废弃) 2019-01-30 第一次正式发布。
访问权限,可以重置用户密码、分配用户权限等。由于账号是付费主体,为了确保账号安全,建议您不要直接使用账号进行日常管理工作,而是创建用户并使用创建的用户进行日常管理工作。 用户 由账号创建的用户,是云服务的使用人员,具有身份凭证(密码和访问密钥)。 在我的凭证下,您可以查看账号ID
数据结构 公共请求参数 公共响应参数
调用说明 自然语言处理服务提供了REST(Representational State Transfer)风格API,支持您通过HTTPS请求调用,调用方法请参见如何调用API。 父主题: 使用前必读
Language Processing) ,服务主要包括自然语言处理基础服务、语言生成服务、语言理解服务、机器翻译服务等功能。 在调用自然语言处理服务API之前,请确保已经充分了解自然语言处理服务相关概念,详细信息请参见产品介绍。 父主题: 使用前必读
终端节点 终端节点即调用API的请求地址,不同服务不同区域的终端节点不同,您可以从地区和终端节点中查询所有服务的终端节点。 目前自然语言处理基础、语言生成、语言理解和机器翻译服务支持以下地区和终端节点: 表1 自然语言处理基础、语言生成、语言理解和机器翻译服务 区域名称 区域 终端节点(Endpoint)
约束与限制 更详细的限制请参见具体API的说明和产品介绍约束与限制。 父主题: 使用前必读
获取账号ID 在调用接口的时候,部分URL中需要填入账号ID(domain-id),所以需要先在管理控制台上获取到账号ID。账号ID获取步骤如下: 登录NLP控制台。 单击用户名,在下拉列表中单击“我的凭证”。 在“我的凭证”页面的项目列表中查看账号ID。 图1 查看账号ID 父主题:
状态码 正常 200 异常 返回值 说明 400 Bad Request 请求错误,具体返回错误码请参考错误码。 401 Unauthorized 鉴权失败。 403 Forbidden 没有操作权限。 500 Internal Server Error 服务内部错误。 503 Service
权URL替代OBS文件URL授权服务访问用户私有文件。 临时URL存在有效期,获取到临时URL后请及时使用。 如何上传文件并获取临时url可以参考以下代码。 String endPoint = "http://your-endpoint"; String ak = "*** Provide