在 Firebase SDK 中使用 Vertex AI 開始使用 Gemini API


本指南說明如何開始使用所選平台的 Vertex AI in Firebase SDK,直接從應用程式呼叫 Vertex AI Gemini API

事前準備

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

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

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

  1. Firebase 主控台中,前往「使用 Gemini 進行建構」頁面

  2. 按一下 Vertex AI in Firebase 資訊卡,即可啟動工作流程,協助您完成下列工作。(請注意,如果您在主控台中看到 Vertex AI 的索引標籤,表示這些工作已完成)。

  3. 請繼續參閱本指南的後續步驟,將 SDK 新增至應用程式。

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


步驟 2:新增 SDK

Firebase 專案已設定完成,應用程式也已連結至 Firebase (請參閱上一個步驟),因此您現在可以將 Vertex AI in Firebase SDK 新增至應用程式。

Flutter 的 Vertex AI in 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');

完成入門指南後,請瞭解如何選擇適合用途和應用程式的 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');

// 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 in Firebase 的感想