本文档列出了适用于 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 种类型:
- 请求配额
- 发送至 Vision API 端点的每个请求都会计入此配额。
- 功能配额
- 发送至 Vision API 端点的每个图像/文件都会计入此配额。
- 除非另有明确指定,否则以功能名称作为前缀的配额通常就是功能配额。
- “正在处理”配额
- 除非另有明确指定,否则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% 左右)。