华为云用户手册

响应示例 状态码： 200 OK { "entity" : { "id" : "8039469283414000536", "label" : "人物", "properties" : { "职业" : [ "演员，歌手" ], "出生日期" : [ "1980年12月13日" ], "name" : [ "计广" ], "国籍" : [ "中国" ] } }, "results" : [ { "direction" : "IN", "adjacent_entity_id" : "8886811463068384992", "edge" : { "source_id" : "8886811463068384992", "target_id" : "8039469283414000536", "relation_label" : "主演", "properties" : null } }, { "direction" : "IN", "adjacent_entity_id" : "7146030181767445493", "edge" : { "source_id" : "7146030181767445493", "target_id" : "8039469283414000536", "relation_label" : "主演", "properties" : null } } ], "total" : 20, "count" : 2}

请求示例 查询关联实体，最多返回两条结果 https://nlp-ext.cn-north-4.myhuaweicloud.com/v1/1604d8170cd84440a81281e5a3a04f8b/kg/kg-instances/6cdcea01-bac0-48f6-acb5-9385ea3e24ad/entities/8039469283414000536/adjacent-entities?offset=0&limit=2

终端节点 终端节点即调用API的请求地址，不同服务不同区域的终端节点不同，您可以从地区和终端节点中查询所有服务的终端节点。 知识图谱服务 的终端节点如表1所示，请您根据业务需要选择对应区域的终端节点。 表1 知识图谱 的终端节点 区 域名 称 区域 终端节点（Endpoint） 华北-北京四 cn-north-4 nlp-ext.cn-north-4.myhuaweicloud.com 父主题： 使用前必读

Token认证 Token的有效期为24小时，需要使用一个Token鉴权时，可以先缓存起来，避免频繁调用。 Token在计算机系统中代表令牌（临时）的意思，拥有Token就代表拥有某种权限。Token认证就是在调用API的时候将Token加到请求消息头，从而通过身份认证，获得操作API的权限。 Token可通过调用获取用户Token接口获取，调用本服务API需要project级别的Token，即调用获取用户Token接口时，请求body中auth.scope的取值需要选择project，如下所示。 获取用户Token接口请求构造如下，您可以从接口的请求部分看到所需的请求参数及参数说明。 获取Token 消息头只需填写“Content-Type”。将消息体加入后的请求如下所示，加粗的斜体字段需要根据实际值填写，其中usernam用户名，domainname为用户所属的账号名称，********为用户登录密码。 获取Token的终端节点和projectname需与KG服务终端节点保持一致。当访问华北-北京四的终端节点（即nlp-ext.cn-north-4.myhuaweicloud.com时），获取Token请使用终端节点https://iam.cn-north-4.myhuaweicloud.com，projectname对应使用cn-north-4。 POST https://iam.cn-north-4.myhuaweicloud.com/v3/auth/tokens Content-Type: application/json { "auth": { "identity": { "methods": [ "password" ], "password": { "user": { "name": "username", "password": "********", "domain": { "name": "domainname" } } } }, "scope": { "project": { "name": "xxxxxxxx" } } } } 获取Token后，再调用其他接口时，您需要在请求消息头中添加“X-Auth-Token”，其值即为Token。例如Token值为“ABCDEFJ....”，则调用接口时将“X-Auth-Token: ABCDEFJ....”加到请求消息头即可，如下所示。 GET https://iam.cn-north-1.myhuaweicloud.com/v3/auth/projects Content-Type: application/json X-Auth-Token: ABCDEFJ.... 您还可以通过视频教程了解如何使用Token认证。

