The latest Gemini models, like Gemini 3.5 Flash, are available to use with Firebase AI Logic! Learn more.
Gemini 2.0 Flash and Flash-Lite models were shut down on June 1, 2026. To avoid service disruption, update to a newer model like gemini-3.1-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 プロバイダを使用している場合にのみ適用）
原因: Vertex AI Gemini API
を使用するリクエストには、モデルにアクセスするロケーションを含める必要があります。リクエストが、モデルが利用できないロケーションのモデルにアクセスしようとしている可能性があります。
解決策: リクエストが、モデルが利用可能な場所のモデルにアクセスしようとしていることを確認します。
Vertex AI Gemini API を使用する場合、Firebase AI Logic
のデフォルトは us-central1 です。ただし、us-central1 ではすべてのモデルがサポートされているわけではありません。つまり、モデルによっては、初期化時に特定のロケーションを明示的に設定する必要があります。
GeminiGemini プレビュー版モデルと試験運用版モデル: ロケーションを global に設定する必要があります（Live API モデルを除く）。すべての
プレビュー版と試験運用版Geminiモデル（Live API
モデルを除く）は、のみglobalロケーションで利用できます。
Gemini 3.x モデル: Firebase AI Logic を使用する場合は、ロケーションを global
に設定する必要があります。Firebase AI Logic は、us ロケーションと eu ロケーションをまだサポートしていません。
