The latest Gemini models, like Gemini 3.1 Flash Image (Nano Banana 2), are available to use with Firebase AI Logic! Learn more.
Gemini 2.0 Flash and Flash-Lite models will shut down on June 1, 2026. To avoid service disruption, update to a newer model like gemini-2.5-flash-lite. Learn more.
このページでは、Gemini API
とFirebase AI Logic SDK の一般的なエラーコードのトラブルシューティングについて説明します。
400 エラー: API key not valid. Please pass a valid API key.
API key not valid. Please pass a valid API key. という 400 エラーが表示される場合は、通常、Firebase 構成ファイル / オブジェクト内の API キーが存在しないか、アプリや Firebase プロジェクトで使用するように設定されていないことを意味します。
Firebase 構成ファイル/オブジェクトに記載されている API キーが、アプリの API キーと一致していることを確認します。すべての API キーは、
[API とサービス] > [認証情報]
パネルで確認できます。Google Cloud
400 エラー: Service agents are being provisioned ... Service agents are needed to read the Cloud Storage file provided.
Cloud Storage for Firebase URL を使用してマルチモーダル リクエストを送信しようとすると、次の 400 エラーが発生することがあります。Cloud Storage for Firebase Service agents are being provisioned ... Service agents are needed to read the Cloud Storage file provided.
このエラーは、プロジェクトで Vertex AI API が有効になったときに、必要なサービス エージェント
が自動的にプロビジョニングされなかったプロジェクトで発生します。これは一部のプロジェクトで確認されている既知の問題であり、現在、グローバルな修正に取り組んでいます。
403 エラー: Requests to this API firebasevertexai.googleapis.com ... are blocked.
Requests to this API firebasevertexai.googleapis.com ... are blocked. という 403 エラーが表示される場合は、通常、アプリの Firebase 構成の API キーに、必要な API の呼び出しを妨げる制限があることを意味します。
この問題を解決するには、
Google Cloud コンソールで API キーの制限を更新して、必要な API を含める必要があります。Firebase AI Logic の場合は、API キーを使用して呼び出すことができる選択した API のリストに Firebase AI Logic API（firebasevertexai.googleapis.com）が含まれていることを確認する必要があります。
Gemini Developer API を使用しようとしていて、
Firebase AI Logic genai config not found という 404 エラーが表示される場合は、通常、Firebase プロジェクトに Firebase AI Logic クライアント SDK で使用する有効な Gemini API キーがないことを意味します。Firebase AI Logic
このエラーの最も可能性の高い原因は次のとおりです。
Firebase プロジェクトを
Gemini Developer API 用に設定していない。
対処方法: Firebase コンソールで、[**AI サービス**] >
[**AI Logic**] に移動します。[開始] をクリックし、
Gemini Developer API を選択します。API を有効にすると、コンソールで
プロジェクトが Gemini Developer API 用に設定されます。ワークフローが完了したら、リクエストをもう一度試してください。
Firebase AI Logic の設定ワークフローを Firebase コンソールで完了したばかりの場合、Gemini API キーがすべてのリージョンの必要なすべてのバックエンド サービスでまだ使用できない可能性があります。
404 エラー: モデル「was not found or your project does not have access to it」が見つかりませんでした。
例: 「Publisher Model projects/PROJECT-ID/locations/us-central1/publishers/google/models/gemini-3-pro-image-preview was not found or your project does not have access to it. Please ensure you are using a valid model version.」
Vertex AI Gemini API を使用する場合、すべての プレビュー版 と
試験運用版Gemini モデル（Gemini Live モデルを除く）は、
global ロケーションでのみ使用できます。ただし、Firebase AI Logic
のデフォルトのロケーションは us-central1 であるため、これらの
プレビュー版と試験運用版Gemini モデルを使用する場合は、コードで
Vertex AI Gemini API バックエンド サービスを初期化するときに、global ロケーションを明示的に指定する必要があります。
修正: Vertex AI Gemini API サービスを初期化するときに、
ロケーション global を指定します。モデルにアクセスするロケーションを指定する方法
（コード スニペットを含む）の詳細をご覧ください。
無効なロケーション（Vertex AI Gemini API プロバイダを使用している場合にのみ適用されます）
修正: Vertex AI Gemini API サービスを初期化するときに、使用しているモデルでサポートされているロケーションを指定していることを確認します。モデルにアクセスするロケーションを指定する方法
（コード スニペットを含む）と、
モデルでサポートされているロケーションの詳細をご覧ください。
Firebase AI Logic のデフォルトのロケーションは
us-central1 です。
429 エラー: "You exceeded your current quota, please check your plan and billing details" または "Resource exhausted, please try again later."