请求消息头 附加请求头字段，如指定的URI和HTTP方法所要求的字段。例如定义消息体类型的请求头“Content-Type”，请求鉴权信息等。 如下公共消息头需要添加到请求中。 Content-Type：消息体的类型（格式），必选，默认取值为“application/json”，有其他取值时会在具体接口中专门说明。 X-Auth-Token：用户Token，可选，当使用Token方式认证时，必须填充该字段。用户Token也就是调用获取用户Token接口的响应值，该接口是唯一不需要认证的接口。 公有云API同时支持使用AK/SK认证，AK/SK认证是使用SDK对请求进行签名，签名过程会自动往请求中添加Authorization（签名认证信息）和X-Sdk-Date（请求发送的时间）请求头。 AK/SK认证的详细说明请参见AK/SK认证。 X-Project-ID：子项目ID，可选，在多项目场景中使用。 X-Domain-ID：账号ID。 对于获取用户Token接口，由于不需要认证，所以只添加“Content-Type”即可，添加消息头后的请求如下所示。 POST https://iam.cn-north-1.myhuaweicloud.com/v3/auth/tokens Content-Type: application/json

请求方法 HTTP请求方法（也称为操作或动词），它告诉服务你正在请求什么类型的操作。 GET：请求服务器返回指定资源。 PUT：请求服务器更新指定资源。 POST：请求服务器新增资源或执行特殊操作。 DELETE：请求服务器删除指定资源，如删除对象等。 HEAD：请求服务器资源头部。 PATCH：请求服务器更新资源的部分内容。当资源不存在的时候，PATCH可能会去创建一个新的资源。 在获取用户Token的URI部分，您可以看到其请求方法为“POST”，则其请求为。 POST https://iam.cn-north-1.myhuaweicloud.com/v3/auth/tokens

请求URI 请求URI由如下部分组成。 {URI-scheme} :// {Endpoint} / {resource-path} ? {query-string} 尽管请求URI包含在请求消息头中，但大多数语言或框架都要求您从请求消息中单独传递它，所以在此单独强调。 URI-scheme：表示用于传输请求的协议，当前所有API均采用HTTPS协议。 Endpoint：指定承载REST服务端点的服务器域名或IP，不同服务不同区域的Endpoint不同，您可以从地区和终端节点中获取终端节点。例如 IAM 服务在“华北-北京一”区域的Endpoint为“iam.cn-north-1.myhuaweicloud.com”。 resource-path：资源路径，也即API访问路径。从具体API的URI模块获取，例如“获取用户Token”API的resource-path为“/v3/auth/tokens”。 query-string：查询参数，是可选部分，并不是每个API都有查询参数。查询参数前面需要带一个“？”，形式为“参数名=参数取值”，例如“limit=10”，表示查询不超过10条数据。 例如您需要获取IAM在“华北-北京一”区域的Token，则需使用“华北-北京一”区域的Endpoint（iam.cn-north-1.myhuaweicloud.com），并在获取用户Token的URI部分找到resource-path（/v3/auth/tokens），拼接起来如下所示。 https://iam.cn-north-1.myhuaweicloud.com/v3/auth/tokens 图1 URI示意图 为查看方便，在每个具体API的URI部分，只给出resource-path部分，并将请求方法写在一起。这是因为URI-scheme都是HTTPS，而Endpoint在同一个区域也相同，所以简洁起见将这两部分省略。

