华为云用户手册

首次使用NLP 如果您是首次使用NLP的用户，建议您学习并了解如下信息： 功能介绍 通过功能介绍章节的内容，了解NLP不同功能的具体介绍，主要包括自然语言处理基础（Natural Language Processing Fundamentals）、语言生成（Language Generation，简称LG）、语言理解（Language Understanding，简称LU）、机器翻译（Machine Translation，简称MT）功能。 入门使用 NLP以开放API的方式提供给用户，您可以参考《快速入门》学习并使用NLP服务。 使用方式 如果您是一个开发工程师，熟悉代码编写，想要直接调用NLP的API或SDK使用服务，您可以参考《API参考》或《SDK参考》获取详情。 由浅入深学习 您可以参考成长地图，由浅入深学习使用NLP。

场景示例：核对资源用量是否与实际相符 假设用户在2023/07/25 10:10:05开通了诗歌生成的API，在2023/07/25 10:13:30、2023/07/25 10:16:45和2023/07/25 11:20:11分别调用了一次诗歌生成的API。 自然语言处理API流水账单 按需计费自然语言处理API按调用次数计费，每日结算一次费用，您可以在流水账单中核对每一个计费周期的信息是否和实际相符，具体如表1所示。 表1 自然语言处理API流水账单 产品类型 自然语言处理 NLP 产品 自然语言处理API 计费模式 按需 消费时间 2023/07/25 10:10:05 ~ 2023/07/25 11:20:11时段计费系统将生成1笔流水账单，对应如下计费周期： 2023/07/25 10:00:00 ~ 2023/07/25 12:00:00 官网价 官网价=调用量 * 单价 本例中，在计费周期内自然语言处理API的调用量为3次，单价可在自然语言处理价格详情中查询，以0.012元/次为例，那么官网价=0.012 * 3 = 0.036元。 优惠金额 用户使用云服务享受折扣优惠如商务折扣、伙伴授予折扣以及促销优惠等减免的金额。基于官网价的优惠金额。 抹零金额 按需计费等模式中，结算出账时实际只扣费到最小货币单位分，分以后不扣费直接抹去的金额。 本例中，抹零金额为：0.006 元 应付金额 应付金额=官网价-优惠金额-抹零金额 本例中，假设优惠金额为0，那么应付金额=0.036 - 0 - 0.006 = 0.03元 自然语言处理API明细账单 明细账单可以通过多维度展示客户账单的详细信息。一般通过设置统计维度为“按使用量”，统计周期为“按账期”来统计资源在某个月份的总开销，建议您核对表2所示的信息是否和实际相符。 表2 自然语言处理API明细账单 产品类型 自然语言处理 NLP 产品 自然语言处理API 计费模式 按需 资源名称/ID 自然语言处理API的名称和ID 例如：custom，0f4bca096d80f3212f31c002eab9931d--poem 规格 自然语言处理定制版API 使用量类型 按需计费NLP的使用量类型为“数量” 单价 按需计费模式为简单定价（使用量*单价）时提供单价信息，其他的定价如阶梯定价等不提供单价。 按需计费NLP的诗歌生成属于简单定价，您可以在自然语言处理价格详情中查询单价。 单价单位 在自然语言处理价格详情中查询到的单价单位：元/次 使用量 按产品定价单位显示使用量，自然语言处理API的单价单位为元/次，因此使用量以次为单位。本例中，2023/07/25 10:10:05 ~ 2023/07/25 11:20:11时段总计使用量为3次。 使用量单位 次 官网价 官网价=使用量*单价 本例中，使用量为3次，单价可在自然语言处理价格详情中查询，以0.012元/次为例，那么官网价=3 * 0.012 = 0.036元。 优惠金额 用户使用云服务享受折扣优惠如商务折扣、伙伴授予折扣以及促销优惠等减免的金额。基于官网价的优惠金额。 应付金额 用户使用云服务享受折扣优惠后需要支付的费用金额。

