配額與限制

這份文件列出 Cloud Vision 適用的配額和系統限制。

  • 「配額」有預設值，但通常可以申請調整。
  • 「系統限制」是固定值，無法變更。

Google Cloud 使用配額來確保公平性，並減少資源使用量和可用性出現劇烈波動的情況。配額會限制 Google Cloud 專案可使用的Google Cloud 資源數量，且適用多種資源類型，包括軟硬體和網路元件。舉例來說，配額可能會限制能向特定服務發出的 API 呼叫次數、專案可同時使用的負載平衡器數量，或是可建立的專案數量。配額機制可防止服務過載，保障Google Cloud 使用者社群的權益，同時也有助於您管理自己的 Google Cloud 資源。

Cloud Quotas 系統具備以下功能：

如果嘗試使用的資源量超過配額限制，系統通常會阻擋該資源的存取活動，您所執行的工作就會失敗。

配額的計算通常是以 Google Cloud 專案為基準。在某個專案中使用資源，不會影響另一個專案的可用配額。在同一個 Google Cloud 專案內，所有應用程式和 IP 位址會共用配額。

詳情請參閱「Cloud Quotas 總覽」。

如要調整大部分配額，請使用 Google Cloud 控制台。詳情請參閱「要求調整配額」。

Vision 資源也有「系統限制」， 而且無法變更。

配額類型

配額分為 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
* 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%)。