配额和限制

本文档列出了适用于 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
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% 左右)。