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