本文列出 Cloud Vision 的配額和系統限制。
- 配額會指定您可使用的可計數共用資源數量。配額是由 Google Cloud 服務 (例如 Cloud Vision) 定義。
- 系統限制為固定值,無法變更。
Google Cloud 會使用配額來確保公平性,並減少資源使用量和可用性的尖峰情形。配額會限制 Google Cloud 專案可使用的Google Cloud 資源數量。配額適用於多種資源類型,包括硬體、軟體和網路元件。舉例來說,配額可以限制向服務發出的 API 呼叫數、專案並行使用的負載平衡器數量,或可建立的專案數量。限制配額可預防服務超載,進而保障Google Cloud 使用者社群的權益。配額也能協助您管理自己的 Google Cloud 資源。
Cloud 配額系統會執行以下作業:
在大多數情況下,如果您嘗試使用的資源超過配額限制,系統會封鎖對該資源的存取權,而您要執行的任務也會失敗。
配額通常會套用至 Google Cloud 專案層級。您在一個專案中使用資源,不會影響其他專案的可用配額。在 Google Cloud 專案中,所有應用程式和 IP 位址都會共用配額。
如要調整大部分配額,請使用 Google Cloud 控制台。詳情請參閱「要求調整配額」。
視覺資源也有系統限制。系統限制無法變更。
配額類型
配額分為 3 種:
- 要求配額
- 實際傳送至 Vision API 端點的每項要求都會耗用配額。
- 功能配額
- 實際傳送至 Vision API 端點的每個圖片 / 頁面都會耗用配額。
- 除非另有指定,否則前置字串含有功能名稱的配額通常都屬於功能配額。
- 針對
files:annotate
要求,如果未明確指定pages
欄位,系統會將每個檔案計入 5 個頁面。不過,系統只會根據實際處理的頁面數量向使用者收費。
- 處理中配額
- 除非另有指定,否則 Vision API 正在處理的每個圖片 / 頁面都會耗用配額。
- 如果配額名稱中包含「處理中」的字樣,即為處理中配額。
- 這項配額會決定 Vision API 一次處理非同步方法的圖片/頁面數量上限。使用者可以將超過此配額的圖片/網頁傳送至非同步方法,但超過配額的圖片/網頁不會立即處理。超出配額的檔案會加入佇列,以便稍後處理。
Vision API 目前的 API 使用配額如下 (日後可能會有所調整):
Vision API 配額 | 配額類型 | 值 |
---|---|---|
每分鐘要求數 (下列要求類型除外) | 要求配額 | 1,800 |
每分鐘名人辨識要求數 | 要求配額 | 0 |
每分鐘的標籤偵測要求數 | 功能配額 | 1,800 |
每分鐘的文字偵測要求數 | 功能配額 | 1,800 |
非同步圖片加註* (以處理圖片數量計算) | 處理中配額 | 8,000 |
非同步文件文字偵測† (以處理頁數計算) | 處理中配額 | 10,000 |
* | images:asyncBatchAnnotate 要求
|
† | files:asyncBatchAnnotate 要求、DOCUMENT_TEXT_DETECTION 功能 |
Product Search 配額 | 值 |
---|---|
每分鐘要求數 (下列要求類型除外) | 1,800 |
每日批次要求數 | 300 |
每分鐘資源管理寫入要求數 | 1,200 |
每分鐘資源管理要求數 | 2,400 |
這些限制適用於每個 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%)。