割り当てと上限

このドキュメントでは、Cloud Vision に適用される割り当てと上限を示します。

割り当ては、Google Cloud プロジェクトで使用できる共有 Google Cloud リソース（ハードウェア、ソフトウェア、ネットワーク コンポーネントなど）の量を制限します。つまり、割り当てはシステムの一部で、次の機能があります。

  • Google Cloud のプロダクトとサービスの使用量や消費量をモニタリングする。
  • 公平性の確保や使用量急増の抑制などのため、これらのリソースの消費量を制限する。
  • 規定の制限を自動的に適用する構成を維持する。
  • 割り当てをリクエストまたは変更する手段を提供する。

ほとんどの場合、割り当てを超過すると、システムは関連する Google リソースへのアクセスをすぐにブロックするため、ユーザーが試行しているタスクは失敗します。ほとんどの場合、割り当ては各 Google Cloud プロジェクトに適用され、その Google Cloud プロジェクトを使用するすべてのアプリケーションと IP アドレスで共有されます。

ほどんどの場合、割り当ての増減を行うには Google Cloud コンソールを使用します。詳細については、割り当ての増加をリクエストするをご覧ください。

Vision リソースには上限もあります。これらの上限は、割り当てシステムとは無関係です。上限は、特に明記されていない限り、変更できません。

割り当てタイプ

割り当てには次の 3 種類があります。

  1. リクエストの割り当て
    • Vision API エンドポイントに送信されるリクエストごとに割り当てがカウントされます。
  2. 機能の割り当て
    • Vision API エンドポイントに送信される画像 / ファイルごとに割り当てがカウントされます。
    • 明示的に指定しない限り、接頭辞として機能名が含まれる割り当ては、通常は機能の割り当てです。
  3. 処理中の割り当て
    • 明示的に指定しない限り、Vision API によって処理される画像 / ファイルごとに割り当てがカウントされます。
    • 割り当て名の「in processing」（処理中）により、処理中の割り当てであることが推測できます。
    • この割り当てにより、非同期メソッドで一度に処理される Vision API の画像 / ページの最大数が決まります。この割り当てを超える量を非同期メソッドに送信できますが、割り当てを超過した画像 / ページは直ちに処理されません。割り当てを超過したファイルは、後で処理されるようにキューに追加されます。

Vision API の現在の API 使用量の割り当ては次のとおりです（変更される場合があります）。

Vision API の割り当て 割り当てのタイプ 値
1 分あたりのリクエスト数（以下のリクエスト タイプを除く） リクエストの割り当て 1,800
1 分あたりの Celebrity Recognition リクエスト リクエストの割り当て 0
1 分あたりのラベル検出リクエスト 機能の割り当て 1,800
1 分あたりのテキスト検出リクエスト 機能の割り当て 1,800
非同期画像アノテーション* における処理中の画像数 処理中の割り当て 8,000
非同期ドキュメント テキスト検出† における処理中のページ数 処理中の割り当て 10,000
* images:asyncBatchAnnotate リクエスト
† files:asyncBatchAnnotate リクエスト、DOCUMENT_TEXT_DETECTION 特徴
Product Search の割り当て 値
1 分あたりのリクエスト数（以下のリクエスト タイプを除く） 1,800
1 日あたりの一括リクエスト数 300
1 分あたりのリソース管理の書き込みリクエスト数 1,200
1 分あたりのリソース管理リクエスト数 2,400

この上限値は、Google Cloud Console プロジェクトごとに適用され、そのプロジェクトを使用するすべてのアプリケーションと IP アドレスで共有されます。

Google Cloud Console で、ユーザーごとにより低い割り当てを設定できます。

割り当ての増加

Google Cloud Console ページの [割り当て] ページで [割り当てを編集] を選択すると、割り当てを編集して最大値まで引き上げることができます。割り当ての上限引き上げをリクエストするには、割り当てを編集して必要な上限とその理由を設定し、更新内容を送信します。リクエストが受信されると、通知が届きます。リクエストの詳細について確認をさせていただく場合もあります。リクエストの審査が完了すると、承認または却下の結果が通知されます。

通常、各割り当てには「1 ユーザー、1 プロジェクトあたり」と「1 プロジェクトあたり」のバリアントがあるため、設定に応じてそれぞれを変更してください。

機能の割り当ての増加をリクエストするときは、全般的なリクエストの割り当てと目的のバッチサイズを考慮して、次の点を確認してください。

  • 全般的なリクエストの割り当て（1 分あたりのリクエスト数）* バッチサイズ >= 増加後の機能の割り当て

この要件が満たされない場合でも、全般的なリクエストの割り当てによるスロットリングを受けます。

このドキュメントでは、Vision API のコンテンツに関する現在の上限とリクエストの割り当てについて説明します。これらの上限や使用制限に変更があったときは、このページにもその変更が反映されます。

上限

Vision API では、次の使用量上限が適用されます。

コンテンツの上限 値
画像ファイルサイズ 20 MB
JSON リクエスト オブジェクト サイズ 10 MB
PDF ファイルサイズ 1 GB
images:annotate リクエスト 1 回あたりの画像数 16
images:asyncBatchAnnotate リクエスト 1 回あたりの画像数 2000
files:annotate リクエスト 1 回あたりのページ数 5
files:asyncBatchAnnotate リクエスト 1 回あたりのページ数 2000

Base64 でエンコードされた画像は、画像ファイルのサイズ上限内であっても、JSON のサイズ上限を超えることがあります。サイズの大きい画像は Cloud Storage または一般公開されている URL でホストする必要があります。Base64 でエンコードされた画像は、元の画像ファイルよりもファイルサイズが大きくなる可能性があります（通常は約 37% 大きくなります）。