通过 Vertex AI for Firebase SDK 开始使用 Gemini API


本指南介绍了如何开始使用 Vertex AI for Firebase SDK 从您的应用中直接调用 Vertex AI Gemini API。

前提条件

本指南假定您熟悉 Flutter 应用的开发。

  • 请确保您的开发环境和 Web 应用满足以下要求：

    • Dart 3.2.0 及更高版本

  • （可选）查看示例应用。

    下载示例应用

    您可以快速试用 SDK，查看各种用例的完整实现，或者使用示例应用（如果您没有自己的 Web 应用）。如需使用示例应用，您需要将其关联到 Firebase 项目。

第 1 步：设置一个 Firebase 项目，并将您的应用关联到 Firebase

如果您已有 Firebase 项目和已关联到 Firebase 的应用

  1. 在 Firebase 控制台中，前往“使用 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 服务和生成模型

在进行任何 API 调用之前，您需要初始化 Vertex AI 服务和生成模型。

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 for Firebase 使用体验提供反馈