配额和限制

本文档列出了适用于 Cloud Vision 的配额和限制。quotasquotas

配额用于限制您的 Google Cloud 项目可使用的共享 Google Cloud 资源（包括硬件、软件和网络组件）的数量。因此，有以下功能的系统具有配额：

  • 监控 Google Cloud 产品和服务的使用情况或消耗情况。
  • 出于某些原因限制这些资源的消耗量，包括确保公平性和减少使用量高峰。
  • 维护可自动强制执行规定限制的配置。
  • 提供请求或更改配额的方法。

在大多数情况下，当超过配额时，系统会立即阻止对相关 Google 资源的访问，并且您尝试执行的任务将失败。在大多数情况下，配额适用于每个 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
异步文档文本检测† 正在处理的页面数量 “正在处理”配额 10,000
* 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% 左右）。