Von der GA-Version von Vertex AI in Firebase SDKs zu den Firebase AI Logic SDKs migrieren


Firebase AI Logic und die zugehörigen Client-SDKs hießen früher Vertex AI in Firebase. Um unsere erweiterten Dienste und Funktionen besser widerzuspiegeln (wir unterstützen jetzt beispielsweise die Gemini Developer API), haben wir unsere Dienste umbenannt und in Firebase AI Logic verpackt.

Wenn Sie direkt über Ihre mobilen Apps oder Web-Apps sicher auf die generativen KI-Modelle von Google zugreifen möchten, können Sie jetzt einen „Gemini API“-Anbieter auswählen – entweder den seit langem verfügbaren Vertex AI Gemini API oder jetzt den Gemini Developer API. Sie haben jetzt die Möglichkeit, die Gemini Developer API zu verwenden, die eine kostenlose Stufe mit angemessenen Preislimits und Kontingenten bietet.

Schritte zur Migration zu den Firebase AI Logic SDKs

  • Schritt 1: Wählen Sie den besten „Gemini API“-Anbieter für Ihre App und Anwendungsfälle aus.

  • Schritt 2: Richten Sie Ihr Firebase-Projekt so ein, dass Sie die Gemini Developer API verwenden können.
    Nur anwendbar, wenn Sie anstelle der Vertex AI Gemini API die Gemini Developer API verwenden.

  • Schritt 3: Aktualisieren Sie die in Ihrer App verwendete Bibliothek.

  • Schritt 4: Aktualisieren Sie die Initialisierung in Ihrer App.

  • Schritt 5: Aktualisieren Sie den Code je nach verwendeten Funktionen.

Schritt 1: Den besten Gemini API-Anbieter für Ihre App auswählen

Bei dieser Migration haben Sie die Wahl zwischen den folgenden Gemini API-Anbietern:

  • Die alten „Vertex AI in Firebase“-SDKs konnten nur die Vertex AI Gemini API verwenden.

  • Mit den neuen Firebase AI Logic SDKs kannst du auswählen, welchen Gemini API-Anbieter du direkt über deine mobile App oder Web-App aufrufen möchtest – entweder den Gemini Developer API oder den Vertex AI Gemini API.

Sehen Sie sich die Unterschiede zwischen den beiden Gemini API-Anbietern an, insbesondere in Bezug auf unterstützte Funktionen, Preise und Preislimits. Beispielsweise unterstützt die Gemini Developer API nicht das Bereitstellen von Dateien über Cloud Storage-URLs. Sie ist aber eine gute Wahl, wenn Sie das kostenlose Abo und das angemessene Kontingent nutzen möchten.

Schritt 2: Firebase-Projekt so einrichten, dass Sie die Gemini Developer API verwenden können

Dieser Schritt ist nur erforderlich, wenn Sie von Gemini Developer API zu den Firebase AI Logic-Client-SDKs wechseln möchten. Wenn Sie die Vertex AI Gemini API jedoch weiterhin verwenden möchten, fahren Sie mit dem nächsten Schritt fort.

Es ist in Ordnung, wenn beide „Gemini API“-Anbieter gleichzeitig in Ihrem Projekt aktiviert sind.

  1. Rufen Sie in der Firebase Console die Seite Firebase AI Logic auf.

  2. Rufen Sie den Tab Einstellungen auf und wählen Sie Gemini Developer API aus.

  3. Aktivieren Sie die Gemini Developer API.

    In der Console wird dafür gesorgt, dass die erforderlichen APIs aktiviert sind, und es wird ein Gemini API-Schlüssel in Ihrem Firebase-Projekt generiert.
    Fügen Sie diesen Gemini API-Schlüssel nicht der Codebasis Ihrer App hinzu. Weitere Informationen

  4. Fahren Sie mit diesem Migrationsleitfaden fort, um die Bibliothek und die Initialisierung in Ihrer App zu aktualisieren.

Schritt 3: In Ihrer App verwendete Bibliothek aktualisieren

Aktualisieren Sie den Code Ihrer App, damit die Firebase AI Logic-Bibliothek verwendet wird.

Swift

  1. Aktualisieren Sie Ihr Firebase-Paket in Xcode auf Version 11.13.0 oder höher. Verwenden Sie dazu eine der folgenden Optionen:

    • Option 1: Alle Pakete aktualisieren: Gehen Sie zu Datei > Pakete > Auf die neuesten Paketversionen aktualisieren.

    • Option 2: Firebase einzeln aktualisieren: Rufen Sie im Bereich Paketabhängigkeiten das Firebase-Paket auf. Klicken Sie mit der rechten Maustaste auf das Firebase-Paket und wählen Sie Paket aktualisieren aus.

  2. Achten Sie darauf, dass für das Firebase-Paket jetzt Version 11.13.0 oder höher angezeigt wird. Andernfalls prüfen Sie, ob die von Ihnen angegebenen Paketanforderungen ein Update auf Version 11.13.0 oder höher zulassen.

  3. Wählen Sie im Project Editor das Ziel Ihrer App aus und gehen Sie dann zum Bereich Frameworks, Libraries und eingebettete Inhalte.

  4. Fügen Sie die neue Bibliothek hinzu: Klicken Sie auf das Pluszeichen + und fügen Sie dann FirebaseAI aus dem Firebase-Paket hinzu.

  5. Nachdem Sie die Migration Ihrer App abgeschlossen haben (siehe die verbleibenden Abschnitte in diesem Leitfaden), entfernen Sie die alte Bibliothek:
    Wählen Sie FirebaseVertexAI aus und drücken Sie dann die Schaltfläche –.

