Get started with the Gemini API using the Vertex AI for Firebase SDKs

iOS+ Android Web Flutter

This guide shows you how to get started making calls to the Vertex AI Gemini API directly from your app using the Vertex AI for Firebase SDKs.

Other options for working with the Gemini API

• You can optionally call the Vertex AI Gemini API server-side using the server-side Vertex AI SDKs or Firebase Extensions for the Gemini API.

• You can optionally try an alternative "Google AI" version of the Gemini API that provides free-of-charge access (within limits and where available) using Google AI Studio and Google AI SDKs.

  If you choose to use Google AI tools and services as well as Firebase, we recommend the following:

  • Do not use Google AI Studio and Google AI SDKs with a Firebase project that's used by your production app.
  • After you're familiar with how a Gemini API works, migrate to the Vertex AI for Firebase SDKs, which have many additional features important for mobile and web apps, like protecting the API from abuse using Firebase App Check.

Prerequisites

Step 1: Set up a Firebase project and connect your app to Firebase

If you already have a Firebase project and an app connected to Firebase

1. In the Firebase console, go to the Build with Gemini page, and then click the second card to launch a workflow that helps you do the following tasks. If you see a tab in the console for Vertex AI, then these tasks are complete.

   • Upgrade your project to use the Blaze pay-as-you-go pricing plan.

   • Enable the following two APIs for your project:
     aiplatform.googleapis.com and firebaseml.googleapis.com.

2. Continue to the next step in this guide to add the SDK to your app.

If you do not already have a Firebase project and an app connected to Firebase

Set up a Firebase project

1. Sign into the Firebase console.

2. Click Create project, and then use either of the following options:

   • Option 1: Create a wholly new Firebase project (and its underlying Google Cloud project automatically) by entering a new project name in the first step of the "Create project" workflow.

   • Option 2: "Add Firebase" to an existing Google Cloud project by selecting your Google Cloud project name from the drop-down menu in the first step of the "Create project" workflow.

   Note that when prompted, you do not need to set up Google Analytics to use the Vertex AI for Firebase SDKs.

3. In the Firebase console, go to the Build with Gemini page, and then click the second card to launch a workflow that helps you do the following tasks. If you see a tab in the console for Vertex AI, then these tasks are complete.

   • Upgrade your project to use the Blaze pay-as-you-go pricing plan.

   • Enable the following two APIs for your project:
     aiplatform.googleapis.com and firebaseml.googleapis.com.

Connect your app to Firebase

Step 2: Add the SDK

With your Firebase project set up and your app connected to Firebase (see previous step), you can now add the Vertex AI for Firebase SDK to your app.

Step 3: Initialize the Vertex AI service and the generative model

Before you can make any API calls, you need to initialize the Vertex AI service and the generative model.

When you've finished the getting started guide, learn how to choose a Gemini model and (optionally) a location appropriate for your use case and app.

Step 4: Call the Vertex AI Gemini API

Now that you've connected your app to Firebase, added the SDK, and initialized the Vertex AI service and the generative model, you're ready to call the Vertex AI Gemini API.

You can use generateContent() to generate text from a text-only prompt request:

What else can you do?

Learn more about the Gemini models

Learn about the models available for various use cases and their quotas and pricing.

Try out other capabilities of the Gemini API

• Learn more about generating text from text-only prompts, including how to stream the response.
• Generate text from multimodal prompts (including text, images, PDFs, video, and audio).
• Build multi-turn conversations (chat).
• Use function calling to connect generative models to external systems and information.

Learn how to control content generation

• Understand prompt design, including best practices, strategies, and example prompts.
• Configure model parameters like temperature and maximum output tokens.
• Use safety settings to adjust the likelihood of getting responses that may be considered harmful.

You can also experiment with prompts and model configurations using Vertex AI Studio.

Give feedback about your experience with Vertex AI for Firebase