云服务器内容精选

  • 请求示例 请求示例(文本翻译) 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(); } }
  • 响应消息 响应参数说明请参见表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." }
  • 功能介绍 文本翻译是为了实现语种间的转换。对于用户输入原始语种的文本,转换为目标语种的文本。本接口不支持对文档进行翻译,文档翻译请见文档翻译任务创建。 文本翻译支持一次性提交多个任务,服务会根据资源排队处理。 文本翻译接口具体Endpoint请参见终端节点。 调用华为云NLP服务会产生费用,本API按字符数阶梯计费,文本翻译不支持套餐包抵扣,用户可以在 自然语言处理 价格计算器价格详情页了解具体计费说明。 本API调用限制为20次/秒。
  • 请求消息 请求参数说明请参见表2。 表2 请求参数说明 参数名 参数类型 必选 说明 text String 是 待翻译文本,仅支持utf-8编码,长度不超过2000字符。一个汉字、英文字母、标点符号等,均计为一个字符。 from String 是 翻译原语言,具体取值见表3。 to String 是 翻译目标语言,具体取值见表3。 scene String 否 默认为“common”,当前只有通用场景。 表3 文本翻译支持的语言列表 语种名称 语言代码 阿拉伯语 ar 德语 de 俄语 ru 法语 fr 韩语 ko 葡萄牙语 pt 日语 ja 泰语 th 土耳其语 tr 西班牙语 es 英语 en 越南语 vi 中文(简体) zh 自动检测输入语种并翻译成目标语种,您需要指定目标语种。 auto
  • 欠费 按需购买的接口是按照API调用次数阶梯价格计费,当余额不足,无法对当前产生费用进行扣费,就会导致欠费,欠费后有保留期。您续费后可继续正常使用,请注意在保留期进行的续费,是以原到期时间作为生效时间,您应当支付从进入保留期开始到续费时的服务费用。 您账号欠费后,会导致部分操作受限,建议您尽快续费。具体受限操作如下所示: 按需方式的API接口不可调用 不可重置套餐包方式的API接口,例如“10万次基础套餐包”,在欠费后如果套餐包有剩余,可继续使用,但不可购买,也不可续期 每日或每月可重置套餐包方式的API接口,例如“每月20000次基础套餐包”,在调用超过每日或每月限额导致欠费,会进入保留期,保留期后会被冻结,无法使用该套餐包 无法开通服务
  • 首次使用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服务且初次体验的使用者。 适用于可预估资源使用周期的场景,价格比按需计费模式更优惠。对于长期使用者,推荐该方式。 适用于计算资源需求波动的场景,可以随时开通。 父主题: 计费模式