Esegui la migrazione agli SDK Firebase AI Logic dalla versione GA degli SDK Vertex AI in Firebase


Firebase AI Logic e i relativi SDK client erano precedentemente chiamati "Vertex AI in Firebase". Per riflettere meglio i nostri servizi e le funzionalità ampliate (ad esempio, ora supportiamo Gemini Developer API!), abbiamo rinominato e riorganizzato i nostri servizi in Firebase AI Logic.

Per accedere in modo sicuro ai modelli di AI generativa di Google direttamente da lle tue app web o mobile, ora puoi scegliere un provider "Gemini API" : l'API Vertex AI Gemini, disponibile da tempo, o ora l'API Gemini DeveloperGemini Developer API.Vertex AI Gemini API Ciò significa che ora hai la possibilità di utilizzare Gemini Developer API, che fornisce un livello senza costi aggiuntivi con limiti di frequenza e quote ragionevoli.

Panoramica dei passaggi per la migrazione agli Firebase AI Logic SDK

  • Passaggio 1: scegli il provider "Gemini API" più adatto alla tua app e ai tuoi casi d'uso.

  • Passaggio 2: configura il progetto Firebase in modo da poter utilizzare Gemini Developer API.
    Applicabile solo se passi all'utilizzo di Gemini Developer API anziché di Vertex AI Gemini API.

  • Passaggio 3: aggiorna la libreria utilizzata nella tua app.

  • Passaggio 4: aggiorna l'inizializzazione nella tua app.

  • Passaggio 5: aggiorna il codice a seconda delle funzionalità che utilizzi.

Passaggio 1: scegli il provider "API Gemini" più adatto alla tua app

Con questa migrazione, puoi scegliere il provider "Gemini API":

  • I vecchi SDK "Vertex AI in Firebase" potevano utilizzare solo l' Vertex AI Gemini API.

  • I nuovi Firebase AI Logic SDK ti consentono di scegliere quale "Gemini API" provider vuoi chiamare direttamente dalla tua app web o mobile: l'Gemini Developer API o l' Vertex AI Gemini API.

Esamina le differenze tra l'utilizzo dei due Gemini API provider, in particolare in termini di funzionalità supportate, prezzi e limiti di frequenza. Ad esempio, l'API Gemini Developer non supporta la fornitura di file tramite URL di Cloud Storage, ma potrebbe essere una buona scelta se vuoi usufruire del suo livello senza costi aggiuntivi e della quota ragionevole.Gemini Developer APICloud Storage

Passaggio 2: configura il progetto Firebase in modo da poter utilizzare Gemini Developer API

Questo passaggio è obbligatorio solo se vuoi passare all'utilizzo di Gemini Developer API con gli SDK client Firebase AI Logic. Tuttavia, se vuoi continuare a utilizzare Vertex AI Gemini API, vai al passaggio successivo.

Tieni presente che puoi avere entrambi i provider "API Gemini" abilitati nel tuo progetto contemporaneamente.

  1. Nella Firebase console, vai a Servizi AI > AI Logic.

  2. Vai alla scheda Impostazioni e seleziona Gemini Developer API.

  3. Attiva il Gemini Developer API.

    La console si assicurerà che le API richieste siano abilitate e genererà una Gemini chiave API nel tuo progetto Firebase.
    Non aggiungere questa chiave API Gemini al codice della tua app. Scopri di più.

  4. Continua a seguire questa guida alla migrazione per aggiornare la libreria e l'inizializzazione nella tua app.

Passaggio 3: aggiorna la libreria utilizzata nella tua app

Aggiorna il codice della tua app in modo che utilizzi la libreria Firebase AI Logic.

Swift

  1. In Xcode, con il progetto dell'app aperto, aggiorna il pacchetto Firebase alla versione 11.13.0 o successive utilizzando una delle seguenti opzioni:

    • Opzione 1: aggiorna tutti i pacchetti: vai a File > Pacchetti > Aggiorna alle versioni più recenti dei pacchetti.

    • Opzione 2: aggiorna Firebase singolarmente: vai al pacchetto Firebase nella sezione Dipendenze pacchetto. Fai clic con il tasto destro del mouse sul pacchetto Firebase e seleziona Aggiorna pacchetto.

  2. Assicurati che il pacchetto Firebase ora mostri la versione 11.13.0 o successive. In caso contrario, verifica che i requisiti del pacchetto specificati consentano l'aggiornamento alla versione 11.13.0 o successive.

  3. Seleziona la destinazione della tua app nell'editor del progetto, quindi vai alla sezione Framework, librerie e contenuti incorporati.

  4. Aggiungi la nuova libreria: seleziona il pulsante + e poi aggiungi FirebaseAI dal pacchetto Firebase.

  5. Dopo aver completato la migrazione dell'app (vedi le sezioni rimanenti di questa guida), assicurati di rimuovere la vecchia libreria:
    seleziona FirebaseVertexAI e poi premi il pulsante .

