配額與限制

本文列出 Speech-to-Text 的配額和系統限制。

  • 「配額」會指定您可使用的可計數共用資源數量。配額是由 Google Cloud 服務 (例如 Speech-to-Text) 定義。
  • 系統限制為固定值，無法變更。

Google Cloud 會使用配額來確保公平性，並減少資源使用量和可用性的尖峰情形。配額會限制 Google Cloud 專案可使用的Google Cloud 資源數量。配額適用於多種資源類型，包括硬體、軟體和網路元件。舉例來說，配額可以限制向服務發出的 API 呼叫數、專案並行使用的負載平衡器數量，或可建立的專案數量。限制配額可預防服務超載，進而保障Google Cloud 使用者社群的權益。配額也能協助您管理自己的 Google Cloud 資源。

Cloud 配額系統會執行以下作業：

在大多數情況下，如果您嘗試使用的資源超過配額限制，系統會封鎖對該資源的存取權，而您要執行的任務也會失敗。

配額通常會套用至 Google Cloud 專案層級。您在一個專案中使用資源，不會影響其他專案的可用配額。在 Google Cloud 專案中，所有應用程式和 IP 位址都會共用配額。

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

Speech-to-Text 資源也有系統限制。系統限制無法變更。

本文說明現行的 Cloud Speech-to-Text API 限制和用量上限。這些限制和用量上限如有變更，我們也會同步更新本頁面的資訊。Google 保留更改這些限制的權利。

內容限制

Speech-to-Text 接受以音訊資料形式提供的內容，您可以直接在要求的 content 欄位中提供音訊檔案，或是以要求的 uri 欄位指定要參照的 Google Cloud Storage URI。使用本機檔案傳送至 API 的各項要求上限均為 10 MB。如為 Recognize 和 LongRunningRecognize 方法，這項限制適用於傳送的要求大小。如為 StreamingRecognize 方法，則 10 MB 的限制適用於初始 StreamingRecognize 要求和串流中每則訊息的大小。如果超出這項限制，系統就會擲回錯誤。如果您傳送的要求使用的是 Google Cloud Storage 值區中儲存的音訊資料，則沒有限制。

API 針對這類內容的大小設有下列限制 (我們可能會視情況調整這些限制)。

內容限制 音訊時間長度
同步要求 約 1 分鐘
非同步要求 約 480 分鐘*
串流要求 約 5 分鐘**

* 如果音訊的時間長度超過約 1 分鐘，則必須使用 uri 欄位來參照 Google Cloud Storage 中的音訊檔案。
** 如果您需要串流超過 5 分鐘的內容，請參閱無限串流教學課程。

如為 StreamingRecognize 要求，音訊必須以近乎即時的速率傳送。

如果嘗試處理的內容超出這些內容限制，就會產生錯誤。詳情請參閱「錯誤訊息」和「疑難排解」。

您也可以在任何要求中提供 PhraseSet 資源，並在其中包含該要求專用的詞組清單。(在這種情況下，系統會將一個字詞視為一個詞組)。這類情況適用下列限制：

語音調整限制 值
每次要求的詞組數 5000 個
每次要求的字元總數 100,000 個
每個詞組的字元數 100 個

要求限制

Speech-to-Text 目前的 API 用量限制如下 (未來可能異動)：

限制類型 用量限制
每 60 秒的辨識要求數* 900
每 60 秒的調整資源要求數* 10
每日處理量 480 小時的音訊

* 系統會將每個 StreamingRecognize 工作階段視為一個要求，即使串流包含 StreamingRecognizeRequest 音訊的多個音框也是如此。

如果要求和/或嘗試處理的音訊超出這些限制，就會產生錯誤。詳情請參閱「錯誤訊息」和「疑難排解」。

這些限制適用於每項 Speech-to-Text 開發人員專案，而且使用該開發人員專案的所有應用程式和 IP 位址必須共用上述額度。