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


本指南将为您介绍如何开始调用 Vertex AI Gemini API Vertex AI in Firebase SDK(适用于您所选平台)。

前提条件

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

  • 确保您的开发环境和 Flutter 应用符合以下要求 要求:

    • Dart 3.2.0 及更高版本
  • (可选)查看示例应用。

    下载示例应用

    您可以快速试用该 SDK,并查看各种用法的完整实现。 或使用示例应用(如果您没有自己的 Flutter 应用)。 要使用示例应用,您需要: 将其关联到 Firebase 项目

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

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

  1. Firebase 控制台中,前往 Build with Gemini 页面中, 然后点击第二张卡片启动工作流程 后续任务。如果您在控制台中看到 Vertex AI 的标签页,则 这些任务都已完成。

  2. 继续执行本指南中的下一步,将 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的体验