Kotlin

  1. Nel file Gradle del modulo (a livello di app) (in genere <project>/<app-module>/build.gradle.kts o <project>/<app-module>/build.gradle), sostituisci le vecchie dipendenze (se applicabili) con le seguenti.

    Tieni presente che potrebbe essere più facile eseguire la migrazione del codice della tua app (vedi le sezioni rimanenti di questa guida) prima di eliminare la vecchia dipendenza.

    // BEFORE
    dependencies {
      implementation(platform("com.google.firebase:firebase-bom:33.x.y"))
      implementation("com.google.firebase:firebase-vertexai")
      // OR if not using the BoM
      implementation("com.google.firebase:firebase-vertexai:16.x.y")
    }
    
    
    // AFTER
    dependencies {
      // Import the BoM for the Firebase platform
      implementation(platform("com.google.firebase:firebase-bom:34.13.0"))
    
      // Add the dependency for the Firebase AI Logic library
      // When using the BoM, you don't specify versions in Firebase library dependencies
      implementation("com.google.firebase:firebase-ai")
    }
  2. Sincronizza il tuo progetto Android con i file Gradle.

Tieni presente che, se scegli di non utilizzare il Firebase Android BoM, devi solo aggiungere la dipendenza per la libreria firebase-ai e accettare l'ultima versione suggerita da Android Studio.

Java

  1. Nel file Gradle del modulo (a livello di app) (in genere <project>/<app-module>/build.gradle.kts o <project>/<app-module>/build.gradle), sostituisci le vecchie dipendenze (se applicabili) con le seguenti.

    Tieni presente che potrebbe essere più facile eseguire la migrazione del codice della tua app (vedi le sezioni rimanenti di questa guida) prima di eliminare la vecchia dipendenza.

    // BEFORE
    dependencies {
      implementation(platform("com.google.firebase:firebase-bom:33.x.y"))
      implementation("com.google.firebase:firebase-vertexai")
      // OR if not using the BoM
      implementation("com.google.firebase:firebase-vertexai:16.x.y")
    }
    
    
    // AFTER
    dependencies {
      // Import the BoM for the Firebase platform
      implementation(platform("com.google.firebase:firebase-bom:34.13.0"))
    
      // Add the dependency for the Firebase AI Logic library
      // When using the BoM, you don't specify versions in Firebase library dependencies
      implementation("com.google.firebase:firebase-ai")
    }
  2. Sincronizza il tuo progetto Android con i file Gradle.

Tieni presente che, se scegli di non utilizzare il Firebase Android BoM, devi solo aggiungere la dipendenza per la libreria firebase-ai e accettare l'ultima versione suggerita da Android Studio.

Web

  1. Scarica l'ultima versione dell'SDK Firebase JS per il web utilizzando npm:

    npm i firebase@latest

    OPPURE

    yarn add firebase@latest
  2. Ovunque tu abbia importato la libreria, aggiorna le istruzioni di importazione in modo che utilizzino firebase/ai.

    Tieni presente che potrebbe essere più facile eseguire la migrazione del codice della tua app (vedi le sezioni rimanenti di questa guida) prima di eliminare le vecchie importazioni.

    // BEFORE
    import { initializeApp } from "firebase/app";
    import { getVertexAI, getGenerativeModel } from "firebase/vertexai";
    
    
    // AFTER
    import { initializeApp } from "firebase/app";
    import { getAI, getGenerativeModel } from "firebase/ai";

Dart

  1. Aggiorna l'utilizzo del pacchetto firebase_ai nel file pubspec.yaml eseguendo il seguente comando dalla directory del progetto Flutter:

    flutter pub add firebase_ai
  2. Ricrea il progetto Flutter:

    flutter run
  3. Dopo aver completato la migrazione dell'app (vedi le sezioni rimanenti di questa guida), assicurati di eliminare il vecchio pacchetto:

    flutter pub remove firebase_vertexai

Unity

Il supporto per Unity non era disponibile in "Vertex AI in Firebase".

