配額與限制

本文列出 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 種:

  1. 要求配額
    • 實際傳送至 Vision API 端點的每項要求都會耗用配額。
  2. 功能配額
    • 實際傳送至 Vision API 端點的每個圖片 / 頁面都會耗用配額。
    • 除非另有指定,否則前置字串含有功能名稱的配額通常都屬於功能配額。
    • 針對 files:annotate 要求,如果未明確指定 pages 欄位,系統會將每個檔案計入 5 個頁面。不過,系統只會根據實際處理的頁面數量向使用者收費。
  3. 處理中配額
    • 除非另有指定,否則 Vision API 正在處理的每個圖片 / 頁面都會耗用配額。
    • 如果配額名稱中包含「處理中」的字樣,即為處理中配額。
    • 這項配額會決定 Vision API 一次處理非同步方法的圖片/頁面數量上限。使用者可以將超過此配額的圖片/網頁傳送至非同步方法,但超過配額的圖片/網頁不會立即處理。超出配額的檔案會加入佇列,以便稍後處理。

Vision API 目前的 API 使用配額如下 (日後可能會有所調整):

Vision API 配額 配額類型
每分鐘要求數 (下列要求類型除外) 要求配額 1,800
每分鐘名人辨識要求數 要求配額 0
每分鐘的標籤偵測要求數 功能配額 1,800
每分鐘的文字偵測要求數 功能配額 1,800
非同步圖片加註* (以處理圖片數量計算) 處理中配額 8,000
非同步文件文字偵測 (以處理頁數計算) 處理中配額 10,000
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%)。