このページでは、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 コンソールで、[AI サービス] > [AI ロジック] に移動します。[開始] をクリックし、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.1-pro-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 でサポートされているモデルは一部のみです。つまり、モデルによっては、初期化時に特定のロケーションを明示的に設定する必要がある場合があります。
Geminiプレビュー モデルと試験運用版モデル: ロケーションを global に設定する必要があります（Live API モデルを除く）。すべてのプレビュー版と試験運用版の Gemini モデル（Live API モデルを除く）は、global ロケーションでのみ使用できます。
Gemini 3.x モデル: Firebase AI Logic を使用する場合は、ロケーションを global に設定する必要があります。Firebase AI Logic は、us ロケーションと eu ロケーションをまだサポートしていません。