请求消息体 请求消息体通常以结构化格式发出，与请求消息头中Content-type对应，传递除请求消息头之外的内容。如果请求消息体中参数支持中文，则中文字符必须为UTF-8编码。 每个接口的请求消息体内容不同，也并不是每个接口都需要有请求消息体（或者说消息体为空），GET、DELETE操作类型的接口就不需要消息体，消息体具体内容需要根据具体接口而定。 对于获取用户Token接口，您可以从接口的请求部分看到所需的请求参数及参数说明。将消息体加入后的请求如下所示，加粗的斜体字段需要根据实际值填写，其中username为用户名，domainname为用户所属的账号名称，********为用户登录密码，xxxxxxxxxxxxxxxxxx为project的ID，获取方法请参见获取项目ID。 scope参数定义了Token的作用域，上面示例中获取的Token仅能访问project下的资源。您还可以设置Token作用域为某个账号下所有资源或账号的某个project下的资源，详细定义请参见获取用户Token。 POST https://iam.cn-north-1.myhuaweicloud.com/v3/auth/tokens Content-Type: application/json { "auth": { "identity": { "methods": [ "password" ], "password": { "user": { "name": "username", "password": "********", "domain": { "name": "domainname" } } } }, "scope": { "project": { "id": "xxxxxxxxxxxxxxxxxx" } } } } 到这里为止这个请求需要的内容就具备齐全了，您可以使用curl、Postman或直接编写代码等方式发送请求调用API。对于获取用户Token接口，返回的响应消息头中“x-subject-token”就是需要获取的用户Token。有了Token之后，您就可以使用Token认证调用其他API。

系统内置模板 当用户问题对应的匹配模板的类型为系统内置模板（SYS_TEMPLATE）时，可参考系统内置模板列表。 表1 系统内置模板列表 模板 举例说明 实体名称 月光宝盒 xx实体 + 呢 月光宝盒呢 xx实体 的 xx属性 月光宝盒的上映时间 xx实体属性 + 呢 上映时间呢 xx属性 是 xx值 的 xx实体类型 票房是10亿的电影 xx实体 的 xx关系（正向一跳关系） 月光宝盒的导演 xx实体 的 xx关系（正向一跳关系）+ 概念限制 月光宝盒的导演是哪个人物 xx实体 和 xx实体 的关系 月光宝盒和沈振的关系 xx实体 的 xx关系 的 xx属性（正向一跳关系的属性） 月光宝盒的导演的出生日期 xx实体 的 xx关系（反向一跳关系） 沈振导演了什么 xx实体 的 xx关系（反向一跳关系）+ 概念限制 沈振导演了什么电影 xx实体 的 xx关系 的 xx关系（正向二跳关系） 沈振导演的电影的主演是谁 上一个实体 的 xx属性 它的上映日期 上一个实体 的 xx关系（正向） 他主演的电影 上一个实体 的 xx关系 的 xx关系（正向二跳关系） 她导演的电影的主演 上一个实体 和 xx实体 的关系 它和月光宝盒的关系 上一个实体 的 xx关系 的 xx属性（正向一跳关系的属性） 他主演的电影的上映时间 父主题： 附录

状态码 正常状态码 返回值 说明 200 OK 请求成功。 201 Created 请求成功，资源已创建。 204 No Content 请求成功，返回体无内容。 异常状态码 返回值 说明 400 Bad Request 请求错误。 401 Unauthorized 鉴权失败。 403 Forbidden 没有操作权限。 500 Internal Server Error 服务内部错误。 503 Service Unavailable 服务不可用。 父主题： 附录

请求示例 搜索不止英雄的票房，返回100条结果 https://nlp-ext.cn-north-4.myhuaweicloud.com/v1/1604d8170cd84440a81281e5a3a04f8b/kg/kg-instances/6cdcea01-bac0-48f6-acb5-9385ea3e24ad/apps/query{ "query" : "不止英雄的票房", "limit" : 100}

响应示例 状态码： 200 OK { "total" : 2, "entities" : [ { "name" : "不止英雄", "score" : 1, "id" : "6751625866271911141", "label" : "电影", "properties" : { "票房" : "19.50亿" } }, { "name" : "乱世出英雄", "score" : 0.137613, "id" : "4861731593422907967", "label" : "电影", "properties" : { "上映时间" : "1965年1月4日", "票房" : "5.40亿" } } ]} 状态码： 400 Bad Request { "error_code" : "KGP.2001", "error_msg" : "Kg not found"} 状态码： 403 Forbidden { "error_code" : "KGP.0004", "error_msg" : "Auth failed"} 状态码： 500 Internal Server Error { "error_code" : "KGP.9001", "error_msg" : "Internal server error."}