计费周期 按需计费是指按照API调用次数计费，对用户云账户中的金额以日为周期进行扣除（文本翻译除外），只有调用成功才会计算调用次数。 例如，您在2023/7/14日调用了文档翻译接口，那么其计费周期为：2023/7/14 0:00:00~2023/7/14 23:59:59。 文本翻译是按调用字符数阶梯计费，按月累积，对用户云账户中的金额以月为周期进行扣除。只有调用成功才会计算调用字符数，未用完的免费调用字符数不流转到下一个月。字符数以翻译的源语言字符长度为标准计算。一个汉字、英文字母、标点符号等，均计为一个字符。一个自然月后调用次数清零重新累积。

计费周期 套餐包自然语言处理API资源的计费周期是根据您购买的时长来确定的（以UTC+8时间为准）。一个计费周期的起点是您开通或续费资源的时间（精确到秒），有效期1年，终点则是到期日的23:59:59。 例如，如果您在2023/07/17 15:50:04购买了有效期1年且调用次数为50万次的情感分析（基础版）接口，那么其计费周期为：2023/07/17 15:50:04 ~ 2024/07/17 23:59:59。

到期后影响 图1描述了套餐包自然语言处理API资源各个阶段的状态。购买后，在计费周期内资源正常运行，此阶段为有效期；资源到期而未续费时，将陆续进入宽限期和保留期。 图1 套餐包自然语言处理API资源生命周期 到期预警 套餐包自然语言处理API资源在到期前第7天内，系统将向用户推送到期预警消息。预警消息将通过邮件、短信和站内信的方式通知到华为云账号的创建者。 到期后影响 当您的套餐包自然语言处理API资源到期未续费，将自动进入宽限期，宽限期内您可以正常使用已购买和开通的资源。 如果您在宽限期内仍未续费套餐包自然语言处理API资源，那么就会进入保留期，资源状态变为“冻结”，您将无法对处于保留期的套餐包的API资源执行任何操作。 保留期到期后，若套餐包自然语言处理API资源仍未续费，则相应的资源将会自动失效。 华为云根据客户等级定义了不同客户的宽限期和保留期时长。 关于续费的详细介绍请参见续费。

续费相关的功能 NLP折扣套餐包续费相关的功能如表1所示。 表1 续费相关的功能 功能 说明 手动续费 资源即将到期时，已经购买NLP套餐包的客户，可执行手动续费操作，以延长资源包的有效期。 自动续费 开通自动续费后，系统将在资源到期前自动续费，无需客户再手动操作。 在NLP套餐包生命周期的不同阶段，您可以根据需要选择一种方式进行续费，具体如图1所示。 图1 NLP套餐包生命周期 NLP套餐包从购买到到期前，处于正常运行阶段，资源状态为“使用中”。 到期后，资源状态变为“已过期”。 到期未续费时，NLP套餐包首先会进入宽限期，宽限期到期后仍未续费，资源状态变为“冻结”。 超过宽限期仍未续费将进入保留期，如果保留期内仍未续费，资源将自动失效。 华为云根据客户等级定义了不同客户的宽限期和保留期时长。 在NLP套餐包到期前均可开通自动续费，到期前7日凌晨3:00首次尝试自动续费，如果扣款失败，每天凌晨3:00尝试一次，直至NLP套餐包到期或者续费成功。到期前7日自动续费扣款是系统默认配置，您也可以根据需要修改此扣款日。

成本分配 成本管理的基础是树立成本责任制，让各部门、各业务团队、各责任人参与进来，为各自消耗云服务产生的成本负责。企业可以通过成本分配的方式，将云上成本分组，归集到特定的团队或项目业务中，让各责任组织及时了解各自的成本情况。 华为云成本中心支持通过多种不同的方式对成本进行归集和重新分配，您可以根据需要选择合适的分配工具。 通过关联账号进行成本分配 企业主客户可以使用关联账号对子客户的成本进行归集，从而对子账号进行财务管理。详细介绍请参见通过关联账号维度查看成本分配。 使用成本单元进行成本分配 企业可以使用成本中心的“成本单元”来拆分公共成本。公共成本是指多个部门共享的计算、网络、存储或资源包产生的云成本，或无法直接通过企业项目、成本标签分配的云成本。这些成本不能直接归属于单一所有者，因此不能直接归属到某一类别。使用拆分规则，可以在各团队或业务部门之间公平地分配这些成本。详细介绍请参见使用成本单元查看成本分配。

