检测到您已登录华为云国际站账号,为了您更好的体验,建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
文档分类 中文(zh) 机器翻译接口 文本翻译 翻译支持的原语言和目标语言请见表2 语种识别 支持识别的文本语种请见表3 文档翻译任务创建 文档翻译当前仅支持中英互译 文档翻译状态查询 文档当前仅支持中英互译 表2 文本翻译支持的语言列表 语种名称 语言代码 阿拉伯语(即将下线) ar 德语(即将下线)
API概览 自然语言处理提供了如下接口,方便用户对自然语言处理的使用。各类接口的说明如表1所示。 表1 接口说明 接口类型 说明 自然语言处理基础接口 包含分词、多粒度分词、依存句法分析、命名实体识别、文本相似度和句向量、实体链接、关键词抽取、事件抽取接口等。 语言生成接口 包含文本摘要、诗歌生成接口。
请求消息 请求参数如表2所示。 表2 请求参数 参数名 参数类型 必选 说明 text1 String 是 待计算文本1,长度1~64,文本编码为UTF-8。 text2 String 是 待计算文本2,长度1~64,文本编码为UTF-8。 lang String 否 支持的文本语言类型,目前只支持中文(zh),默认为中文。
请求发送以后,您会收到响应,包含状态码、响应消息头和消息体。 状态码是一组从1xx到5xx的数字代码,状态码表示了请求响应的状态,完整的状态码列表请参见状态码。 对于NLP服务接口,如果调用后返回状态码为“200”,则表示请求成功。 响应消息头 对应请求消息头,响应同样也有消息头,如“Conte
支持变更计费模式的NLP计费项如表1所示。 表1 支持变更计费模式的NLP计费项 计费项 变更说明 自然语言处理基础版API 变更NLP的计费模式会同时变更基础版API的计费模式。 将NLP的计费模式从按需计费转为折扣套餐包的计费模式,可以让您享受一定程度的价格优惠。 自然语言处理领域版API
请求参数说明请参见表2。 表2 请求参数说明 参数名 参数类型 必选 说明 text String 是 需要识别语种的文本,具体支持的语种请参见表3。 仅支持utf-8编码,长度不超过2000字符。一个汉字、英文字母、标点符号等,均计为一个字符。 表3 语种识别支持的语言列表 语种名称 语言代码
自然语言处理的监控指标 功能说明 本节定义了自然语言处理服务上报云监控服务的监控指标的命名空间,监控指标列表和维度定义,用户可以通过云监控服务提供管理控制台或API接口来检索自然语言处理服务产生的监控指标和告警信息。 命名空间 SYS.NLP 监控指标 表1 NLP支持的监控指标 指标ID
请参见自然语言处理价格详情中的“基础版按需套餐包”表。 领域套餐包 按照选择不同调用次数的领域套餐包的数量进行计费,包括命名实体识别(领域版)、情感分析(领域版)、属性级情感分析(领域版)。 不同调用次数的领域套餐包单价 * 套餐包数量 请参见自然语言处理价格详情中的“领域版按需套餐包”表。
请求参数表2所示。 表2 请求参数 参数名 参数类型 必选 说明 sentences Array of strings 是 文本列表,文本长度为1~512,列表大小为1~1000,文本编码为UTF-8,目前只支持中文。 domain String 否 计算句向量时使用的模型名,目
2:汽车领域,适用于汽车领域评论。 响应消息 响应参数如表3所示。 表3 响应参数 参数名 参数类型 说明 result Result object 调用成功时的返回情感信息。 调用失败时无此字段。 请参见表4。 error_code String 调用失败时的错误码。具体参见错误码。 调用成功时无此字段。
响应参数所示。 表3 响应参数 参数名 参数类型 说明 tree String 成分句法分析结果,用嵌套括号的形式表示一棵树。括号内的第一个元素为子树的标签,如果是叶子节点则用"_"代替。第二个元素为子树,如果是叶子节点则为字符串。 error_code String 调用失败时的错误码,具体参见6
机构类实体的识别。 具体Endpoint请参见终端节点。 调用华为云NLP服务会产生费用,本API支持使用基础套餐包,购买时请在自然语言处理价格计算器中查看基础套餐包和领域套餐包支持的API范围。 本API调用限制为20次/秒。 调试 您可以在API Explorer中调试该接口。
String 否 支持的文本语言类型,目前支持中文(zh)和英文(en),默认为中文。 响应消息 响应参数如表3所示。 表3 响应参数 参数名 参数类型 说明 result Result object 调用成功时的返回情感信息。 调用失败时无此字段。 请参见表4。 error_code
如果词汇数量为浮点数,则limit取该浮点数向下取整的结果。 lang String 否 支持的文本语言类型,目前只支持中文(zh),默认为中文。 响应消息 响应参数如表3所示。 表3 响应参数 参数名 参数类型 说明 words Array of String 关键词列表。 error_code String
服务IAM。 云监控 云监控(Cloud Eye)可以监控自然语言处理的相关指标,具体如表1所示。用户可以通过指标及时了解自然语言处理的使用情况。Cloud Eye的更多信息请参见云监控CES。 表1 NLP的监控指标 指标名称 指标含义 取值范围 测量对象 调用服务成功次数 该
自然语言处理基础版和领域版的区别 自然语言处理基础版接口和领域版接口基于不同算法实现,对相同文本,基础版和领域版的结果有所差别。根据测试数据,领域版效果一般优于基础版。 自然语言处理基础版接口和领域版接口所支持的计费模式也有所区别,详情请见计费说明。 表1 区分基础版和领域版的接口 接口类型
响应参数如表3所示。 表3 响应参数 名称 参数类型 说明 poem Array[String] 根据文本请求体,返回生成的诗歌。 error_code String 调用失败时的错误码,具体参见错误码。 调用成功时无此字段。 error_msg String 调用失败时的错误信息。
终端节点 终端节点即调用API的请求地址,不同服务不同区域的终端节点不同,您可以从地区和终端节点中查询所有服务的终端节点。 目前自然语言处理基础、语言生成、语言理解和机器翻译服务支持以下地区和终端节点: 表1 自然语言处理基础、语言生成、语言理解和机器翻译服务 区域名称 区域 终端节点(Endpoint)
如果您的应用需要较高的容灾能力,建议您将资源部署在同一区域的不同可用区内。 如果您的应用要求实例之间的网络延时较低,则建议您将资源创建在同一可用区内。 区域和终端节点 当您通过API使用资源时,您必须指定其区域终端节点。有关区域和终端节点的更多信息,请参阅自然语言处理服务的地区和终端节点。