Comienza a usar la API de Gemini con Vertex AI en los SDK de Firebase


En esta guía, se muestra cómo comenzar a realizar llamadas a Vertex AI Gemini API directamente desde tu app con el SDK de Vertex AI in Firebase para la plataforma que elijas.

Ten en cuenta que también puedes usar esta guía para comenzar a acceder a modelos de Imagen con los SDK de Vertex AI in Firebase.

Requisitos previos

En esta guía, se da por sentado que conoces el desarrollo de apps con Flutter.

  • Asegúrate de que tu entorno de desarrollo y tu app de Flutter cumplan con los siguientes requisitos:

    • Dart 3.2.0 y versiones posteriores
  • (Opcional) Consulta la app de ejemplo.

    Descarga la app de ejemplo

    Puedes probar el SDK rápidamente, ver una implementación completa de varios casos de uso o usar la app de ejemplo si no tienes tu propia app de Flutter. Para usar la app de ejemplo, deberás conectarla a un proyecto de Firebase.

Paso 1: Configura un proyecto de Firebase y conecta tu app a Firebase

Si ya tienes un proyecto de Firebase y una app conectada a Firebase

  1. En la consola de Firebase, ve a la página Crear con Gemini.

  2. Haz clic en la tarjeta Vertex AI in Firebase para iniciar un flujo de trabajo que te ayude a completar las siguientes tareas:

  3. Continúa con el siguiente paso de esta guía para agregar el SDK a tu app.

Si no tienes un proyecto de Firebase ni una app conectada a Firebase

  1. Accede Firebase console.

  2. Haz clic en Crear proyecto y, luego, usa una de las siguientes opciones:

    • Opción 1: Crea un proyecto de Firebase completamente nuevo (y su proyecto subyacente de Google Cloud automáticamente); para ello, ingresa un nuevo nombre de proyecto en el primer paso del flujo de trabajo "Crear proyecto".

    • Opción 2: "Agrega Firebase" a un proyecto de Google Cloud existente; para ello, selecciona el nombre de tu proyecto de Google Cloud del menú desplegable del primer paso del flujo de trabajo "Crear proyecto".

    Ten en cuenta que, cuando se te solicite, no es necesario que configures Google Analytics para usar los SDK de Vertex AI in Firebase.

  3. En la consola de Firebase, ve a la página Crear con Gemini.

  4. Haz clic en la tarjeta Vertex AI in Firebase para iniciar un flujo de trabajo que te ayude a completar las siguientes tareas:

  1. Instala las herramientas de línea de comandos necesarias:

    1. Si aún no lo hiciste, Instala la CLI de Firebase.

    2. Accede a Firebase con tu Cuenta de Google ejecutando el siguiente comando:

      firebase login
      
    3. Para instalar la CLI de FlutterFire, ejecuta el siguiente comando desde cualquier directorio:

      dart pub global activate flutterfire_cli
      
  2. Configura tus apps para usar Firebase:

    Usa la CLI de FlutterFire para configurar tus apps de Flutter para conectarte a Firebase.

    Desde el directorio de tu proyecto de Flutter, ejecuta el siguiente comando para iniciar el flujo de trabajo de configuración de la app:

    flutterfire configure
    

    El flujo de trabajo flutterfire configure hace lo siguiente:

    • Te pide que selecciones las plataformas (iOS, Android y Web) compatibles con tu app de Flutter. Para cada plataforma seleccionada, la CLI de FlutterFire crea una app nueva de Firebase en tu proyecto de Firebase.

      Puedes seleccionar un proyecto de Firebase existente o uno nuevo. Si ya tienes apps registradas en un proyecto existente de Firebase, la CLI de FlutterFire intentará establecer coincidencias con ellas según la configuración actual de tu proyecto de Flutter.

    • Se crea un archivo de configuración de Firebase (firebase_options.dart) y se agrega al directorio lib/ de tu app de Flutter.

  3. En los próximos pasos de esta guía, agregarás el SDK de Vertex AI in Firebase a tu app y completarás la inicialización necesaria específica para usar el SDK y Gemini API.


Paso 2: Agrega el SDK

Con tu proyecto de Firebase configurado y tu app conectada a Firebase (consulta el paso anterior), ahora puedes agregar el SDK de Vertex AI in Firebase a tu app.

El complemento Vertex AI in Firebase para Flutter (firebase_vertexai) proporciona acceso a las APIs para interactuar con los modelos Gemini y Imagen.

  1. Desde el directorio de tu proyecto de Flutter, ejecuta el siguiente comando para instalar el complemento principal y el complemento Vertex AI in Firebase:

    flutter pub add firebase_core && flutter pub add firebase_vertexai
    
  2. En el archivo lib/main.dart, importa el complemento principal de Firebase, el complemento Vertex AI in Firebase y el archivo de configuración que generaste antes:

    import 'package:firebase_core/firebase_core.dart';
    import 'package:firebase_vertexai/firebase_vertexai.dart';
    import 'firebase_options.dart';
    
  3. Además, en tu archivo lib/main.dart, inicializa Firebase con el objeto DefaultFirebaseOptions exportado por el archivo de configuración:

    await Firebase.initializeApp(
      options: DefaultFirebaseOptions.currentPlatform,
    );
    
  4. Vuelve a compilar tu aplicación de Flutter:

    flutter run
    

Paso 3: Inicializa el servicio Vertex AI y el modelo generativo

Antes de poder realizar llamadas a la API y solicitar un modelo Gemini, debes inicializar el servicio Vertex AI y el modelo generativo.

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

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

// Initialize the Vertex AI service and the generative model
// Specify a model that supports your use case
final model =
      FirebaseVertexAI.instance.generativeModel(model: 'gemini-2.0-flash');

Después de terminar esta guía de introducción, obtén información para elegir un modelo y, de manera opcional, una ubicación adecuada para tu caso de uso y app.

Paso 4: Envía una solicitud de instrucción a un modelo

Ahora que conectaste tu app a Firebase, agregaste el SDK y inicializaste el servicio Vertex AI y el modelo generativo, está todo listo para enviar una solicitud de instrucción a un modelo Gemini.

Puedes usar generateContent() para generar texto a partir de una solicitud de instrucción solo de texto:

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

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

// Initialize the Vertex AI service and the generative model
// Specify a model that supports your use case
final model =
      FirebaseVertexAI.instance.generativeModel(model: 'gemini-2.0-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);

¿Qué más puedes hacer?

Más información sobre los modelos compatibles

Obtén información sobre los modelos disponibles para varios casos de uso y sus cuotas y precios.

Prueba otras funciones de Gemini API

Aprende a controlar la generación de contenido

También puedes experimentar con instrucciones y configuraciones de modelos con Vertex AI Studio.


Envía comentarios sobre tu experiencia con Vertex AI in Firebase