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 SDK と 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 キーは、Google Cloud コンソールの [API とサービス] > [認証情報] パネルで確認できます。
400 エラー: Service agents are being provisioned ... Service agents are needed to read the Cloud Storage file provided.
Cloud Storage for Firebase URL を使用してマルチモーダル リクエストを送信しようとすると、次の 400 エラーが発生することがあります。 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 の場合は、Firebase AI Logic API（firebasevertexai.googleapis.com）が、API キーを使用して呼び出すことができる選択された API のリストに含まれていることを確認する必要があります。
Gemini Developer API を使用しようとして Firebase AI Logic genai config not found という 404 エラーが表示される場合は、通常、Firebase プロジェクトに Firebase AI Logic クライアント SDK で使用する有効な Gemini API キーがないことを意味します。
このエラーの最も可能性の高い原因は次のとおりです。
Gemini Developer API の Firebase プロジェクトがまだ設定されていません。
対応: Firebase コンソールで、Firebase AI Logic ページに移動します。[開始] をクリックし、[Gemini Developer API] を選択します。API を有効にすると、コンソールで Gemini Developer API 用のプロジェクトが設定されます。ワークフローを完了してから、リクエストをもう一度試してください。
Firebase コンソールで Firebase AI Logic 設定ワークフローを最近完了したばかりの場合、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 を指定します。モデルにアクセスするロケーションを指定する方法（コード スニペットを含む）について学習する。
