检测到您已登录华为云国际站账号,为了您更好的体验,建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
自然语言处理服务提供了REST(Representational State Transfer)风格API,支持您通过HTTPS请求调用,调用方法请参见如何调用API。 父主题: 使用前必读
根据API调用返回结果或者错误码查找原因,错误码详情请见错误码。 检查Token是否填写正确或者已过期,详情请见Token认证。 检查API调用方法是否正确,可参考快速入门。 如果无法确定原因和解决问题,请联系技术服务人员。
为查看方便,在每个具体API的URI部分,只给出resource-path部分,并将请求方法写在一起。这是因为URI-scheme都是HTTPS,而Endpoint在同一个区域也相同,所以简洁起见将这两部分省略。 请求方法 HTTP请求方法(也称为操作或动词),它告诉服务你正在请求什么类型的操作。 GET:请求服务器返回指定资源。
为云NLP服务。 本章节提供了通过Postman调用分词API的样例,详细介绍如何调用分词API接口,帮助您快速熟悉自然语言处理服务的使用方法。 同时也提供视频帮助指导您端到端使用Postman调用NLP服务接口。 开始使用样例前,请仔细阅读操作须知和准备工作,提前完成准备工作。具体调用NLP服务流程如下所示:
修改。 使用AK/SK认证时,您可以基于签名算法使用AK/SK对请求进行签名,也可以使用专门的签名SDK对请求进行签名。详细的签名方法和SDK使用方法请参见API签名指南。 签名SDK只提供签名功能,与服务提供的SDK不同,使用时请注意。 AK/SK获取方式请参考获取AK/SK。
ation/text-translation 参数说明 表1 URI参数说明 参数名 必选 说明 project_id 是 项目ID。获取方法请参见获取项目ID。 请求消息 请求参数说明请参见表2。 表2 请求参数说明 参数名 参数类型 必选 说明 text String 是 待
LP功能。 进入体验中心,在左侧选择想体验的NLP功能,例如分词。 图1 体验中心 体验中心会提供一段默认文本,单击“开始分析”,完成人机验证后,即可获取分析结果。 也可以单击“换一句”,更换输入文本,或在输入框自定义输入文本。
name和domain name不相同,user name为实际的用户名称。 project name指项目名称,如“cn-north-4”。获取方法参见获取用户名、用户ID、项目名称、项目ID。
0及以上版本Postman由于配置问题,无法正常获取用户Token,会有Header Overflow异常报错。 方法一: 建议使用低版本Postman,经测试V 5.xx版本可以正常访问。 方法二: 修改如下样例中的参数,使用curl命令获取Token: curl -ik -X POST -H
/v1/{project_id}/nlg/poem 参数说明 表1 URI参数说明 名称 是否必选 说明 project_id 是 项目ID。获取方法请参见获取项目ID。 请求消息 请求参数如下所示。 表2 请求参数 名称 是否必选 参数类型 说明 type 是 Integer 诗歌类型,取值如下:
考虑到数据的安全,自然语言处理服务无法直接获取到用户数据,需要用户开启公共读授权。 开启公共读授权 开启公共授权,则数据全网可见,所有用户均可访问。一般私密数据不建议用此方法,数据隐私及过期时间请客户自行保证。 配置公共读可参考配置标准桶策略,将桶策略设置为“公共读”。 目前仅支持访问用户个人OBS下的文件的链接,不支持读取其他用户公共读的链接。
文档翻译任务创建接口用于提交文档翻译任务,其中要翻译的文档保存在用户的OBS桶中。用户使用文档翻译服务时,服务需要拥有读取用户OBS桶权限,授权方法见配置OBS访问权限。当前仅支持翻译“docx”、“pptx”和“txt”格式的文档,其中txt格式文档只支持UTF-8编码格式。 文档翻
nslation/jobs/{job_id} 参数说明 表1 URI参数说明 参数名 必选 说明 project_id 是 项目ID。获取方法请参见获取项目ID。 job_id 是 文档翻译任务标识符。通过文档翻译任务创建获取。 请求消息 NA 响应消息 响应参数说明请参见表 响应参数说明。
/v1/{project_id}/nlu/sentiment 参数说明 表1 URI参数说明 参数名 必选 说明 project_id 是 项目ID。获取方法请参见获取项目ID。 请求消息 请求参数如表2所示。 表2 请求参数 参数名 参数类型 必选 说明 content String 是 待分析文本。文本编码要求为utf-8。
amental/entity-linking 参数说明 表1 URI参数说明 参数名 必选 说明 project_id 是 项目ID。获取方法请参见获取项目ID。 请求消息 请求参数如表2所示。 表2 请求参数 参数名 参数类型 必选 说明 text String 是 待分析文本
ext-similarity/advance 参数说明 表1 URI参数说明 参数名 必选 说明 project_id 是 项目ID。获取方法请参见获取项目ID。 请求消息 请求参数如表2所示。 表2 请求参数 参数名 参数类型 必选 说明 text1 String 是 待计算文
mental/text-similarity 参数说明 表1 URI参数说明 参数名 必选 说明 project_id 是 项目ID。获取方法请参见获取项目ID。 请求消息 请求参数如表2所示。 表2 请求参数 参数名 参数类型 必选 说明 text1 String 是 待计算文
/v1/{project_id}/nlu/classification 参数说明 表1 URI参数说明 参数名 必选 说明 project_id 是 项目ID。获取方法请参见获取项目ID。 请求消息 请求参数如表2所示。 表2 请求参数 参数名 参数类型 必选 说明 content String 是 待分
tal/sentence-embedding 参数说明 表1 URI参数说明 参数名 必选 说明 project_id 是 项目ID。获取方法请参见获取项目ID。 请求消息 请求参数表2所示。 表2 请求参数 参数名 参数类型 必选 说明 sentences Array of strings
/v1/{project_id}/nlp-fundamental/ner 参数说明 表1 URI参数说明 参数名 必选 说明 project_id 是 项目ID。获取方法请参见获取项目ID。 请求消息 请求参数如表2所示。 表2 请求参数 参数名 参数类型 必选 说明 text String 是 待分析文本