成本优化 成本控制 企业可以在成本中心的“预算管理”页面创建精细粒度的预算来管理成本和使用量，在实际或预测超过预算阈值时，自动发送通知给指定消息接收人。企业还可以创建预算报告，定期将指定预算进展通知给指定消息接收人。 例如企业需要创建一个NLP服务的按需成本预算，每月预算金额为2000元，当预测金额高于预算金额的80%时发送预算告警。那么，创建的预算如下： 图1 预算基本信息 图2 设置成本范围 图3 设置提醒 计费模式优化 不同类型的业务对资源使用周期有不同的要求，为每一类业务确定合适的计费模式，灵活组合以达到最优效果。 针对长期稳定的成熟业务，使用折扣套餐包计费模式。 针对不能中断的短期、突增或不可预测的业务，使用按需计费模式。

计费模式概述 自然语言处理NLP提供免费试用、按需计费和折扣套餐包三种计费模式，以满足不同场景下的用户需求。 免费试用：部分API支持首次免费试用，需要购买免费试用套餐包后使用。免费试用套餐包只允许每个用户免费购买一次，一经退订无法再购买，但可以以原价续费。 折扣套餐包：一种预付费模式，从购买之日起生效，有效期1年，到期自动结束。该有效期内未调用自然语言处理服务，该套餐也不会延期，且无法退还费用。扣费时调用次数会先在套餐包内进行抵扣，抵扣完后的剩余调用量默认转回按需计费方式。对于长期使用者，推荐该购买方式。 按需计费：一种后付费模式，即先使用再付费，指按照API调用次数阶梯价格计费。 表1列出了三种计费模式的区别。 表1 计费模式 计费模式 免费试用 折扣套餐包 按需计费 付费方式 购买免费试用套餐包 预付费 按照订单的购买套餐包个数结算。 后付费 按照API调用次数阶梯价格计费。 计费周期 - 套餐包有效期1年。 对用户云账户中的金额以日为周期进行扣除。 适用计费项 免费试用套餐包 基础套餐包、领域套餐包 文档翻译、文本翻译、自然语言处理基础版API、自然语言处理领域版API、自然语言处理定制版API。 变更计费模式 支持变更为按需计费或折扣套餐包计费模式。 - 支持变更为折扣套餐包计费模式。 适用场景 适用于想了解NLP服务且初次体验的使用者。 适用于可预估资源使用周期的场景，价格比按需计费模式更优惠。对于长期使用者，推荐该方式。 适用于计算资源需求波动的场景，可以随时开通。 父主题： 计费模式

在续费管理页面开通自动续费 登录管理控制台。 单击“控制台”页面上方“费用”，在下拉菜单中选择“续费管理”。 进入“续费管理”页面。 自定义查询条件。 可在“自动续费项”页签查询已经开通自动续费的资源。 可对“手动续费项”、“到期转按需项”、“到期不续费项”页签的资源开通自动续费。 为折扣套餐包资源开通自动续费。 单个资源开通自动续费：选择需要开通自动续费的NLP套餐包，单击操作列的“开通自动续费”。 批量资源开通自动续费：选择需要开通自动续费的NLP套餐包，单击列表左上角的“开通自动续费”。 选择续费时长，并根据需要设置自动续费次数，单击“开通”。

变更计费模式概述 在开通自然语言处理API后，如果发现当前计费模式无法满足业务需求，您可以变更计费模式。支持变更计费模式的NLP计费项如表1所示。 表1 支持变更计费模式的NLP计费项 计费项 变更说明 自然语言处理基础版API 变更NLP的计费模式会同时变更基础版API的计费模式。 将NLP的计费模式从按需计费转为折扣套餐包的计费模式，可以让您享受一定程度的价格优惠。 自然语言处理领域版API 变更NLP的计费模式会同时变更领域版API的计费模式。 将NLP的计费模式从按需计费转为折扣套餐包的计费模式，可以让您享受一定程度的价格优惠。 自然语言处理定制版API 不支持变更计费模式。 文档翻译 不支持变更计费模式。 文本翻译 不支持变更计费模式。 基础套餐包 基础套餐包支持到期后转为按需计费。 领域套餐包 领域套餐包支持到期后转为按需计费。 父主题： 变更计费模式