Kotlin

  1. Ersetzen Sie in der Gradle-Datei des Moduls (auf App-Ebene) (in der Regel <project>/<app-module>/build.gradle.kts oder <project>/<app-module>/build.gradle) gegebenenfalls alte Abhängigkeiten durch Folgendes:

    Es kann einfacher sein, die Codebasis Ihrer App zu migrieren (siehe die verbleibenden Abschnitte in diesem Leitfaden), bevor Sie die alte Abhängigkeit löschen.

    // 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:33.14.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. Synchronisieren Sie Ihr Android-Projekt mit Gradle-Dateien.

Wenn Sie die Firebase Android BoM nicht verwenden möchten, fügen Sie einfach die Abhängigkeit für die firebase-ai-Bibliothek hinzu und akzeptieren Sie die neueste Version, die von Android Studio vorgeschlagen wird.

Java

  1. Ersetzen Sie in der Gradle-Datei des Moduls (auf App-Ebene) (in der Regel <project>/<app-module>/build.gradle.kts oder <project>/<app-module>/build.gradle) gegebenenfalls alte Abhängigkeiten durch Folgendes:

    Es kann einfacher sein, die Codebasis Ihrer App zu migrieren (siehe die verbleibenden Abschnitte in diesem Leitfaden), bevor Sie die alte Abhängigkeit löschen.

    // 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:33.14.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. Synchronisieren Sie Ihr Android-Projekt mit Gradle-Dateien.

Wenn Sie die Firebase Android BoM nicht verwenden möchten, fügen Sie einfach die Abhängigkeit für die firebase-ai-Bibliothek hinzu und akzeptieren Sie die neueste Version, die von Android Studio vorgeschlagen wird.

Web

  1. So rufen Sie die neueste Version des Firebase JS SDK für das Web mit npm ab:

    npm i firebase@latest

    ODER

    yarn add firebase@latest

  2. Aktualisieren Sie Ihre Importanweisungen an allen Stellen, an denen Sie die Bibliothek importiert haben, und verwenden Sie stattdessen firebase/ai.

    Es kann einfacher sein, die Codebasis Ihrer App zu migrieren (siehe die verbleibenden Abschnitte in diesem Leitfaden), bevor Sie die alten Importe löschen.

    // 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. Aktualisieren Sie die Verwendung des firebase_ai-Pakets in Ihrer pubspec.yaml-Datei, indem Sie den folgenden Befehl aus dem Flutter-Projektverzeichnis ausführen:

    flutter pub add firebase_ai

  2. Erstellen Sie Ihr Flutter-Projekt neu:

    flutter run

  3. Nachdem Sie die Migration Ihrer App abgeschlossen haben (siehe die restlichen Abschnitte in dieser Anleitung), löschen Sie das alte Paket:

    flutter pub remove firebase_vertexai

Einheit

„Vertex AI in Firebase“ unterstützte Unity nicht.

Weitere Informationen zum Einstieg in das Firebase AI Logic SDK for Unity

Schritt 4: Initialisierung in Ihrer App aktualisieren

Klicke auf deinen Gemini API-Anbieter, um dir anbieterspezifische Inhalte und Code auf dieser Seite anzusehen.

Aktualisieren Sie die Initialisierung des Dienstes für den ausgewählten API-Anbieter und erstellen Sie eine GenerativeModel-Instanz.

Swift 


import FirebaseAI

// 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-2.0-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-2.0-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-2.0-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-2.0-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-2.0-flash');

Einheit

„Vertex AI in Firebase“ unterstützte Unity nicht.

Weitere Informationen zum Einstieg in das Firebase AI Logic SDK for Unity

Je nach verwendeter Funktion wird möglicherweise nicht immer eine GenerativeModel-Instanz erstellt.

Schritt 5: Code je nach verwendeten Funktionen aktualisieren

In diesem Schritt werden Änderungen beschrieben, die je nach verwendeten Funktionen erforderlich sein können.

  • Wenn Sie Cloud Storage-URLs verwendet haben und bei dieser Migration auf Gemini Developer API umgestellt haben, müssen Sie Ihre multimodalen Anfragen aktualisieren, um Dateien als Inline-Daten einzubinden (oder YouTube-URLs für Videos zu verwenden).

  • Sehen Sie sich die folgenden Listen an, um zu prüfen, ob Sie Änderungen an Ihrem Code vornehmen müssen, um das Firebase AI Logic SDK zu verwenden.

Swift

Keine weiteren Änderungen.

Kotlin

  • Live API

    • Der Wert UNSPECIFIED für die Enum-Klasse ResponseModality wurde entfernt. Verwenden Sie stattdessen null.

Java

  • Live API

    • Der Wert UNSPECIFIED für die Enum-Klasse ResponseModality wurde entfernt. Verwenden Sie stattdessen null.

  • Verschiedene Java-Builder-Methoden wurden geändert, sodass jetzt die Instanz ihrer Klasse statt „void“ zurückgegeben wird.

Web

Änderungen sind nur erforderlich, wenn Sie die Gemini Developer API anstelle der Vertex AI Gemini API verwenden:

  • Sicherheitseinstellungen

    • Die Verwendung der nicht unterstützten SafetySetting.method wurde entfernt.

  • Inline-Daten

    • Die Verwendung der nicht unterstützten InlineDataPart.videoMetadata wurde entfernt.

Dart

Keine weiteren Änderungen.

Einheit

Der Support für Unity war von „Vertex AI in Firebase“ nicht verfügbar.

Weitere Informationen zum Einstieg in das Firebase AI Logic SDK for Unity


Feedback zu Firebase AI Logic geben