よくある質問とトラブルシューティング

Firebase AI Logic を使用している場合、Google 画像検索によるグラウンディング、モデルのファインチューニング、エンベディングの生成、セマンティック検索などの機能は利用できますか？

次の機能は、さまざまなモデルと API プロバイダでサポートされていますが、Firebase AI Logic を使用する場合は利用できません。

• Google 画像検索によるグラウンディング
• モデルのファインチューニング
• エンベディングの生成
• セマンティック検索

これらを機能リクエストとして追加したり、既存の機能リクエストに投票したりする場合は、Firebase UserVoice にアクセスしてください。

「Vertex AI in Firebase」から「Firebase AI Logic」に名称が変更されたのはなぜですか？

2024 年に、Vertex AI Gemini API と Firebase プロキシ ゲートウェイを使用して、API を不正使用から保護し、他の Firebase プロダクトとの統合を可能にする Firebase クライアント SDK のセットをリリースしました。Google はプロダクトを「Vertex AI in Firebase」と名付けました。このプロダクト名は、当時のプロダクトで利用可能なユースケースを正確に表していました。

その後、Google はプロダクトの機能を拡張しました。たとえば、2025 年 5 月より、Gemini Developer API のサポートが提供されるようになりました。これには、Firebase App Check との統合を使用して Gemini Developer API を不正使用から保護する機能が含まれます。

その結果、「Vertex AI in Firebase」という名前は、プロダクトの拡大された範囲を正確に表さなくなりました。そのため、新しい名前である Firebase AI Logic は、進化する機能セットをより適切に反映しており、今後もサービスを拡大していくことができます。

移行ガイドを確認して、Firebase AI Logic の最新機能をすべて利用できるようにしてください（必要に応じて Gemini Developer API の使用を開始することもできます）。

Apple プラットフォームの Swift アプリ - モジュール名の FirebaseAI から FirebaseAILogic への変更について

Apple プラットフォーム アプリの場合、Firebase SDK v12.5.0 以降、Firebase AI Logic は FirebaseAILogic モジュールで配布されるようになりました。この変更は、互換性を損なわない下位互換性のあるものになっています。

今回の変更の理由

このサービスは、以前は FirebaseAI モジュールで配布されていました。ただし、次の理由により、FirebaseAILogic に名前を変更する必要がありました。

• バイナリ ディストリビューションで問題を引き起こすモジュールとクラス間の名前の衝突を回避します。

• 将来の機能開発で Swift マクロを使用できるようにします。

v12.5.0 以降にアップグレードする場合の対応

モジュール名を FirebaseAILogic に変更しても、互換性は損なわれず、下位互換性も維持されます。ただし、最終的には、今後の Firebase SDK のメジャーな破壊的変更のリリースに伴い、古いモジュールを削除する可能性があります（現時点では時期は未定）。

このモジュール名の変更に伴う必須の変更はありませんが、次の対応をおすすめします。

1. Swift PM の依存関係を選択するときは、FirebaseAI ではなく FirebaseAILogic を選択します。

2. インポート ステートメントを FirebaseAILogic（FirebaseAI ではなく）に変更します。

Gemini API キーとは

Gemini Developer API は、「Gemini API キー」を使用して呼び出し元を承認します。そのため、Firebase AI Logic SDK を介して Gemini Developer API を使用している場合は、その API を呼び出すために Firebase プロジェクトに有効な Gemini API キーが必要です。

「Gemini API キー」とは、API 許可リストに Gemini Developer API が含まれている API キーのことです。

Firebase コンソールの Firebase AI Logic 設定ワークフローを実行すると、Gemini Developer API のみに制限された Gemini API キーが作成され、この API キーを使用するように Firebase AI Logic プロキシ サービスが設定されます。この Firebase 生成の Gemini API キーは、Google Cloud コンソールの認証情報ページで「Gemini Developer API key (auto created by Firebase)」という名前になっています。

API キーの API 制限について学習する。

Firebase AI Logic SDK を使用する場合、アプリのコードベースに Gemini API キーを追加しません。Gemini API キーの安全性を保つ方法について学習する。

モバイルアプリまたはウェブアプリのコードベースに Gemini API キーを追加する必要がありますか？

Firebase AI Logic SDK を使用する場合は、アプリのコードベースに Gemini API キーを追加しないでください。

実際、Firebase AI Logic SDK を使用して開発する場合、Gemini API キーを直接操作することはありません。代わりに、Firebase AI Logic プロキシ サービスは、Gemini Developer API への各リクエストに Gemini API キーを内部的に含めます。これは完全にバックエンドで行われます。

Gemini Developer API の呼び出しに使用される Gemini API キーを変更するにはどうすればよいですか？

Firebase AI Logic SDK を使用している場合、Gemini API キーを変更する必要が生じることはほとんどありません。ただし、次のような場合は、以下の操作が必要になることがあります。