在费用中心续费 登录管理控制台。 单击“控制台”页面上方“费用”，在下拉菜单中选择“续费管理”。 进入“续费管理”页面。 自定义查询条件。 可在“手动续费项”、“自动续费项”、“到期转按需项”、“到期不续费项”页签查询全部待续费资源，对资源进行手动续费的操作。 所有需手动续费的资源都可归置到“手动续费项”页签，具体操作请参见如何恢复为手动续费。 手动续费资源。 单个续费：在资源页面找到需要续费的资源，单击操作列的“续费”。 批量续费：在资源页面勾选需要续费的资源，单击列表左上角的“批量续费”。 选择NLP折扣套餐包的续费时长，判断是否勾选“统一到期日”，将NLP折扣套餐包到期时间统一到某个月的某一天（详细介绍请参见统一折扣套餐包资源的到期日）。确认费用后单击“去支付”。 进入支付页面，选择支付方式，确认付款，支付订单后即可完成续费。

折扣套餐包资源 对于折扣套餐包计费模式的资源，例如基础套餐包和领域套餐包，用户在购买时会一次性付费，服务将在到期后自动转为按需计费。 如果在计费周期内不再使用折扣套餐包资源，您可以执行退订操作，系统将根据资源是否属于五天无理由退订、是否使用代金券和折扣券等条件返还一定金额到您的账户。详细的退订规则请参见云服务退订规则概览。 如果您已开启“自动续费”功能，为避免继续产生费用，请在自动续费扣款日（默认为到期前7日）之前关闭自动续费。

计费项 NLP的计费项由文档翻译、文本翻译、自然语言处理基础版API、自然语言处理领域版API、自然语言处理定制版API、基础套餐包和领域套餐包组成。具体内容如表1。 表1 适用计费项 计费项 计费项说明 适用的计费模式 计费公式 文档翻译 按照调用页数进行计费。 按需计费 文档翻译单价 * 使用量 请参见自然语言处理价格详情中的“按需后付费价格”表。 自然语言处理基础版API 按照调用次数进行计费，包括分词，命名实体识别（基础版），文本相似度（基础版），句向量，文本摘要，情感分析（基础版），文本分类，意图理解，关键词抽取，语种识别，文档分类。 基础版API单价 * 使用量 请参见自然语言处理价格详情中的“按需后付费价格”表。 自然语言处理领域版API 按照调用次数进行计费，包括命名实体识别（领域版）， 情感分析（领域版），属性级情感分析（领域版）。 领域版API单价 * 使用量 请参见自然语言处理价格详情中的“按需后付费价格”表。 自然语言处理定制版API 按照调用次数进行计费，包括实体链接、诗歌生成、属性级情感分析（高级版）。 定制版API单价 * 使用量 请参见自然语言处理价格详情中的“按需后付费价格”表。 文本翻译 按照调用字符数阶梯计费。 按调用字符数采用阶梯计费，按月累积 0~一百万字符（含）：免费 一百万~五千万字符（含）：按照元/百万字符计费 五千万~一亿字符（含）：按照元/百万字符计费 大于一亿：按照元/百万字符计费 请参见自然语言处理价格详情中的“文本翻译按需付费价格”表。 基础套餐包 按照选择不同调用次数的基础套餐包的数量进行计费，包括分词、命名实体识别（基础版）、文本相似度（基础版）、句向量、文本摘要、情感分析（基础版）、文本分类、意图理解、关键词抽取、语种识别、文档分类。 折扣套餐包 不同调用次数的基础套餐包单价 * 套餐包数量 请参见自然语言处理价格详情中的“基础版按需套餐包”表。 领域套餐包 按照选择不同调用次数的领域套餐包的数量进行计费，包括命名实体识别（领域版）、情感分析（领域版）、属性级情感分析（领域版）。 不同调用次数的领域套餐包单价 * 套餐包数量 请参见自然语言处理价格详情中的“领域版按需套餐包”表。

