配额和限制

本文档列出了适用于 Cloud Vision 的配额和系统限制。配额用于指定您可以使用的可计数共享资源的数量，由 Cloud Vision 等 Google Cloud 服务定义。系统限制是无法更改的固定值。

Google Cloud 使用配额来帮助确保公平性并减少资源使用和可用性的激增。配额用于限制您的 Google Cloud 项目可使用的 Google Cloud 资源的数量。配额适用于一系列资源类型，包括硬件、软件和网络组件。例如，配额可以限制对某项服务的 API 调用次数、您的项目并发使用的负载均衡器数量或者您可以创建的项目数量。配额可以防止服务过载，从而保护 Google Cloud 用户社区。配额还可帮助您管理自己的 Google Cloud 资源。

Cloud 配额系统执行以下操作：

  • 监控 Google Cloud 产品和服务的消耗情况
  • 限制这些资源的消耗量
  • 提供请求更改配额值的方法

在大多数情况下，当您尝试消耗的资源超出其配额允许的范围时，系统会阻止对资源的访问，并且您尝试执行的任务会失败。

配额通常在 Google Cloud 项目级层应用。您在一个项目中使用资源不会影响您在另一个项目中的可用配额。在 Google Cloud 项目中，配额在所有应用和 IP 地址间共享。

如需调整大多数配额，请使用 Google Cloud 控制台。如需了解详情，请参阅申请更高的配额。

Vision 资源也有系统限制。这些系统限制与配额系统无关。除非另有说明，否则无法更改系统限制。

配额类型

配额分为 3 种类型：

  1. 请求配额
    • 发送至 Vision API 端点的每个请求都会计入此配额。
  2. 功能配额
    • 发送至 Vision API 端点的每个图像/文件都会计入此配额。
    • 除非另有明确指定，否则以功能名称作为前缀的配额通常就是功能配额。
  3. “正在处理”配额
    • 除非另有明确指定，否则Vision API 处理的每个图像/文件都会计入此配额。
    • 可以通过配额名称中的“正在处理”字样推断其属于这种类型的配额。
    • 此配额决定了在异步方法中 Vision API 一次可以处理的图片/页面数上限。用户可以在异步方法中发送超出此配额的图片/页面数量，但系统不会立即处理超出配额的图片/页面。超出配额的文件将添加到队列中，以便稍后处理。

Vision API 的当前 API 用量配额如下（可能会更改）：

Vision API 配额 配额类型 值
每分钟的请求数（下文列出的请求类型除外） 请求配额 1800
每分钟名人识别请求数 请求配额 零
每分钟的标签检测请求数 功能配额 1800
每分钟的文本检测请求数 功能配额 1800
异步图片注释* 正在处理的图片数量 “正在处理”配额 8000
异步文档文本检测† 正在处理的页面数量 “正在处理”配额 10000
* images:asyncBatchAnnotate 请求
† files:asyncBatchAnnotate 请求，DOCUMENT_TEXT_DETECTION 功能
Product Search 配额 值
每分钟的请求数（下文列出的请求类型除外） 1800
每天的批量请求数 300
每分钟的资源管理写入请求数 1200
每分钟的资源管理请求数 2400

这些限额适用于每个 Google Cloud 控制台项目，并由使用该项目的所有应用和 IP 地址共享。

您可以在 Google Cloud 控制台中为各个用户分别设置较低的配额。

增加配额

您可以在不超过相应上限值的前提下修改配额，方法是从 Google Cloud 控制台页面的配额页面选择修改配额。如果您要申请将配额增加到超过其上限的水平，请修改配额并输入要申请增加的额度和相关理由，然后提交您的更新信息。我们会在收到申请后通知您，并且可能会与您联系以详细了解您的申请。 审核完成后，无论您的申请是得到批准还是被拒绝，我们都会通知您。

通常，每个配额都包含“每个用户的每个项目”和“每个项目”变体，请根据您的设置相应调整。

在申请增加配额时，请考虑整体请求配额和预期批次大小，以确保符合以下条件：

  • 整体请求配额（每分钟请求数）* 您的批次大小 >= 增加后的功能配额

如果未满足此要求，您仍会受限于整体请求配额。

本文档介绍 Vision API 的当前内容限制和请求配额。如果这些限制和用量限额发生任何更改，我们会相应地更新本页面以反映这些更改。

限制

Vision API 实施以下用量限额：

内容限制 值
图片文件大小 20 MB
JSON 请求对象大小 10 MB
PDF 文件大小 1 GB
每个 images:annotate 请求的图片数 16
每个 images:asyncBatchAnnotate 请求的图片数 2000
每个 files:annotate 请求的页面数 5
每个 files:asyncBatchAnnotate 请求的页面数 2000

采用 Base64 编码的图片，即使没有超出图片文件大小限制，也可能会超出 JSON 大小限制。较大的图片应托管在 Cloud Storage 或可公开访问的网址中。请注意，采用 Base64 编码的图片文件大小可能会超出原始图片文件的大小（通常会超出 37% 左右）。