透過 Vertex AI for Firebase SDK 開始使用 Gemini API


本指南將說明如何使用 Vertex AI for Firebase SDK，直接在應用程式中呼叫 Vertex AI Gemini API。

先備知識

本指南假設您熟悉如何使用 Flutter 開發應用程式。

  • 請確認您的開發環境和網頁應用程式符合下列要求：

    • Dart 3.2.0 以上版本

  • (選用) 查看範例應用程式。

    下載範例應用程式

    您可以快速試用 SDK，查看各種用途的完整實作方式，如果沒有自己的網頁應用程式，則可使用範例應用程式。如要使用範例應用程式，請將 SDK 連結至 Firebase 專案。

步驟 1：設定 Firebase 專案並將應用程式連結至 Firebase

如果您已經有 Firebase 專案，且有一個應用程式連結至 Firebase

  1. 在 Firebase 控制台中，前往「Build with Gemini」(使用 Gemini 建構) 頁面，然後按一下第二張資訊卡來啟動工作流程，協助您完成下列工作。如果您在控制台中看到 Vertex AI 的分頁，表示這些工作已完成。

  2. 請繼續進行本指南的下一步驟，將 SDK 加入應用程式。

如果您尚未有 Firebase 專案，且有一個應用程式連結至 Firebase


步驟 2：新增 SDK

設定好 Firebase 專案，並將應用程式連結至 Firebase 後 (請查看上一步)，即可將 Vertex AI for Firebase SDK 新增至應用程式。

Flutter 適用的 Vertex AI for Firebase 外掛程式 (firebase_vertexai) 可讓您存取 Vertex AI Gemini API。

  1. 從 Flutter 專案目錄執行下列指令，安裝核心外掛程式：

    flutter pub add firebase_core

  2. 在 lib/main.dart 檔案中，匯入 Firebase 核心外掛程式和先前產生的設定檔：

    import 'package:firebase_core/firebase_core.dart';
import 'firebase_options.dart';

  3. 此外，在 lib/main.dart 檔案中，使用設定檔匯出的 DefaultFirebaseOptions 物件初始化 Firebase：

    await Firebase.initializeApp(
  options: DefaultFirebaseOptions.currentPlatform,
);

  4. 重新建構 Flutter 應用程式：

    flutter run

  5. 在您的 Flutter 專案目錄中執行下列指令：

    flutter pub add firebase_vertexai

  6. 完成後，請重新建構 Flutter 專案：

    flutter run

步驟 3：初始化 Vertex AI 服務和生成式模型

您必須先初始化 Vertex AI 服務和生成式模型，才能發出 API 呼叫。

import 'package:firebase_vertexai/firebase_vertexai.dart';
import 'package:firebase_core/firebase_core.dart';

// Initialize FirebaseApp
await Firebase.initializeApp();
// Initialize the Vertex AI service and the generative model
// Specify a model that supports your use case
// Gemini 1.5 models are versatile and can be used with all API capabilities
final model =
      FirebaseVertexAI.instance.generativeModel(model: 'gemini-1.5-flash-preview-0514');

完成入門指南後，請瞭解如何選擇 Gemini 模型，以及 (選用) 符合您用途和應用程式的位置。

步驟 4：呼叫 Vertex AI Gemini API

現在，您已將應用程式連結至 Firebase、新增 SDK，並初始化 Vertex AI 服務和生成式模型了，接著可以呼叫 Vertex AI Gemini API。

您可以使用 generateContent()，透過純文字提示要求生成文字：

import 'package:firebase_vertexai/firebase_vertexai.dart';
import 'package:firebase_core/firebase_core.dart';

await Firebase.initializeApp();
// Initialize the Vertex AI service and the generative model
// Specify a model that supports your use case
// Gemini 1.5 models are versatile and can be used with all API capabilities
final model =
      FirebaseVertexAI.instance.generativeModel(model: 'gemini-1.5-flash-preview-0514');

// Provide a prompt that contains text
final prompt = [Content.text('Write a story about a magic backpack.')];

// To generate text output, call generateContent with the text input
final response = await model.generateContent(prompt);
print(response.text);

您還能做些什麼？

進一步瞭解 Gemini 模型

瞭解不同用途適用的模型及配額與定價。

試用 Gemini API 的其他功能

瞭解如何控管內容生成功能

您也可以使用 Vertex AI Studio 測試提示和模型設定。


針對 Vertex AI for Firebase 使用體驗提供意見回饋