步骤2：Token认证 在Postman界面上，单击左侧导航树“get-token”，选中“Body”页签，在“Body”页签中添加华为云账号、密码及NLP服务部署的区域“cn-north-4”，如下图所示，其中： “user”里的“name”表示准备工作中获取的IAM用户名，“password”表示用户密码。 “domain”里的“name”表示准备工作中获取的账号名。 “project”里的“name”表示区域名，如“cn-north-4”，终端节点。 获取token的华为云服务所在区域需要和调用的服务所在区域一致，否则会导致调用失败。 图3 Token认证 单击右上角“Send”，发送“POST https://iam.cn-north-4.myhuaweicloud.com/v3/auth/tokens”获取返回结果Headers中的token值（Token有效期为24小时）。 图4 获取token

开通服务操作 进入自然语言处理基础官网，单击“立即使用”，进入自然语言处理控制台。 在“总览”页面，选择需要使用的服务，在操作列单击“开通服务”。 图1 开通服务 在弹框中单击“确定”，确认开通服务。 服务开通成功后，开通状态将显示为“已开通”。 NLP服务开通后，暂不支持关闭。开通服务时，计费规则默认为“按需计费”。按需计费时，不使用NLP服务，则不收费。如果您购买了套餐包，套餐包扣减规则请参见计费规则。

响应消息 响应参数说明请参见表4。 表4 响应参数说明 参数名 参数类型 说明 detected_language String 调用成功时表示调用结果，编码格式为UTF-8，语种取值请见表3。 当输入文本过短或不明确时，识别结果可能不准确； 当输入文本包含多种语言时，会返回占比最高的语种。 调用失败时无此字段。 error_code String 调用失败时的错误码，具体请参见错误码。 调用成功时无此字段。 error_msg String 调用失败时的错误信息。 调用成功时无此字段。

请求示例 请求示例（识别"欢迎使用机器翻译服务"的语种） POST https://{endpoint}/v1/{project_id}/machine-translation/language-detection Request Header: Content-Type:application/json X-Auth-Token: MIINRwYJKoZIhvcNAQcCoIINODCCDTQCAQExDTALBglghkgBZQMEAgEwgguVBgkqhkiG... Request Body: { "text": "欢迎使用机器翻译服务" } 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/language-detection' # endpoint和project_id需替换 token = '用户对应region的token' header = { 'Content-Type': 'application/json', 'X-Auth-Token': token } body = { 'text': '欢迎使用机器翻译服务' } 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/language-detection"); 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 body = "{\"text\":\"" + text + "\"}"; 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(); } }

请求消息 请求参数说明请参见表2。 表2 请求参数说明 参数名 参数类型 必选 说明 text String 是 需要识别语种的文本，具体支持的语种请参见表3。 仅支持utf-8编码，长度不超过2000字符。一个汉字、英文字母、标点符号等，均计为一个字符。 表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

请求示例 请求示例（开启词性标注功能进行分词，支持PKU分词规范） “endpoint”、“project_id”、“token”等请求参数获取方式可参考快速入门，参数详情请见构造请求。 Request Header: Content-Type: application/json X-Auth-Token: MIINRwYJKoZIhvcNAQcCoIINODCCDTQCAQExDTALBglghkgBZQMEAgEwgguVBgkqhkiG... Request Body: { "text":"今天天气真好", "pos_switch":1, "lang":"zh", "criterion":"PKU" } Python3语言请求代码示例（开启词性标注功能进行分词，支持PKU分词规范） # -*- coding: utf-8 -*- # 此demo仅供测试使用，建议使用sdk。需提前安装requests，执行pip install requests import requests import json def nlp_demo(): url = 'https://{endpoint}/v1/{project_id}/nlp-fundamental/segment' # endpoint和project_id需替换 token = '用户对应region的token' header = { 'Content-Type': 'application/json', 'X-Auth-Token': token } body = { 'text': '今天天气真好', 'pos_switch': 1, 'lang': 'zh', 'criterion': 'PKU' } resp = requests.post(url, data=json.dumps(body), headers=header) print(resp.json()) if __name__ == '__main__': nlp_demo() Java语言请求代码示例（开启词性标注功能进行分词，支持PKU分词规范） 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}/nlp-fundamental/segment"); 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 = "订单记录怎么删除"; String body = "{\"text\":\"" + text + "\",\"pos_switch\":1 ,\"lang\":\"zh\",\"criterion\":\"PKU\"}"; 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(); } }