• キーを誤って漏洩し、新しい安全なキーに置き換える場合。

• キーを誤って削除した場合。なお、削除から 30 日以内であれば、キーの削除を取り消すことができます。

Firebase AI Logic SDK で使用される Gemini API キーを変更する方法は次のとおりです。

1. Firebase で生成された Gemini API キーがまだ存在する場合は、削除します。

   この API キーは、Google Cloud コンソールの [API とサービス] > [認証情報] パネルで削除できます。名前は
   「Gemini Developer API key (auto created by Firebase)」です。

2. Google Cloud コンソールの同じページで、新しい API キーを作成します。名前は「
   Gemini Developer API key for Firebase」のようにすることをおすすめします。

3. この新しい API キーに API の制限を追加し、[Generative Language API] のみを選択します。
   Google Cloud コンソールでは、Gemini Developer API が「Generative Language API」と呼ばれることがあります。

   アプリの制限を追加しないでください。追加すると、Firebase AI Logic プロキシ サービスが想定どおりに動作しません。

4. 次のコマンドを実行して、この新しいキーを Firebase AI Logic プロキシ サービスが使用する Gemini API キーとして設定します。

   PROJECT_ID="PROJECT_ID"
   GENERATIVE_LANGUAGE_API_KEY="DEVELOPER_CREATED_GEMINI_API_KEY"
   curl \
     -X PATCH \
     -H "x-goog-user-project: ${PROJECT_ID}" \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     -H "Content-Type: application/json" \
     "https://firebasevertexai.googleapis.com/v1beta/projects/${PROJECT_ID}/locations/global/config" \
     -d "{\"generativeLanguageConfig\": {\"apiKey\": \"${GENERATIVE_LANGUAGE_API_KEY}\"}}"
   

   gcloud CLI について学習する。

この新しい Gemini API キーをアプリのコードベースに追加しないようにしてください。Gemini API キーの安全性を保つ方法について学習する。

「Firebase API キー」を Gemini API キーとして使用できますか？

いいえ。Firebase API キーを Gemini API キーとして使用しないでください。Firebase API キーの許可リストに Gemini Developer API を追加しないことを強くおすすめします。

Firebase API キーは、アプリを Firebase に接続するためにアプリのコードベースに追加する Firebase 構成ファイルまたはオブジェクトに記載されている API キーです。Firebase API キーを Firebase 関連の API（Firebase AI Logic など）でのみ使用する場合は、コードに Firebase API キーを含めても問題ありません。 Firebase API キーに関する重要な情報をご確認ください。

Google Cloud コンソールの [API とサービス] > [認証情報] パネルで、Firebase API キーは次のように表示されます。

Firebase 関連の API を動作させるには、Firebase API キーをアプリのコードベースに追加する必要があり、Gemini Developer API は API キーで承認されるため、Firebase API キーの API 許可リストに Gemini Developer API（Google Cloud コンソールでは「Generative Language API」と呼ばれます）を追加しないことを強くおすすめします。そうすると、Gemini Developer API が不正使用される可能性があります。

Gemini API キーのセキュリティを維持するにはどうすればよいですか？

この FAQ では、Gemini API キーの安全性を保つためのおすすめのベスト プラクティスについて説明します。

モバイルアプリまたはウェブアプリから Gemini Developer API を直接呼び出す場合:

• Firebase AI Logic クライアント SDK を使用します。
• アプリのコードベースに Gemini API キーを追加しないでください。

Firebase AI Logic は、Gemini Developer API への各リクエストに Gemini API キーを内部的に含めるプロキシ サービスを提供します。これは完全にバックエンドで行われます。

また、次のことを強くおすすめします。

• アプリの開発を本格的に開始したら、Firebase App Check と統合して、バックエンド リソースと生成モデルへのアクセスに使用される API を保護します。

• Firebase で生成された Gemini API キーを Firebase AI Logic の外部で再利用しないでください。別のユースケースで Gemini API キーが必要な場合は、別のキーを作成します。

• 一般的に、Firebase で生成された Gemini API キーは変更すべきではありません。このキーは、Google Cloud コンソールで Gemini Developer API key (auto created by Firebase) という名前になります。

  • Firebase で生成された Gemini API キーの API 許可リストに、追加の API を追加しないでください。API 許可リストに、Gemini API キーに Gemini Developer API（Google Cloud コンソールでは「Generative Language API」）のみが含まれていること。

  • アプリの制限を追加しないでください。追加すると、Firebase AI Logic プロキシ サービスが想定どおりに動作しません。

Gemini API キーが不正使用されました。必要なご対応

Gemini API キーが不正使用された場合は、Gemini Developer API の呼び出しに使用される Gemini API キーを変更する手順に沿って変更します。

また、Gemini API キーの安全性を保つための推奨されるベスト プラクティスも確認してください。