Vertex AI Gemini API

如果您是 Gemini API 的新手，建議 Android 開發人員使用 Gemini Developer API 做為 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 依附元件新增至應用程式模組：

Kotlin

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")
}

Java

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 的導覽式設定工作流程時，系統會自動強制執行 Firebase App Check，保護 Gemini API。如要進行本機開發，您需要設定 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 控制台中，依序前往「安全性」>「應用程式檢查」>「應用程式」分頁標籤。

    2. 找到您的應用程式，按一下溢位選單 ()，然後選取「管理偵錯權杖」。

    3. 按照畫面上的指示註冊偵錯權杖。

如要進一步瞭解偵錯供應商 (包括如何取得新的偵錯權杖)，請參閱 App Check 官方文件。

初始化生成模型

首先，請例項化 GenerativeModel 並指定模型名稱：

Kotlin

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

Java

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

GenerativeModelFutures model = GenerativeModelFutures.from(firebaseAI);

請參閱 Firebase 說明文件，進一步瞭解可用的 Gemini 模型。您也可以瞭解如何設定模型參數。

生成文字

如要生成文字回覆，請使用提示呼叫 generateContent()。

Kotlin

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.")
    // ...
}

Java

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);

與 Gemini Developer API 類似，您也可以在文字提示中傳遞圖片、音訊、影片和檔案。詳情請參閱「從應用程式與 Gemini Developer API 互動」一文。

如要進一步瞭解 Firebase AI Logic SDK，請參閱 Firebase 說明文件。