请求消息 请求参数如表2所示。 表2 请求Body参数 参数名 参数类型 必选 说明 text String 是 待分词文本，中文长度为1~512，英文长度为1~2000，文本编码为UTF-8。 pos_switch Integer 否 是否开启词性标注功能，1为开启，0为关闭，默认为关闭。 lang String 否 支持的文本语言类型，目前支持中文（zh）和英文（en），默认为中文。 criterion String 否 支持的分词规范。 中文分词标准目前支持PKU（北大分词标准）、CTB（宾州中文树库标准），默认为PKU。 英文分词标准默认为Penn TreeBank（宾州树库标准），不需要传入该参数。

响应示例 成功响应示例 { "words": [ { "content": "今天", "pos": "t" }, { "content": "天气",, "pos": "n" }, { "content": "真", "pos": "d" }, { "content": "好", "pos": "a" } ] } 失败响应示例 { "error_code": "NLP.0301", "error_msg": "The length of text should be in the range of 1-512" }

开通服务操作 进入自然语言处理基础官网，单击“立即使用”，进入自然语言处理控制台。 在“总览”页面，选择需要使用的服务，在操作列单击“开通服务”。 如果操作列无开通服务选项，请使用华为云账号，即当前IAM账号的主账号登录自然语言处理控制台。 图1 开通服务 在弹框中单击“确定”，确认开通服务。 服务开通成功后，开通状态将显示为“已开通”。 NLP服务开通后，暂不支持关闭。开通服务时，计费规则默认为“按需计费”。按需计费时，不使用NLP服务，则不收费。如果您购买了套餐包，套餐包扣减规则请参见计费规则。

自然语言处理服务支持哪几种语言？ 自然语言处理服务各个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 中文（繁体） zh-tw 自动检测输入语种并翻译成目标语种，您需要指定目标语种。 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 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中请求参数填写正确后重新发送请求。

步骤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 } } } }

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。

操作步骤 编辑获取用户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溢出问题。

