速率限制和配额

点击您的 Gemini API 提供商，以查看此页面上特定于提供商的内容和代码。


速率限制（通常称为配额）用于限制您在给定时间范围内可以向 Gemini API 发出的请求数。这些限制有助于确保公平使用、防范滥用行为，并帮助所有用户维持系统性能。

使用 Firebase AI Logic 向 Gemini 和 Imagen 模型发送请求时，项目的速率限制取决于您选择的“Gemini API”提供方。Firebase AI Logic 还提供了一种设置“每用户”速率限制的方法。

查看 Gemini Developer API 的速率限制

速率限制（配额）的运作方式

速率限制（配额）从以下四个维度进行衡量：

  • 每分钟请求数 (RPM)
  • 每天的请求数 (RPD)
  • 每分钟 token 数 (TPM)
  • 每天的令牌数 (TPD)

系统会根据每项限制评估您的用量，如果超出任何一项限制，系统都会触发 429 配额超出错误。例如，如果您的 RPM 限额为 20，那么即使您未超出 TPM 或其他限额，在一分钟内发出 21 个请求也会导致错误。

速率限制应用于项目级，并适用于使用相应 Firebase 项目的所有应用和 IP 地址。

限制因所用特定模型而异，并且部分限制仅适用于特定模型。例如，每分钟生成的图片数 (IPM) 仅针对能够生成图片 (Imagen 3) 的模型计算，但在概念上与 TPM 类似。

实验性模型和预览版模型的速率限制更为严格。

申请提高速率限制

如果您使用的是 Gemini Developer API 的“付费层级”，则可以申请提高速率限制。

设置“每位用户”的速率限制

如需使用 Firebase AI Logic，您的项目需要启用所选的 Gemini API 提供方，但您还需要启用 Firebase AI Logic API，该 API 可充当我们的客户端 SDK 与您的 Gemini API 提供方之间的网关。当您在 Firebase 项目中首次设置 Firebase AI Logic 时，系统会为您启用此 API。

您可以将 Firebase AI Logic API 速率限制（配额）用作应用的“每用户”速率限制，特别是对于依赖于 Firebase AI Logic 的 AI 功能。您应设置此限制，以便合理满足单个用户访问 AI 功能的需求，同时确保没有单个用户超出 Gemini API 提供商的限制（该限制应适用于所有用户）。

有关“每位用户”速率限制的详细信息

以下是有关 Firebase AI Logic API 速率限制（配额）的一些重要详细信息，具体而言，是指每分钟请求数 (RPM)：

  • 它基于“内容生成请求”，按每位用户每分钟在每个区域的请求数计算，不基于模型。

  • 它在项目级应用，适用于使用相应 Firebase 项目的所有应用和 IP 地址。

  • 它适用于专门来自任何 Firebase AI Logic SDK 的任何调用。

  • 默认速率限制为每位用户每分钟 100 次。
    请注意，您仍需考虑Gemini API提供商的限制（见上文），这些限制优先于 Firebase AI Logic API。

调整“每位用户”的速率限制

如需调整速率限制（配额），您必须拥有 serviceusage.quotas.update 权限，该权限默认包含在 Owner 和 Editor 角色中。

以下是修改速率限制（配额）或申请增加配额的方法：

  1. 在 Google Cloud 控制台中，前往 Firebase AI Logic API 的页面。

  2. 点击管理。

  3. 在页面下方，点击配额和系统限制标签页。

  4. 过滤表格以显示您感兴趣的配额，例如功能（生成内容的请求）和区域。

    例如，如需查看任何受支持的亚洲区域中生成内容请求的单用户配额，您的过滤条件应类似于以下内容：Generate content requests + Dimension:region:asia

  5. 选中您感兴趣的每个配额左侧的复选框。

  6. 在相应配额的行末尾，点击 ，然后选择修改配额。

  7. 在配额更改表单中，执行以下操作：

    1. 在新值字段中输入增加的配额。

      此配额适用于项目级，并由使用相应 Firebase 项目的所有应用和 IP 地址共享。

    2. 填写表单中的任何其他字段，然后点击完成。

    3. 点击提交请求。