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
Se vuoi continuare a utilizzare Vertex AI Gemini API:
Salta il passaggio successivo e vai direttamente a aggiornare la libreria nella tua app, quindi al resto di questa guida.Se vuoi passare all'Gemini Developer API:
Continua con il passaggio successivo per configurare il progetto Firebase in modo che utilizzi questa API, quindi il resto di questa guida.
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.
Nella Firebase console, vai a Servizi AI > AI Logic.
Vai alla scheda Impostazioni e seleziona Gemini Developer API.
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ù.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
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.
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.
Seleziona la destinazione della tua app nell'editor del progetto, quindi vai alla sezione Framework, librerie e contenuti incorporati.
Aggiungi la nuova libreria: seleziona il pulsante + e poi aggiungi FirebaseAI dal pacchetto Firebase.
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
Nel file Gradle del modulo (a livello di app) (in genere
<project>/<app-module>/build.gradle.ktso<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 BoMimplementation("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") }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
Nel file Gradle del modulo (a livello di app) (in genere
<project>/<app-module>/build.gradle.ktso<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 BoMimplementation("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") }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
Scarica l'ultima versione dell'SDK Firebase JS per il web utilizzando npm:
npm i firebase@latest
OPPURE
yarn add firebase@latest
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
Aggiorna l'utilizzo del pacchetto
firebase_ainel filepubspec.yamleseguendo il seguente comando dalla directory del progetto Flutter:flutter pub add firebase_ai
Ricrea il progetto Flutter:
flutter run
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 Vertex AI Gemini API backend service
let ai = FirebaseAI.firebaseAI(backend: .vertexAI())
// Create a `GenerativeModel` instance with a model that supports your use case
let model = ai.generativeModel(modelName: "gemini-3.5-flash")
Kotlin
// Initialize the Vertex AI Gemini API backend service
// Create a `GenerativeModel` instance with a model that supports your use case
val model = Firebase.ai(backend = GenerativeBackend.vertexAI())
.generativeModel("gemini-3.5-flash")
Java
// Initialize the Vertex AI Gemini API backend service
// Create a `GenerativeModel` instance with a model that supports your use case
GenerativeModel ai = FirebaseAI.getInstance(GenerativeBackend.vertexAI())
.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, VertexAIBackend } 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 Vertex AI Gemini API backend service
const ai = getAI(firebaseApp, { backend: new VertexAIBackend() });
// 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 Vertex AI Gemini API backend service
// Create a `GenerativeModel` instance with a model that supports your use case
final model =
FirebaseAI.vertexAI().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
UNSPECIFIEDper la classe enumResponseModality. Utilizza invecenull.
- Rimosso il valore
Java
Live API
- Rimosso il valore
UNSPECIFIEDper la classe enumResponseModality. Utilizza invecenull.
- Rimosso il valore
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.
- Sono stati rimossi gli utilizzi di
Dati in linea
- Sono stati rimossi gli utilizzi di
InlineDataPart.videoMetadata, che non è supportato.
- Sono stati rimossi gli utilizzi di
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