响应消息体 响应消息体通常以结构化格式返回，与响应消息头中Content-type对应，传递除响应消息头之外的内容。 对于获取用户Token接口，返回如下消息体。为篇幅起见，这里只展示部分内容。 { "token": { "expires_at": "2019-02-13T06:52:13.855000Z", "methods": [ "password" ], "catalog": [ { "endpoints": [ { "region_id": "cn-north-1", ...... 当接口调用出错时，会返回错误码及错误信息说明，错误响应的Body体格式如下所示。 { "error_msg": "The format of message is error", "error_code": "AS.0001" } 其中，error_code表示错误码，error_msg表示错误描述信息。

应用场景1：通过API调用发送短信 图1 业务流程 入驻华为云 注册华为账号 并开通华为云：点击注册页面，详细操作请参考注册华为账号并开通华为云。 企业实名认证：点击进行实名认证 申请短信签名 短信签名是指短信发送方的署名，标识发送方的身份。单击查看申请短信签名。 申请短信模板 短信模板是指短信发送方发送短信时使用的内容模板。单击查看申请短信模板。 购买短信服务 如何订购IoT云通信套餐包：体验套餐包/国内短信套餐包购买，点击查看产品购买。 注：购买短信包之后，可根据业务需要按需使用短信。 开通接入 购买短信服务后，进入开通接入页面，详情请参见开通接入。 发送短信 通过API调用进行短消息发送。 根据是否收到状态报告判断短信发送是否成功。 查看短信发送状态 用户可以在控制台界面，申请状态报告接收，查看短信发送的状态。 业务统计 用户可以在控制台界面，查看剩余短信明细、发送量统计信息。

应用场景2：通过群发助手发送短信 图2 业务流程 入驻华为云 注册华为账号并开通华为云：点击注册页面，详细操作请参考注册华为账号并开通华为云。 企业实名认证：点击进行实名认证 申请短信签名 短信签名是指短信发送方的署名，标识发送方的身份。单击查看申请短信签名。 申请短信模板 短信模板是指短信发送方发送短信时使用的内容模板。单击查看申请短信模板。 购买短信服务 如何订购IOT云通信套餐包：体验套餐包/国内短信套餐包购买，点击查看产品购买。 注：购买短信包之后，可根据业务需要按需使用短信。 开通接入 购买短信服务后，进入开通接入页面，详情请参见开通接入。 群发助手 群发助手是指通过控制台选择短信签名和短信模板创建群发任务，在指定的时间对指定的手机号码下发短信。使用方法可参见群发助手。 注：群发助手支持“验证码/通知”和“营销推广”类型短信发送。 查看发送状态 通过“群发助手”进行短信群发，用户可以在控制台界面，查看群发任务的号码数量、任务状态等信息。 业务统计 用户可以在控制台界面，查看剩余短信明细、发送量统计信息。

什么是区域、可用区？ 区域和可用区用来描述数据中心的位置，您可以在特定的区域、可用区创建资源。 区域（Region）：从地理位置和网络时延维度划分，同一个Region内共享弹性计算、块存储、对象存储、VPC网络、弹性公网IP、镜像等公共服务。Region分为通用Region和专属Region，通用Region指面向公共租户提供通用云服务的Region；专属Region指只承载同一类业务或只面向特定租户提供业务服务的专用Region。 可用区（AZ，Availability Zone）：一个AZ是一个或多个物理数据中心的集合，有独立的风火水电，AZ内逻辑上再将计算、网络、存储等资源划分成多个集群。一个Region中的多个AZ间通过高速光纤相连，以满足用户跨AZ构建高可用性系统的需求。 图1阐明了区域和可用区之间的关系。 图1 区域和可用区 目前，华为云已在全球多个地域开放云服务，您可以根据需求选择适合自己的区域和可用区。更多信息请参见华为云全球站点。

如何选择区域？ 选择区域时，您需要考虑以下几个因素： 地理位置 一般情况下，建议就近选择靠近您或者您的目标用户的区域，这样可以减少网络时延，提高访问速度。 在除中国大陆以外的亚太地区有业务的用户，可以选择“中国-香港”、“亚太-曼谷”或“亚太-新加坡”区域。 在非洲地区有业务的用户，可以选择“非洲-约翰内斯堡”区域。 在拉丁美洲地区有业务的用户，可以选择“拉美-圣地亚哥”区域。 “拉美-圣地亚哥”区域位于智利。 资源的价格 不同区域的资源价格可能有差异，请参见华为云服务价格详情。

支持的浏览器有哪些？ 各服务/组件对浏览器的兼容性如表1和表2所示。 L代表last，L3-产品版本上线时最新的3个稳定浏览器版本。 如果您当前使用的浏览器版本过低，将在一定程度上影响页面的显示效果，建议您尽快对浏览器进行升级。 如果您当前使用的浏览器不支持访问管理控制台，建议您对浏览器进行升级或安装支持的浏览器。 表1 PC端浏览器兼容性一览表 浏览器类型 版本 操作系统 兼容性 Microsoft Edge L3 Windows 10 完全兼容。 Mozilla Firefox L2 Windows 10 部分兼容。 能确保基本交互操作，但在视觉、交互效果上可能存在兼容性问题。 Google Chrome L3 Windows 10 完全兼容。 L3 CentOS 7+ 部分兼容。 能确保基本交互操作，但在视觉、交互效果上可能存在兼容性问题。 L3 Ubuntu 14.04 LTS+ 部分兼容。 能确保基本交互操作，但在视觉、交互效果上可能存在兼容性问题。 L3 MAC OS 10+ 部分兼容。 能确保基本交互操作，但在视觉、交互效果上可能存在兼容性问题。 Safari L2 MAC OS 10+ 部分兼容。 能确保基本交互操作，但在视觉、交互效果上可能存在兼容性问题。 表2 移动端浏览器兼容性一览表 浏览器类型 版本 操作系统 兼容性 Chrome L3 Android 完全兼容。 Safari L3 IOS 完全兼容。 UC浏览器 L3 Android 完全兼容。 QQ浏览器 L3 Android 完全兼容。 360浏览器 L3 Android 完全兼容。 百度浏览器 L3 Android 完全兼容。 华为浏览器 L3 Android 完全兼容。

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

变更计费模式概述 在开通 自然语言处理 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~一百万字符（含）：免费 一百万~五千万字符（含）：按照元/百万字符计费 五千万~一亿字符（含）：按照元/百万字符计费 大于一亿：按照元/百万字符计费 请参见自然语言处理价格详情中的“文本翻译按需付费价格”表。 基础套餐包 按照选择不同调用次数的基础套餐包的数量进行计费，包括分词、命名实体识别（基础版）、文本相似度（基础版）、句向量、文本摘要、情感分析（基础版）、文本分类、意图理解、关键词抽取、语种识别、文档分类。 折扣套餐包 不同调用次数的基础套餐包单价 * 套餐包数量 请参见自然语言处理价格详情中的“基础版按需套餐包”表。 领域套餐包 按照选择不同调用次数的领域套餐包的数量进行计费，包括命名实体识别（领域版）、情感分析（领域版）、属性级情感分析（领域版）。 不同调用次数的领域套餐包单价 * 套餐包数量 请参见自然语言处理价格详情中的“领域版按需套餐包”表。

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

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

计费周期 套餐包自然语言处理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。

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

场景示例：核对资源用量是否与实际相符 假设用户在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元。 优惠金额 用户使用云服务享受折扣优惠如商务折扣、伙伴授予折扣以及促销优惠等减免的金额。基于官网价的优惠金额。 应付金额 用户使用云服务享受折扣优惠后需要支付的费用金额。

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