云服务器内容精选

  • 步骤2:使用 IAM 账户 获取Token 以获取华北-北京四(cn-north-4)区域的Token为例。 POST https://iam.cn-north-4.myhuaweicloud.com/v3/auth/tokens Request Header: Content-Type: application/json Request Body: { "auth": { "identity": { "methods": [ "password" ], "password": { "user": { "name": "username", //子账户名称 "password": "********", //子账户密码 "domain": { "name": "domainname" //主账户名称 } } } }, "scope": { "project": { "name": "project name" //区 域名 称,如cn-north-4 } } } }
  • 自然语言处理 服务支持哪几种语言? 自然语言处理服务各个API接口支持的语言如表1所示。 表1 NLP支持语言 接口类型 接口 支持语言 自然语言处理基础 接口 分词 中文(zh)、英文(en) 多粒度分词 中文(zh)、英文(en) 依存句法分析 中文(zh) 命名实体识别(基础版) 中文(zh)、英文(en)、西班牙文(es) 命名实体识别(领域版) 中文(zh) 文本相似度(基础版) 中文(zh)、英文(en) 文本相似度(高级版) 中文(zh) 句向量 中文(zh) 实体链接 中文(zh) 关键词抽取 中文(zh) 事件抽取 中文(zh) 成分句法分析 中文(zh) 语言生成 接口 文本摘要(基础版) 中文(zh)、英文(en) 文本摘要(领域版) 中文(zh) 诗歌生成 中文(zh) 语言理解 接口 情感分析(基础版) 中文(zh)、英文(en) 情感分析(领域版) 中文(zh) 文本分类 中文(zh) 属性级情感分析 中文(zh) 属性级情感分析(高级版) 中文(zh) 实体级情感分析 中文(zh) 意图理解 中文(zh) 文档分类 中文(zh) 机器翻译 接口 文本翻译 翻译支持的原语言和目标语言请见表2 语种识别 支持识别的文本语种请见表3 文档翻译任务创建 文档翻译当前仅支持中英互译 文档翻译状态查询 文档当前仅支持中英互译 表2 文本翻译支持的语言列表 语种名称 语言代码 阿拉伯语(即将下线) ar 德语(即将下线) de 俄语(即将下线) ru 法语(即将下线) fr 韩语(即将下线) ko 葡萄牙语(即将下线) pt 日语(即将下线) ja 泰语(即将下线) th 土耳其语(即将下线) tr 西班牙语(即将下线) es 英语 en 越南语(即将下线) vi 中文(简体) zh 自动检测输入语种并翻译成目标语种,您需要指定目标语种(即将下线)。 auto 表3 语种识别支持的语言列表 语种名称 语言代码 阿拉伯语 ar 爱沙尼亚语 et 保加利亚语 bg 冰岛语 is 波兰语 pl 波斯尼亚语 bs 波斯语 fa 丹麦语 da 德语 de 俄语 ru 法语 fr 芬兰语 fi 高棉语 km 韩语 ko 加泰罗尼亚语 ca 捷克语 cs 克罗地亚语 hr 拉脱维亚语 lv 立陶宛语 lt 罗马尼亚语 ro 马耳他语 mt 马来西亚语 ms 北马其顿语 mk 孟加拉语 bn 缅甸语 my 南非荷兰语 af 挪威语 no 葡萄牙语 pt 日语 ja 瑞典语 sv 塞尔维亚语 sr 斯洛伐克语 sk 斯洛文尼亚语 sl 斯瓦希里语 sw 泰语 th 土耳其语 tr 威尔士语 cy 乌尔都语 ur 乌克兰语 uk 西班牙语 es 希伯来语 he 希腊语 el 匈牙利语 hu 意大利语 it 印地语 hi 印尼语 id 英语 en 越南语 vi 中文 zh 无法识别语种 unk
  • 问题描述 用户在调用语义理解api时,为什么报“The API does not exist or has not been published in the environment“错误? 接口调用地址url: https://nlp-ext.cn-north-4.myhuaweicloud.com/0ade47a66b8025572f42c0157eb7c94b/nlg/summarization
  • 自然语言处理基础版和领域版的区别 自然语言处理基础版接口和领域版接口基于不同算法实现,对相同文本,基础版和领域版的结果有所差别。根据测试数据,领域版效果一般优于基础版。 自然语言处理基础版接口和领域版接口所支持的计费模式也有所区别,详情请见计费说明。 表1 区分基础版和领域版的接口 接口类型 接口 自然语言处理基础服务接口 命名实体识别(基础版) 命名实体识别(领域版) 文本相似度(基础版) 文本相似度(领域版) 语言生成服务接口 文本摘要(基础版) 文本摘要(领域版) 语言理解服务接口 情感分析(基础版) 情感分析(领域版)
  • 自然语言处理服务有哪些调用限制? 各API所需资源不同,因此对应的限制不同,具体参看下表: 表1 NLP服务调用限制 API 单用户QPS 分词 20 多粒度分词 2 依存句法分析 2 命名实体识别(基础版) 20 命名实体识别(领域版) 20 文本相似度(基础版) 20 文本相似度(高级版) 2 句向量 20 实体链接 20 关键词抽取 20 事件抽取 2 文本摘要(基础版) 20 文本摘要(领域版) 2 诗歌生成 10 情感分析(基础版) 20 情感分析(领域版) 20 文本分类 20 意图理解 20 文本翻译 10 语种识别 10 文档翻译任务创建 1 文档翻译任务查询 10
  • Token消息体中user name,domain name和project name分别指的是什么? user name指IAM用户名称。 domain name指用户所属的账号名称。如果使用账号获取token,账号的user name和domain name相同。如果使用IAM用户获取token(账号可以创建多个IAM用户),user name和domain name不相同,user name为实际的用户名称。 project name指项目名称,如“cn-north-4”。获取方法参见获取用户名、用户ID、项目名称、项目ID。
  • 什么是区域、可用区 使用区域和可用区来描述数据中心的位置,您可以在特定的区域、可用区创建资源。 区域(Region):从地理位置和网络时延维度划分,同一个Region内共享弹性计算、块存储、对象存储、VPC网络、弹性公网IP、镜像等公共服务。Region分为通用Region和专属Region,通用Region指面向公共租户提供通用云服务的Region;专属Region指只承载同一类业务或只面向特定租户提供业务服务的专用Region。 可用区(AZ,Availability Zone):一个AZ是一个或多个物理数据中心的集合,有独立的风火水电,AZ内逻辑上再将计算、网络、存储等资源划分成多个集群。一个Region中的多个AZ间通过高速光纤相连,以满足用户跨AZ构建高可用性系统的需求。 图1阐明了区域和可用区之间的关系。 图1 区域和可用区 目前,华为云已在全球多个地域开放云服务,您可以根据需求选择适合自己的区域和可用区。
  • 如何选择区域? 选择区域时,您需要考虑以下几个因素: 地理位置 一般情况下,建议就近选择靠近您或者您的目标用户的区域,这样可以减少网络时延,提高访问速度。不过,在基础设施、BGP网络品质、资源的操作与配置等方面,中国大陆各个区域间区别不大,如果您或者您的目标用户在中国大陆,可以不用考虑不同区域造成的网络时延问题。 云服务之间的关系 如果多个云服务一起搭配使用,需要注意: 不同区域的弹性云服务器、关系型数据库、 对象存储服务 内网不互通。 不同区域的弹性云服务器不支持跨区域部署在同一负载均衡器下。 资源的价格 不同区域的资源价格可能有差异,请参见华为云服务价格详情。
  • 开通服务操作 进入自然语言处理基础官网,单击“立即使用”,进入自然语言处理控制台。 在“总览”页面,选择需要使用的服务,在操作列单击“开通服务”。 如果操作列无开通服务选项,请使用华为云账号,即当前IAM账号的主账号登录自然语言处理控制台。 图1 开通服务 在弹框中单击“确定”,确认开通服务。 服务开通成功后,开通状态将显示为“已开通”。 NLP服务开通后,暂不支持关闭。开通服务时,计费规则默认为“按需计费”。按需计费时,不使用NLP服务,则不收费。如果您购买了套餐包,套餐包扣减规则请参见计费规则。
  • 有哪些途径可以使用自然语言处理的API? 共有三种方式可以基于已构建好的请求消息发起请求。 cURL cURL是一个命令行工具,用来执行各种URL操作和信息传输。cURL充当的是HTTP客户端,可以发送HTTP请求给服务端,并接收响应消息。cURL适用于接口调试。关于cURL详细信息请参见https://curl.haxx.se/。 编码 通过编码调用接口,组装请求消息,并发送处理请求消息。 REST客户端 Mozilla、Google都为REST提供了图形化的浏览器插件,发送处理请求消息。下载postman请参见https://www.getpostman.com/。
  • 操作步骤 编辑获取用户Token接口的Request URL、Header、Body,进行具体的API调用。 Request URL 格式为:https://IAM地区与终端节点地址/API接口URI 访问网址:地区与终端节点,获取IAM区域与终端节点地址。 目前自然语言处理基础、语言生成、语言理解和机器翻译服务的API均支持“华北-北京四”区域。 图1 IAM区域与终端节点 访问网址:获取用户Token,获取API接口的URI。 以cn-north4为例,则Request URL为:https://iam.cn-north-4.myhuaweicloud.com/v3/auth/tokens 选择API接口获取方式,并将Request URL填写至postman中。 图2 Request URL示例 Request Header key:Content-Type,value:application/json;charset=utf8 图3 Headers参数示例 Request Body 修改Request Body样例中参数。 { "auth": { "identity": { "methods": [ "password" ], "password": { "user": { "domain": { "name": "账号名" }, "name": "IAM用户名", "password": "IAM用户密码" } } }, "scope": { "domain": { "name": "账号名" } } } } 获取账号名、IAM用户名,请参见:获取账号、IAM用户、项目名称和ID。 如果未创建IAM用户,请先使用管理员账号创建IAM用户,在创建IAM用户时会设置IAM用户密码,详情请参见创建IAM用户。 如果是第三方系统用户,没有在本系统设置登录密码,可以通过系统登录页面的找回密码功能设置登录密码,并在password中输入新设置的密码。 单击“Send”,发送API请求。 在返回的响应头中查看获取的用户Token,用户调用IAM其他API接口时,可以使用该Token进行鉴权。 Token的有效期为24小时,需要使用一个Token鉴权时,可以先缓存起来,避免频繁调用。 如果返回错误码,例如401,表示认证失败,请确认Request Body中请求参数填写正确后重新发送请求。 如果您的调试结果异常,提示“Header Overflow”,可以参考故障处理解决Header溢出问题。
  • 操作步骤 进入 API Explorer 平台获取IAM用户Token接口。 选择Region,编辑获取用户Token接口的请求参数,进行具体的API调用。 Region 在Region下拉列表选取您需要访问的区域。 Params nocatalog为非必填,如果设置该参数,返回的响应体中将不显示catalog信息。任何非空字符串都将解释为true,并使该字段生效。 Body 通过切换输入方式可以选择表单填写或文本输入请求体。 表单填写:通过表单填写完成请求体,无需了解JSON语法,参考示例填写参数值。 文本输入:通过文本输入完成请求体,可以直接在编辑框内编写JSON格式的请求体。 { "auth": { "identity": { "methods": [ "password" ], "password": { "user": { "domain": { "name": "IAM用户所属账号名" }, "name": "IAM用户名", "password": "IAM用户的登录密码" } } }, "scope": { "domain": { "name": "IAM用户所属账号名" } } } } 参数说明请参见:请求参数。 如果是第三方系统用户,没有在本系统设置登录密码,可以通过系统登录页面的找回密码功能设置登录密码,并在password中输入新设置的密码。 单击调试,发送API请求。 在返回的响应体中查看获取的用户Token,用户调用IAM其他API接口时,可以使用该Token进行鉴权。 Token的有效期为24小时,需要使用一个Token鉴权时,可以先缓存起来,避免频繁调用。 如果返回错误码,例如401,表示认证失败,请确认Request Body中请求参数填写正确后重新发送请求。
  • 响应消息 响应参数说明请参见表4。 表4 响应参数说明 参数名 参数类型 说明 src_text String 调用成功时表示翻译原文,编码格式为UTF-8。 调用失败时无此字段。 translated_text String 调用成功时表示翻译译文,编码格式为UTF-8。 调用失败时无此字段。 from String 调用成功时表示源语种(源语种输入为auto时,显示语种识别结果),编码格式为UTF-8。 调用失败时无此字段。 to String 调用成功时表示目标语种,编码格式为UTF-8。 调用失败时无此字段。 error_code String 调用失败时的错误码,具体请参见错误码。 调用成功时无此字段。 error_msg String 调用失败时的错误信息。 调用成功时无此字段。
  • 响应示例 成功响应示例 { "src_text": "欢迎使用机器翻译服务", "translated_text": "Welcome to use machine translation services", "from": "zh", "to": "en" } 失败响应示例 { "error_code": "NLP.0101", "error_msg": "Authentication failed. Verify the token." }
  • 请求示例 请求示例(文本翻译) POST https://{endpoint}/v1/{project_id}/machine-translation/text-translation Request Header: Content-Type:application/json X-Auth-Token: MIINRwYJKoZIhvcNAQcCoIINODCCDTQCAQExDTALBglghkgBZQMEAgEwgguVBgkqhkiG... Request Body: { "text": "欢迎使用机器翻译服务", "from": "zh", "to": "en", "scene":"common" } Python3语言请求代码示例(翻译中文"欢迎使用机器翻译服务"为英文) # -*- coding: utf-8 -*- # 此demo仅供测试使用,建议使用sdk。需提前安装requests,执行pip install requests import requests import json def nlp_demo(): url = 'https://{endpoint}/v1/{project_id}/machine-translation/text-translation' # endpoint和project_id需替换 token = '用户对应region的token' header = { 'Content-Type': 'application/json', 'X-Auth-Token': token } body = { 'text': '欢迎使用机器翻译服务', 'from': 'zh', 'to': 'en', 'scene': 'common' } resp = requests.post(url, data=json.dumps(body), headers=header) print(resp.json()) if __name__ == '__main__': nlp_demo() Java语言请求代码示例(翻译英文"It is a good day"为中文) import java.io.BufferedReader; import java.io.InputStream; import java.io.InputStreamReader; import java.io.OutputStreamWriter; import java.net.HttpURLConnection; import java.net.URL; /** * 此demo仅供测试使用,建议使用sdk */ public class NLPDemo { public void nlpDemo() { try { //endpoint和projectId需要替换成实际信息。 URL url = new URL("https://{endpoint}/v1/{project_id}/machine-translation/text-translation"); String token = "对应region的token"; HttpURLConnection connection = (HttpURLConnection) url.openConnection(); connection.setRequestMethod("POST"); connection.setDoInput(true); connection.setDoOutput(true); connection.addRequestProperty("Content-Type", "application/json"); connection.addRequestProperty("X-Auth-Token", token); //输入参数 String text = "It is a good day"; String from = "en"; String to = "zh"; String body = "{\"text\":\"" + text + "\" ,\"from\":\"" + from + "\" ,\"to\":\"" + to + "\" ,\"scene\":\"common\"}"; OutputStreamWriter osw = new OutputStreamWriter(connection.getOutputStream(), "UTF-8"); osw.append(body); osw.flush(); InputStream is = connection.getInputStream(); BufferedReader br = new BufferedReader(new InputStreamReader(is, "UTF-8")); while (br.ready()) { System.out.println(br.readLine()); } } catch (Exception e) { e.printStackTrace(); } } public static void main(String[] args) { NLPDemo nlpDemo = new NLPDemo(); nlpDemo.nlpDemo(); } }