操作说明 【搜索】：可根据筛选条件查询店铺信息。 图2 店铺信息 【查看】：可查看不同渠道店铺的信息，如基本信息、地址标记、配送范围、营业时间、配送时间、店铺主账号等信息。 图3 配送时间 店铺详情信息页中有双语的信息展示，如果语言环境配置了第二语言，运营人员则可根据用户需求，在详情信息页填写第二语言的信息，填写过的信息会在用户端展示出来。比如系统语言环境配置了第二语言是英文，则运营人员可填写英文的展示信息；如果没有配置第二语言，则详情信息页则不展示第二语言信息。 【启用/停用】：运营可根据店铺的情况启用/停用店铺，停用的店铺在前端不可查看到此店铺。 单击【添加店铺】，在弹窗中录入如下信息： 图4 新增店铺信息1 店铺编码：店铺编码唯一，不可重复。 店铺名称：录入店铺的中文名称。 店铺名称（第二语言）：录入店铺的外文名称。 组织架构：选择商家对应的组织层级。 图5 新增店铺信息2 店铺分类：线上店铺/线下店铺。 店铺所属渠道：展示对应商家有资质的销售渠道（路径：商家管理-渠道）。 单击【新增】按钮完成店铺创建。单击列表中的【编辑】进入店铺编辑页面。 基本信息：可以完善店铺基本信息及联系信息。 如以O2O店铺为例： 图6 店铺基本信息 地址标记 仅渠道模式为O+O、POS的店铺才展示此tab，用于标记店铺的位置。 可以在地图上人工查找到正确位置后单击完成标记；也可以在搜索框里输入关键字来查询，单击搜索结果自动定位到对应的位置，如地址无误直接单击【保存】，如果需要微调，可以在正确位置单击以下，最后单击【保存】。 图7 地址标记 营业时间 仅渠道模式为O+O、POS的店铺才展示此tab，用于设置店铺是否接单、每天的营业时间。 图8 营业时间 默认接单，‘休息中’前面的复选框不勾选；如果勾选则代表店铺当前不接单。 每天的营业时间默认为‘歇业’，单击自定义时间可以设置该天的营业时间段，每天最多设置5个时间段： 图9 自定义时间 单击‘24小时营业’则代表当天24小时都营业。 配送范围 仅渠道模式为O+O的店铺才展示此tab，用于设置店铺的配送区域。 在搜索框里输入关键字来查询，单击搜索结果自动定位到对应的位置。 在地图上每单击一次设置一个多边形的顶点，右键结束绘制。 图10 配送范围 单击多边形每条边中间的圆圈并拖动，可以调整区域的范围： 图11 添加配送区域 配送时间 仅渠道模式为O+O的店铺才展示此tab，用于设置店铺每天的配送时间。 图12 配送时间 每天的配送时间默认为8：00-18:00，可以设置多个配送时间段，每天最多设置5个时间段： 图13 配送时间设置 单击‘歇业’则代表当天不配送。 经营范围 经营类目：用于维护店铺的一级类目资质，商品自动分发时会检查店铺是否拥有该商品的类目资质，有此类目资质才会自动分发，否则不分发。注意：店铺必须同时拥有商品的类目和品牌资质才能自动下发。 页面展示此店铺对应商家已审核通过的一级类目（路径：基础中心-商家管理-类目管理），可以多选，单击【保存】后完成对店铺的资质分配。 图14 经营范围 如果不选择任何类目，默认该店铺拥有对应商家所有的类目资质，以方便管理。 经营品牌：用于维护店铺的品牌资质，商品自动分发时会检查店铺是否拥有该商品的品牌资质，有此品牌资质才会自动分发，否则不分发。注意：店铺必须同时拥有商品的类目和品牌资质才能自动下发。 页面展示此店铺对应商家已审核通过的品牌（路径：基础中心-商家管理-品牌管理），可以多选，单击【保存】后完成对店铺的资质分配。 图15 经营品牌 如果不选择任何品牌，默认该店铺拥有对应商家所有的品牌资质，以方便管理。 店铺设置 设置该店铺的退货地址及供应商店铺映射。 图16 店铺设置 订单退货设置：可以选择按地址退回，也可以设置按仓退回。 图17 退货设置1 选择按仓退回，需要指定仓库（数据来源于商家平台-库存中心-仓库管理） 图18 退货设置2 供应商店铺映射：单击【映射外部店铺】，在弹窗中录入供应商及其店铺ID： 图19 新增供应商 单击【确定】后将映射关系显示在列表中： 图20 供应商店铺映射 单击【编辑】可以修改映射关系： 图21 编辑供应商 单击【删除】可以删除中台店铺和外部店铺的映射关系。

