|
Gemini API プロバイダをクリックして、このページでプロバイダ固有のコンテンツとコードを表示します。 |
レート制限（通常は割り当てと呼ばれます）は、特定の期間内に Gemini API に対して行うことができるリクエストの数を規制します。これらの上限は、公平な使用を保証し、不正使用から保護し、すべてのユーザーのシステム パフォーマンスを維持するのに役立ちます。
Firebase AI Logic を使用して Gemini モデルにアクセスする場合、プロジェクトのレート上限は選択した Gemini API プロバイダによって異なります。Firebase AI Logic には、ユーザーごとのレート上限を設定する方法もあります。
Gemini Developer API のレート制限を表示する
割り当てを超過した場合や、アクセスしているモデルの容量が不足している場合は、429 エラー メッセージが表示されます。
レート制限（割り当て）の仕組み
レート制限（割り当て）は、次の 4 つのディメンションで測定されます。
- 1 分あたりのリクエスト数（RPM）
- 1 日あたりのリクエスト数（RPD）
- 1 分あたりのトークン数（TPM）
- 1 日あたりのトークン数（TPD）
使用量は各上限に対して評価され、いずれかの上限を超えると 429 割り当て超過エラーがトリガーされます。たとえば、RPM 上限が 20 の場合、TPM やその他の上限を超えていなくても、1 分以内に 21 件のリクエストを行うとエラーが発生します。
レート制限はプロジェクト レベルで適用され、その Firebase プロジェクトを使用するすべてのアプリケーションと IP アドレスに適用されます。
上限は使用する特定のモデルによって異なり、一部の上限は特定のモデルにのみ適用されます。
試験運用版モデルとプレビュー版モデルでは、レート制限が厳しくなっています。
レート上限の引き上げをリクエストする
Gemini Developer API の「有料階層」をご利用の場合は、レート制限の引き上げをリクエストできます。
「ユーザーごと」のレート制限を設定する
Firebase AI Logic を使用するには、選択した Gemini API プロバイダを有効にする必要があります。また、Firebase AI Logic API も有効にする必要があります。この API は、Google のクライアント SDK と Gemini API プロバイダ間のゲートウェイとして機能します。この API は、Firebase プロジェクトで Firebase AI Logic を最初に設定したときに有効になります。
Firebase AI Logic に依存する AI 機能に限定して、Firebase AI Logic API のレート制限（割り当て）をアプリの「ユーザーごと」のレート制限として使用できます。この上限を設定して、1 人のユーザーが AI 機能にアクセスするのを合理的に許可しつつ、1 人のユーザーが Gemini API プロバイダの上限（すべてのユーザーが共有することを想定）を超えないようにする必要があります。
「ユーザーごと」のレート制限の詳細
Firebase AI Logic API のレート制限（割り当て）、特に 1 分あたりのリクエスト数（RPM）に関する重要な詳細は次のとおりです。
これは、ユーザー、リージョン、分単位の「コンテンツ生成リクエスト」に基づいており、モデルに基づくものではありません。
これは、すべてのユーザーに適用されるレート制限です。現在、特定のユーザーまたは特定のユーザー グループのレート制限を設定する方法はありません。*
これはプロジェクト レベルで適用され、その Firebase プロジェクトを使用するすべてのアプリケーションと IP アドレスに適用されます。
これは、Firebase AI Logic SDK からの呼び出しに適用されます。
デフォルトのレート制限は、ユーザーあたり 100 RPM です。
なお、Gemini API プロバイダの制限（上記を参照）も考慮する必要があります。この制限は Firebase AI Logic API よりも優先されます。
* Agent Platform Gemini API (formerly Vertex AI) を使用していて、アプリがユーザーをさまざまな地域に誘導する場合（Firebase Remote Config を使用するなど）、特定の地域のユーザーに特定のレート制限を設定できます。
「ユーザーごと」のレート制限を調整する
レート制限（割り当て）を調整するには、serviceusage.quotas.update 権限が必要です。この権限は、オーナーロールと編集者ロールにデフォルトで含まれています。
レート制限（割り当て）を編集する、または引き上げをリクエストする方法は次のとおりです。
Google Cloud コンソールで、Firebase AI Logic API のページに移動します。
[管理] をクリックします。
ページの下部にある [割り当てとシステム上限] タブをクリックします。
テーブルをフィルタして、目的の割り当て（コンテンツ生成のリクエストなど）とリージョンを表示します。
たとえば、サポートされているアジアのリージョンでコンテンツ生成リクエストを行うユーザーごとの割り当てを表示する場合、フィルタは次のようになります。
Generate content requests+Dimension:region:asia目的の割り当ての左側にあるチェックボックスをオンにします。
割り当ての行の末尾にある をクリックし、[割り当てを編集] を選択します。
[割り当ての変更] フォームで、次の操作を行います。
[新しい値] フィールドに、引き上げ後の割り当てを入力します。
この割り当てはプロジェクト レベルで適用され、その Firebase プロジェクトを使用するすべてのアプリケーションと IP アドレスで共有されます。
フォームのその他のフィールドに入力して、[完了] をクリックします。
[リクエストを送信] をクリックします。