Scopri come iniziare a utilizzare l'Firebase AI Logic SDK per Unity.

Passaggio 4: aggiorna l'inizializzazione nella tua app

Fai clic sul provider Gemini API per visualizzare contenuti specifici del provider e codice in questa pagina.

Aggiorna la modalità di inizializzazione del servizio per il provider dell'API scelto e crea un'istanza GenerativeModel.

Swift


import FirebaseAILogic

// Initialize the Gemini Developer API backend service
let ai = FirebaseAI.firebaseAI(backend: .googleAI())

// Create a `GenerativeModel` instance with a model that supports your use case
let model = ai.generativeModel(modelName: "gemini-3.5-flash")

Kotlin


// Initialize the Gemini Developer API backend service
// Create a `GenerativeModel` instance with a model that supports your use case
val model = Firebase.ai(backend = GenerativeBackend.googleAI())
                        .generativeModel("gemini-3.5-flash")

Java


// Initialize the Gemini Developer API backend service
// Create a `GenerativeModel` instance with a model that supports your use case
GenerativeModel ai = FirebaseAI.getInstance(GenerativeBackend.googleAI())
        .generativeModel("gemini-3.5-flash");

// Use the GenerativeModelFutures Java compatibility layer which offers
// support for ListenableFuture and Publisher APIs
GenerativeModelFutures model = GenerativeModelFutures.from(ai);

Web


import { initializeApp } from "firebase/app";
import { getAI, getGenerativeModel, GoogleAIBackend } from "firebase/ai";

// TODO(developer) Replace the following with your app's Firebase configuration
// See: https://firebase.google.com/docs/web/learn-more#config-object
const firebaseConfig = {
  // ...
};

// Initialize FirebaseApp
const firebaseApp = initializeApp(firebaseConfig);

// Initialize the Gemini Developer API backend service
const ai = getAI(firebaseApp, { backend: new GoogleAIBackend() });

// Create a `GenerativeModel` instance with a model that supports your use case
const model = getGenerativeModel(ai, { model: "gemini-3.5-flash" });

Dart


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

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

// Initialize the Gemini Developer API backend service
// Create a `GenerativeModel` instance with a model that supports your use case
final model =
      FirebaseAI.googleAI().generativeModel(model: 'gemini-3.5-flash');

Unity

Il supporto per Unity non era disponibile in "Vertex AI in Firebase".

Scopri come iniziare a utilizzare l'Firebase AI Logic SDK per Unity.

Tieni presente che a seconda della funzionalità che utilizzi, potresti non sempre creare un'istanza GenerativeModel instance. Per trasmettere in streaming input e output utilizzando l'Gemini Live API, crea un'istanza LiveModel.

Passaggio 5: aggiorna il codice a seconda delle funzionalità che utilizzi

Questo passaggio descrive le modifiche che potrebbero essere necessarie a seconda delle funzionalità che utilizzi.

  • Se utilizzi gli URL Cloud Storage e hai eseguito la migrazione all'utilizzo dell' Gemini Developer API in questa migrazione, devi aggiornare le richieste multimodali in modo da includere i file come dati in linea (o utilizzare gli URL di YouTube per i video).

  • Esamina i seguenti elenchi per verificare se devi apportare modifiche al codice per adottare l' Firebase AI Logic SDK.

Swift

Nessuna modifica aggiuntiva.

Kotlin

  • Live API

    • Rimosso il valore UNSPECIFIED per la classe enum ResponseModality. Utilizza invece null.

Java

  • Live API

    • Rimosso il valore UNSPECIFIED per la classe enum ResponseModality. Utilizza invece null.
  • Sono stati modificati vari metodi di creazione Java in modo che ora restituiscano correttamente l'istanza della relativa classe, anziché void.

Web

Modifiche richieste solo se inizi a utilizzare Gemini Developer API (anziché Vertex AI Gemini API):

  • Impostazioni di sicurezza

    • Sono stati rimossi gli utilizzi di SafetySetting.method, che non è supportato.
  • Dati in linea

    • Sono stati rimossi gli utilizzi di InlineDataPart.videoMetadata, che non è supportato.

Dart

Nessuna modifica aggiuntiva.

Unity

Il supporto per Unity non era disponibile in "Vertex AI in Firebase".

Scopri come iniziare a utilizzare l'Firebase AI Logic SDK per Unity.


Dai il tuo feedback sulla tua esperienza con Firebase AI Logic