资源和成本规划 表1 资源和成本规划 序号 云服务名称 规格 数量 计费模式 计费周期 计费周期单位 参考价格 1 弹性负载均衡 实例规格类型: 共享型负载均衡 1 按需计费 1 小时 ￥512.00 2 弹性云服务器 Nginx负载均衡 规格: X86计算 | 通用计算增强型 | c6.large.2 | 2核 | 4GB 镜像: CentOS | CentOS 7.9 64bit 系统盘: 高IO | 40GB 数据盘: 高IO | 100GB 1 包周期 1 月 ￥257.50 3 云容器引擎 产品分类: CCE容器集群 | 混合集群 | 50节点 | 是 1 包周期 1 月 ￥1262.40 4 弹性云服务器 规格: X86计算 | 通用计算增强型 | c6.4xlarge.4 | 16核 | 64GB 镜像: CentOS | CentOS 7.9 64bit 系统盘: 高IO | 40GB 数据盘: 高IO | 200GB 1 包周期 1 月 ￥2083.30 5 弹性云服务器 规格: X86计算 | 通用计算增强型 | c6.4xlarge.4 | 16核 | 64GB 镜像: CentOS | CentOS 7.9 64bit 系统盘: 高IO | 40GB 数据盘: 高IO | 200GB 1 包周期 1 月 ￥2083.30 6 弹性云服务器 规格: X86计算 | 通用计算增强型 | c6.4xlarge.4 | 16核 | 64GB 镜像: CentOS | CentOS 7.9 64bit 系统盘: 高IO | 40GB 数据盘: 高IO | 200GB 1 包周期 1 月 ￥2083.30 7 文档数据库服务 性能规格: 社区版 | 副本集 | 三节点 | 通用型 | 2核4GB 存储空间: 超高IO | 100GB 1 包周期 1 月 ￥815.00 8 分布式缓存服务Redis 缓存类型：redis 产品类型：基础版 版本号：5.0 实例类型：Cluster集群 规格：redis.cluster.xu1.large.r2.4 | 规格：4 GB | 分片数：3 | 最大可用内存：4 GB | 最大连接数(默认/可配)：30,000/150,000 | 基准/最大带宽：2,304/2,304 Mbit/s | DB数：1 | 占用IP个数：6 1 包周期 1 月 ￥367.48 9 云搜索服务 规格: X86计算 | 计算密集型 | ess.spec-4u8g | 4核 | 8GB 存储类型: 普通I/O | 100GB 带宽类型: 低带宽 | 1Mbit/s 1 包周期 1 月 ￥667.74 10 分布式消息服务 RabbitMQ版 规格: 集群 | 2u4g.cluster | 代理个数：3 单个代理存储空间: 超高IO | 100GB 1 包周期 1 月 ￥2190.00 11 弹性云服务器 自建注册中心 规格: X86计算 | 通用计算增强型 | c6.large.2 | 2核 | 4GB 镜像: CentOS | CentOS 7.9 64bit 系统盘: 高IO | 100GB 1 包周期 1 月 ￥243.50 12 云数据库 RDS(for MySQL) 规格: MySQL | 5.7 | 主备 | 通用型 | 8核16GB 存储空间: SSD云盘 | 200GB 1 包周期 1 月 ￥1895.00 13 对象存储服务 产品类型: 对象存储 | 标准存储单AZ存储包 | 40GB 1 包周期 1 月 ￥1.00 14 MRS Flink 实例规格通用计算增强型 16 vCPUs | 64 GB | c6.4xlarge.4 数据盘高IO600GBX1 系统盘高IO480GBX1 5 包周期 1 月 ￥13886.50 15 弹性云服务器 Starrocks服务 规格: X86计算 | 通用计算增强型 | c6.xlarge.2 | 4核 | 8GB 镜像: CentOS | CentOS 7.9 64bit 系统盘: 高IO | 40GB 数据盘: 通用型SSD | 100GB 1 包周期 1 月 ￥501.20 16 弹性公网IP 产品类型: 共享 | 按带宽计费 | 5Mbit/s | 1个 1 包周期 1 月 ￥400.00 17 云证书管理服务 服务类型：SSL证书-域名证书 域名类型：泛域名 证书类型：DV-Basic 证书品牌：GeoTrust 有效期：1年 1 包周期 1 年 ￥1484.04 18 NAT网关 规格: 小型 1 包周期 1 月 ￥306.00 19 云解析服务 免费版 1 免费 免费 小时 免费 20 企业主机安全 规格: 企业版 11 包周期 1 月 ￥990.00 21 Anti-DDoS流量清洗 免费版本 1 免费 免费 小时 免费 22 云备份 存储库类型: 云服务器备份存储库 | 2000GB 1 包周期 1 月 ￥400.00