本指南概述了不同的 Gemini API 结算选项,说明了如何启用结算和监控使用情况,并提供了有关结算的常见问题解答 (FAQ)。
结算和层级简介
Gemini API 的结算方式取决于您的付款记录。
| 使用层 | 资格赛 | 结算层级上限 |
|---|---|---|
| 免费 | 注册 | 不适用 |
| 第 1 层级 | 有效结算账号 | $250 |
| 第 2 层级支持人员 | 支付 100 美元 + 自首笔成功付款起 3 天 | 2000 美元 |
| 第 3 层级支持人员 | 支付 1,000 美元 + 自首笔成功付款起 30 天 | 20,000 美元至 100,000 美元以上 |
新账号从免费层级开始,该层级允许访问 Gemini API 和 AI Studio 中的特定模型,但不得超过模型的速率限制。
如需使用更高的速率限制、高级模型,并确保您的提示和回答不会用于改进 Google 产品*,您可以关联结算账号,以便升级到付费层级。 您将根据累计支出和账号使用时长升至更高级别。您可以随时取消关联单个 API 密钥,以便将该密钥恢复为免费的 AI Studio 配额。
* 企业级数据隐私保护:如需详细了解付费服务的数据使用情况,请参阅服务条款。
设置结算信息以使用付费层级
您可以在 Google AI Studio 中直接创建项目并设置结算信息,也可以导入现有项目以升级到付费层级,而无需切换到 Google Cloud 控制台。您将立即获得可结算状态,无需支付任何预付款,只需在结算周期结束后为使用的特定资源付费(如需了解详情,请参阅 Cloud 自动结算设置)。
- 前往 AI Studio API 密钥页面(或 AI Studio 中显示“设置结算信息”的任何位置)。
- 新用户默认会获得一个项目和 API 密钥。
- 如果您需要新密钥,请点击创建 API 密钥,然后按照对话框中的说明向表格中添加密钥-项目对。
- 找到要升级到付费层的项目,然后点击配额层列下方的设置结算。
- 如果项目已采用付费层级,您可能会看到升级选项。
- 新用户和现有 Cloud Billing 用户的设置有所不同:
新用户数
此工作流程适用于没有现有 Google 结算账号的用户。
- 按照相应步骤选择项目和 API 密钥以进行设置。
- 在设置 Google Cloud 结算账号窗口中选择您的国家/地区,以同意《服务条款》。
- 如果您有任何与账号相关联的现有支付资料,系统会在添加结算账号详细信息窗口中自动填写您的联系信息和支付方式。点击更改即可修改任一字段。
- 如果您没有现有的支付资料,请点击联系信息和付款方式旁边的 + 按钮,然后按照说明在各自的窗口中填写您的详细信息。
- 点击完成账号设置。
- 下一个窗口会显示您的结算状态。
现有用户
此工作流程适用于之前已为账号设置 Google 结算的用户。
- 按照相应步骤选择项目和 API 密钥以进行设置。
- 在设置 Cloud Billing 账号窗口中,您将看到以下几个选项:
- 如果您有多个结算账号,请点击选择结算账号菜单,然后选择要与所选项目关联的结算账号。
- 如果您只有一个结算账号,系统会自动在菜单中选择该账号。
- 如果您不想使用任何现有账号,请点击菜单下的添加新的结算账号。这会触发新 Cloud Billing 用户部分中的第 3 步。
- 点击完成设置。
- 下一个窗口会显示您的结算状态。
升级到下一个付费层级
如果您目前使用的是付费层级,并且符合方案变更的条件,系统会自动将您升级到下一个层级。
验证结算状态
为付费层级设置结算信息后,系统会立即告知您设置是否成功。您还可以通过 API 密钥页面验证您的 Google Cloud 项目是否已关联到 Google Cloud 结算账号,并已准备好付费使用。配额层级列中可能会显示密钥的结算状态:
- 第 1 级、第 2 级或第 3 级:验证您的项目是否已关联,并且是否可立即结算。
- 需要采取行动:您需要对自己的账号采取行动,例如支付账单、更新付款方式等。
监控用量
您可以在 Google AI Studio 中通过信息中心 > 使用情况来监控 Gemini API 的使用情况。
支出上限
Gemini API 支持在结算账号层级和项目层级设置每月支出上限。这些控制措施旨在保护您的账号免遭意外超额费用,并保护生态系统以确保服务可用性。
项目支出上限
您可以在 AI Studio 中设置自己的项目级支出上限。如果您在同一结算账号下有多个项目,并且希望确保每个项目都有足够的支出限额,此功能会非常有用。
具有项目编辑者、所有者或管理员角色的账号可以在 AI Studio 的支出页面上设置每个项目的支出上限,具体操作为依次点击每月支出上限 > 修改支出上限。
如果您将项目切换到其他结算账号,则为该项目设置的所有支出上限都会保留,但所有累计支出都会在新的结算周期内重置为 0 美元。
批量模式补全仍可能会产生超额费用。
在 AI Studio 中,结算数据的处理时间可能会略有延迟,最多延迟约 10 分钟。如果结算数据在产生更多费用之前尚未处理,您可能会超出项目上限。
结算账号层级支出上限
每个层级都有每月支出限额:
| 使用层 | 支出上限 |
|---|---|
| 免费 | 不适用 |
| 第 1 层级 | $250 |
| 第 2 层级支持人员 | 2000 美元 |
| 第 3 层级支持人员 | 20,000 美元至 100,000 美元 |
系统会在结算账号级别强制执行每月用量上限;这些上限是预设的,无法配置。总支出是所有关联项目的总和;一旦累计总额达到层级限额,相应账号下的所有项目都会暂停服务,直到下一个结算周期(每月)开始。
评估结算账号支出
如需评估历史每月支出,以确定新的结算账号层级支出上限是否会影响您正在进行的项目,请按以下步骤操作:
- 前往 Cloud 控制台中的结算账号管理页面。
- 结算账号概览信息中心会显示当月的总费用;点击该窗口底部的在报告中查看详情。
- 报告默认按“服务”在“当月”进行分组。您将在表格的服务列中看到 Gemini API,并在使用费列中看到总支出。
- 将按使用日期划分的时间范围过滤条件调整为所需的范围,以评估特定时间段内的历史支出。
Cloud Billing
Gemini API 使用 Cloud Billing 来处理结算账号,您可以直接在 AI Studio 中设置结算账号。您可以使用 AI Studio 跟踪支出并了解费用。您可以在 Cloud Billing 账号中访问相同的信息并进行付款。
项目和 API 密钥
您可以在一个结算账号下最多创建 10 个项目,并且一个项目最多可以关联 5 个 API 密钥。
用量层级在结算账号一级适用。结算账号下的所有项目都会继承其配额层级和相关限制。与结算账号关联的所有项目的累计支出和账号使用时长均计入其层级资格条件。
API 密钥是在项目中生成的凭据。它们没有独立的结算设置,而是继承项目的层级限制和结算状态。一个项目内所有密钥的累计使用量都会计入该项目的支出上限和结算账号的总支出。
常见问题解答
以下部分解答了一些常见问题。
系统按什么向我收费?
Gemini API 的价格取决于以下因素:
- 输入 token 数
- 输出 token 数量
- 缓存的 token 数
- 缓存的令牌存储时长
如需了解价格信息,请参阅价格页面。
在哪里可以查看我的配额?
您可以在 AI Studio 或 Google Cloud 控制台中查看配额和系统限制。
如何申请更多配额?
我可以在欧洲经济区 (EEA)(包括欧盟)、英国和瑞士免费使用 Gemini API 吗?
是的,我们会在多个地区提供免费层级和付费层级。
如果我为 Gemini API 设置了结算信息,是否需要为 Google AI Studio 用量付费?
除非用户关联付费 API 密钥以访问付费功能,否则 AI Studio 的使用仍免费。 在 AI Studio 中将付费 API 密钥与付费项目相关联后,您将需要为该密钥的 AI Studio 用量付费。您可以根据需要在 AI Studio 中切换付费层级项目和免费层级项目。
我可以在免费层级中使用 100 万个令牌吗?
Gemini API 的免费层级因所选模型而异。目前,您可以通过以下方式试用 100 万个 token 的上下文窗口:
- 在 Google AI Studio 中
- 随用随付方案
- 部分型号可免费使用
如何计算我使用的令牌数量?
使用 GenerativeModel.count_tokens 方法统计令牌数量。如需详细了解令牌,请参阅令牌指南。
我可以使用 Google Cloud 欢迎赠金来使用 Gemini API 吗?
不能。Google Cloud 欢迎赠金或免费试用赠金不能用于 Gemini API 或 AI Studio。
如果您在 Google Cloud 欢迎赠金失效之前获得了该赠金,则可以在 90 天的有效期内将剩余赠金用于 Gemini API 和 AI Studio。
如何结算?
Gemini API 的结算由 Cloud 结算系统处理。如需了解自动结算设置,请参阅 Cloud 结算文档。
我需要为失败的请求付费吗?
如果您的请求因 400 或 500 错误而失败,您无需为所用的令牌付费。不过,相应请求仍会占用您的配额。
GetTokens 是否已结算?
对 GetTokens API 的请求不会产生费用,也不会计入推理配额。
如果我拥有付费 API 账号,Google AI Studio 数据会如何处理?
如需详细了解启用 Cloud 结算后数据的处理方式,请参阅服务条款(请参阅“付费服务”下的“Google 如何使用您的数据”)。请注意,只要至少有 1 个 API 项目已启用结算功能,您的 Google AI Studio 提示就会按照相同的“付费服务”条款进行处理。您可以在 Gemini API 密钥页面上验证这一点,如果看到任何项目在“方案”下标记为“付费”,则表示至少有 1 个 API 项目已启用结算功能。
在哪里可以获得结算方面的帮助?
如需有关结算的帮助,请参阅获取 Cloud Billing 支持。