このドキュメントでは、Cloud Vision に適用される割り当てと上限を示します。
Google Cloud では、割り当てを使用して公平性を確保し、リソースの使用量と可用性の急増を抑えます。割り当ては、Google Cloud プロジェクトで使用できる Google Cloud リソースの量を制限します。割り当ては、ハードウェア、ソフトウェア、ネットワーク コンポーネントなど、さまざまなリソースタイプに適用されます。たとえば、割り当てによって、サービスへの API 呼び出しの数、プロジェクトで同時に使用されるロードバランサの数、作成可能なプロジェクトの数を制限できます。割り当てを適用することで、サービスの過負荷を防ぎ、Google Cloud ユーザーのコミュニティを保護します。割り当ては、自組織で使用している Google Cloud リソースの管理にも役立ちます。
Cloud Quotas システムは次のことを行います。
- Google Cloud のプロダクトとサービスの消費量をモニタリングする
- これらのリソースの消費量を制限する
- 割り当て値の変更をリクエストする手段を提供する
ほとんどの場合、割り当ての許容量を超えるリソースを消費しようとすると、システムによってリソースへのアクセスがブロックされ、実行しようとしているタスクは失敗します。
割り当ては通常、Google Cloud プロジェクト レベルで適用されます。あるプロジェクトでリソースを使用しても、別のプロジェクトで使用可能な割り当てに影響することはありません。Google Cloud プロジェクト内では、すべてのアプリケーションと IP アドレスで割り当てが共有されます。
ほどんどの場合、割り当ての増減を行うには Google Cloud コンソールを使用します。詳細については、割り当ての増加をリクエストするをご覧ください。
Vision リソースには上限もあります。これらの上限は、割り当てシステムとは無関係です。上限は、特に明記されていない限り、変更できません。
割り当てタイプ
割り当てには次の 3 種類があります。
- リクエストの割り当て
- Vision API エンドポイントに送信されるリクエストごとに割り当てがカウントされます。
- 機能の割り当て
- Vision API エンドポイントに送信される画像 / ファイルごとに割り当てがカウントされます。
- 明示的に指定しない限り、接頭辞として機能名が含まれる割り当ては、通常は機能の割り当てです。
- 処理中の割り当て
- 明示的に指定しない限り、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% 大きくなります）。