Vertex AI Gemini API

Gemini API を初めて使用する場合は、Android デベロッパー向けの推奨 API プロバイダである Gemini Developer API を使用してください。ただし、特定のデータのロケーション要件がある場合や、Vertex AI または Google Cloud 環境にすでに組み込まれている場合は、Vertex AI Gemini API を使用できます。

スタートガイド

アプリから Vertex AI Gemini API を直接操作する前に、Vertex AI Studio でプロンプトを試すことができます。

Firebase プロジェクトを設定し、アプリを Firebase に接続する

アプリから API を呼び出す準備ができたら、Firebase AI Logic スタートガイドの「ステップ 1」の手順に沿って、Firebase を設定し、必要な API とサービスを有効にします。

Gradle 依存関係を追加する

アプリ モジュールに次の Gradle 依存関係を追加します。

dependencies {
  // ... other androidx dependencies

  // Import the BoM for the Firebase platform
  implementation(platform("com.google.firebase:firebase-bom:34.15.0"))

  // Add the dependencies for the Firebase AI Logic and App Check libraries
  // When using the BoM, you don't specify versions in Firebase library dependencies
  implementation("com.google.firebase:firebase-ai")
  implementation("com.google.firebase:firebase-appcheck-debug")
}

dependencies {
  // Import the BoM for the Firebase platform
  implementation(platform("com.google.firebase:34.15.0"))

  // Add the dependencies for the Firebase AI Logic and App Check libraries
  // When using the BoM, you don't specify versions in Firebase library dependencies
  implementation("com.google.firebase:firebase-ai")
  implementation("com.google.firebase:firebase-appcheck-debug")

  // Required for one-shot operations (to use `ListenableFuture` from Guava Android)
  implementation("com.google.guava:guava:31.0.1-android")

  // Required for streaming operations (to use `Publisher` from Reactive Streams)
  implementation("org.reactivestreams:reactive-streams:1.0.4")
}

ローカル開発用に App Check デバッグ プロバイダを構成する

2026 年 7 月上旬より、Firebase コンソールの AI Logic のガイド付き設定ワークフローの一環として、Gemini API を保護するために Firebase App Check が自動的に適用されます。ローカル開発では、App Check の適用を維持しながら、構成証明をバイパスするように App Check のデバッグ プロバイダを構成する必要があります。

1. デバッグビルドで、デバッグ プロバイダ ファクトリを使用するように App Check を構成します。

   Kotlin

   Firebase.initialize(context = this)
   Firebase.appCheck.installAppCheckProviderFactory(
       DebugAppCheckProviderFactory.getInstance(),
   )
   

   Java

   FirebaseApp.initializeApp(/*context=*/ this);
   FirebaseAppCheck firebaseAppCheck = FirebaseAppCheck.getInstance();
   firebaseAppCheck.installAppCheckProviderFactory(
           DebugAppCheckProviderFactory.getInstance());
   

2. デバッグ トークンを取得します。

   1. エミュレータまたはテストデバイスでアプリを実行します。

   2. ログで App Check デバッグ トークンを探します。次に例を示します。

      D DebugAppCheckProvider: Enter this debug secret into the allow list
      in the Firebase Console for your project: 123a4567-b89c-12d3-e456-789012345678
      

   3. トークン（123a4567-b89c-12d3-e456-789012345678 など）をコピーします。

3. デバッグトークンを App Check に登録します。

   1. Firebase コンソールで、[セキュリティ] > [App Check] > [アプリ] タブに移動します。

   2. アプリを見つけて、オーバーフロー メニュー（more_vert）をクリックし、[デバッグ トークンを管理] を選択します。

   3. 画面上の手順に沿ってデバッグ トークンを登録します。

デバッグ プロバイダの詳細（新しいデバッグトークンの取得方法など）については、App Check の公式ドキュメントをご覧ください。

生成モデルを初期化する

まず、GenerativeModel をインスタンス化して、モデル名を指定します。

val model = Firebase.ai(backend = GenerativeBackend.vertexAI())
    .generativeModel("gemini-2.5-flash")
VertexAiGeminiApi.kt

GenerativeModel firebaseAI = FirebaseAI.getInstance(GenerativeBackend.vertexAI())
        .generativeModel("gemini-2.5-flash");

GenerativeModelFutures model = GenerativeModelFutures.from(firebaseAI);
VertexAiGeminiApiJava.java

Firebase のドキュメントで、使用可能な Gemini モデルの詳細をご確認ください。モデル パラメータの構成についてもご覧ください。

テキストを生成

テキスト レスポンスを生成するには、プロンプトを指定して generateContent() を呼び出します。

suspend fun generateText(model: GenerativeModel) {
    // Note: generateContent() is a suspend function, which integrates well
    // with existing Kotlin code.
    val response = model.generateContent("Write a story about a magic backpack.")
    // ...
}
VertexAiGeminiApi.kt

Content prompt = new Content.Builder()
        .addText("Write a story about a magic backpack.")
        .build();

ListenableFuture<GenerateContentResponse> response = model.generateContent(prompt);
Futures.addCallback(response, new FutureCallback<GenerateContentResponse>() {
    @Override
    public void onSuccess(GenerateContentResponse result) {
        String resultText = result.getText();
        // ...
    }

    @Override
    public void onFailure(Throwable t) {
        t.printStackTrace();
    }
}, executor);
VertexAiGeminiApiJava.java

Gemini Developer API と同様に、テキスト プロンプトで画像、音声、動画、ファイルを渡すこともできます。詳細については、アプリから Gemini Developer API を操作するをご覧ください。

Firebase AI Logic SDK の詳細については、Firebase のドキュメントをご覧ください。