In diesem Leitfaden erfahren Sie, wie Sie mit den Firebase AI Logic-Client-SDKs für die von Ihnen ausgewählte Plattform direkt aus Ihrer App heraus Aufrufe an die Gemini API senden können.
Vorbereitung
Swift
In diesem Leitfaden wird davon ausgegangen, dass Sie mit der Verwendung von Xcode zum Entwickeln von Apps für Apple-Plattformen (z. B. iOS) vertraut sind.
Ihre Entwicklungsumgebung und Ihre Apple-Plattform-App müssen die folgenden Anforderungen erfüllen:
- Xcode 26.2 oder höher
- Ihre App ist auf iOS 15 oder höher oder macOS 12 oder höher ausgerichtet.
Kotlin
In diesem Leitfaden wird davon ausgegangen, dass Sie mit der Entwicklung von Android-Apps in Android Studio vertraut sind.
Ihre Entwicklungsumgebung und Ihre Android-App müssen die folgenden Anforderungen erfüllen:
- Android Studio (aktuelle Version)
- Ihre App ist auf API-Level 24 (Nougat) oder höher ausgerichtet.
Java
In dieser Anleitung wird davon ausgegangen, dass Sie mit der Entwicklung von Android-Apps mit Android Studio vertraut sind.
Ihre Entwicklungsumgebung und Ihre Android-App müssen die folgenden Anforderungen erfüllen:
- Android Studio (aktuelle Version)
- Ihre App ist auf API-Level 24 (Nougat) oder höher ausgerichtet.
Web
In diesem Leitfaden wird davon ausgegangen, dass Sie mit der Verwendung von JavaScript zur Entwicklung von Web-Apps vertraut sind. Dieser Leitfaden ist frameworkunabhängig.
Ihre Entwicklungsumgebung und Webanwendung müssen die folgenden Anforderungen erfüllen:
- (Optional) Node.js
- Moderner Webbrowser
Dart
In diesem Leitfaden wird davon ausgegangen, dass Sie mit der Entwicklung von Apps mit Flutter vertraut sind.
Ihre Entwicklungsumgebung und Ihre Flutter-App müssen die folgenden Anforderungen erfüllen:
- Dart 3.2.0 und höher
Einheit
In diesem Leitfaden wird davon ausgegangen, dass Sie mit der Entwicklung von Spielen mit Unity vertraut sind.
Ihre Entwicklungsumgebung und Ihr Unity-Spiel müssen die folgenden Anforderungen erfüllen:
- Unity Editor 2021 LTS oder höher
Hilfreiche Ressourcen ansehen
Swift
Kurzanleitung-App ausprobieren
Mit der Schnellstart-App können Sie das SDK schnell ausprobieren und eine vollständige Implementierung verschiedener Anwendungsfälle sehen. Wenn Sie keine eigene App für Apple-Plattformen haben, können Sie die Schnellstart-App verwenden. Dazu müssen Sie sie mit einem Firebase-Projekt verbinden.
Videoanleitung ansehen
In diesem Video wird gezeigt, wie Sie mit Firebase AI Logic beginnen, indem Sie eine KI-basierte App zur Essensplanung erstellen, die Rezepte aus einem Text-Prompt generiert.
Sie können die Codebasis für die App im Video auch herunterladen und sich ansehen.
Codebasis für die App des Videos ansehen
Kotlin
Kurzanleitung für die App ausprobieren
Mit der Kurzanleitungs-App können Sie das SDK schnell ausprobieren und eine vollständige Implementierung verschiedener Anwendungsfälle sehen. Wenn Sie keine eigene Android-App haben, können Sie die Schnellstart-App verwenden. Dazu müssen Sie sie mit einem Firebase-Projekt verbinden.
Videoanleitung ansehen
In diesem Video wird gezeigt, wie Sie mit Firebase AI Logic beginnen, indem Sie eine KI-basierte App zur Essensplanung erstellen, die Rezepte aus einem Text-Prompt generiert.
Sie können auch die Codebasis für die App im Video herunterladen und erkunden.
Codebasis für die App des Videos ansehen
Java
Kurzanleitung-App ausprobieren
Mit der Kurzanleitungs-App können Sie das SDK schnell ausprobieren und eine vollständige Implementierung verschiedener Anwendungsfälle sehen. Wenn Sie keine eigene Android-App haben, können Sie die Schnellstart-App verwenden. Dazu müssen Sie sie mit einem Firebase-Projekt verbinden.
Videoanleitung ansehen
In diesem Video wird gezeigt, wie Sie mit Firebase AI Logic beginnen, indem Sie eine KI-basierte App zur Essensplanung erstellen, die Rezepte aus einem Text-Prompt generiert.*
Sie können auch die Codebasis für die App im Video herunterladen und erkunden.
Codebasis für die App im Video ansehen
* Dieses Video und die zugehörige App sind in Kotlin, aber sie können Java-Entwicklern trotzdem helfen, die Grundlagen für den Einstieg in Firebase AI Logic zu verstehen.
Web
Kurzanleitung-App ausprobieren
Mit der Schnellstart-App können Sie das SDK schnell ausprobieren und eine vollständige Implementierung verschiedener Anwendungsfälle sehen. Wenn Sie keine eigene Web-App haben, können Sie die Schnellstart-App verwenden. Dazu müssen Sie sie mit einem Firebase-Projekt verbinden.
Dart
Kurzanleitung-App ausprobieren
Mit der Kurzanleitungs-App können Sie das SDK schnell ausprobieren und eine vollständige Implementierung verschiedener Anwendungsfälle sehen. Wenn Sie keine eigene Flutter-App haben, können Sie die Schnellstart-App verwenden. Dazu müssen Sie sie mit einem Firebase-Projekt verbinden.
Videoanleitung ansehen
In diesem Video wird gezeigt, wie Sie mit Firebase AI Logic beginnen, indem Sie eine KI-basierte App zur Essensplanung erstellen, die Rezepte aus einem Text-Prompt generiert.
Sie können auch die Codebasis für die App im Video herunterladen und erkunden.
Codebasis für die App des Videos ansehen
Einheit
Kurzanleitung-App ausprobieren
Mit der Schnellstart-App können Sie das SDK schnell ausprobieren und eine vollständige Implementierung verschiedener Anwendungsfälle sehen. Oder verwenden Sie die Schnellstart-App, wenn Sie kein eigenes Unity-Spiel haben. Wenn Sie die Kurzanwendungs-App verwenden möchten, müssen Sie sie mit einem Firebase-Projekt verbinden.
Schritt 1: Firebase-Projekt einrichten und APIs aktivieren
Melden Sie sich in der Firebase Console an und wählen Sie Ihr Firebase-Projekt aus.
Rufen Sie in der Firebase Console AI Services > AI Logic auf.
Klicken Sie auf Jetzt starten, um einen geführten Workflow zu starten, der Sie beim Einrichten der erforderlichen APIs und Ressourcen für Ihr Projekt unterstützt.
Folgen Sie bei Aufforderung der Anleitung auf dem Bildschirm, um Ihre App zu registrieren und die Firebase-Konfiguration hinzuzufügen.
Wenn Sie aufgefordert werden, einen „Gemini API-Anbieter“ auszuwählen, empfehlen wir die Gemini Developer API, mit der Sie schnell und kostenlos loslegen können.
Sie können die Agent Platform Gemini API (formerly Vertex AI) (und die Abrechnungsanforderung) jederzeit später einrichten.
Fahren Sie im Workflow fort, um die erforderlichen APIs und zugehörigen Dienste für Firebase AI Logic einzurichten.
Ab Anfang Juli 2026 wird in dieser Phase des Workflows automatisch Firebase App Check für AI Logic erzwungen. Dies ist ein wichtiger Dienst, der zum Schutz von Gemini API beiträgt, wenn direkt über Ihre App darauf zugegriffen wird. Im Rahmen der ersten Schritte (siehe Schritte weiter unten in diesem Leitfaden) müssen Sie den Debug-Anbieter für App Check für die lokale Entwicklung konfigurieren, wenn App Check erzwungen wird.
Fahren Sie mit dem nächsten Schritt in dieser Anleitung fort, um die erforderlichen SDKs zu Ihrer App hinzuzufügen.
Schritt 2: Erforderliche SDKs hinzufügen
Nachdem Sie Ihr Firebase-Projekt eingerichtet und die erforderlichen APIs aktiviert haben (siehe vorheriger Schritt), können Sie Ihrer App die erforderlichen SDKs hinzufügen.
Swift
Verwenden Sie Swift Package Manager, um Firebase-Abhängigkeiten zu installieren und zu verwalten. Weitere Installationsoptionen
Die Bibliothek Firebase AI Logic bietet Zugriff auf die APIs für die Interaktion mit Gemini-Modellen. Die Bibliothek ist im Firebase SDK für Apple-Plattformen (firebase-ios-sdk) enthalten.
Wenn Sie Firebase bereits verwenden, muss Ihr Firebase-Paket die Version 12.5.0 oder höher haben.
Öffnen Sie Ihr App-Projekt und gehen Sie in Xcode zu File > Add Package Dependencies (Datei > Paketabhängigkeiten hinzufügen).
Fügen Sie bei entsprechender Aufforderung das Firebase Apple Platforms SDK-Repository hinzu:
https://github.com/firebase/firebase-ios-sdkWählen Sie die neueste SDK-Version aus.
Wählen Sie die Bibliotheken
FirebaseAILogicundFirebaseAppCheckaus.
Anschließend löst Xcode die Abhängigkeiten automatisch auf und lädt sie im Hintergrund herunter.
Kotlin
Das Firebase AI Logic-SDK für Android (firebase-ai) bietet Zugriff auf die APIs für die Interaktion mit Gemini-Modellen.
Fügen Sie in der Gradle-Datei Ihres Moduls (auf App-Ebene) (z. B. <project>/<app-module>/build.gradle.kts) die Abhängigkeiten für die Firebase AI Logic- und App Check-Bibliotheken für Android hinzu. Wir empfehlen, die Firebase Android BoM zu verwenden, um die Versionsverwaltung der Bibliothek zu steuern.
dependencies { // ... other androidx dependencies // Import the BoM for the Firebase platform implementation(platform("com.google.firebase:firebase-bom:35.0.0")) // Add the dependencies for the Firebase AI Logic and App Check libraries // When using the BoM, you don't specify versions in Firebase library dependencies implementation("com.google.firebase:firebase-ai") implementation("com.google.firebase:firebase-appcheck-debug") }
Mit der Firebase Android BoM haben Sie immer eine kompatible Version der Firebase Android-Bibliotheken in Ihrer App.
Java
Das Firebase AI Logic SDK for Android (firebase-ai) bietet Zugriff auf die APIs für die Interaktion mit Gemini-Modellen.
Fügen Sie in der Gradle-Datei Ihres Moduls (auf App-Ebene) (z. B. <project>/<app-module>/build.gradle.kts) die Abhängigkeiten für die Bibliotheken Firebase AI Logic und App Check für Android hinzu. Wir empfehlen, die Firebase Android BoM zu verwenden, um die Bibliotheksversionierung zu steuern.
Für Java müssen Sie zwei zusätzliche Bibliotheken hinzufügen.
dependencies { // ... other androidx dependencies // Import the BoM for the Firebase platform implementation(platform("com.google.firebase:firebase-bom:35.0.0")) // Add the dependencies for the Firebase AI Logic and App Check libraries // When using the BoM, you don't specify versions in Firebase library dependencies implementation("com.google.firebase:firebase-ai") implementation("com.google.firebase:firebase-appcheck-debug") // Required for one-shot operations (to use `ListenableFuture` from Guava Android) implementation("com.google.guava:guava:31.0.1-android") // Required for streaming operations (to use `Publisher` from Reactive Streams) implementation("org.reactivestreams:reactive-streams:1.0.4") }
Mit der Firebase Android BoM haben Sie immer eine kompatible Version der Firebase Android-Bibliotheken in Ihrer App.
Web
Die Bibliothek Firebase AI Logic bietet Zugriff auf die APIs für die Interaktion mit Gemini-Modellen. Die Bibliothek ist Teil des Firebase JavaScript SDK for Web.
Installieren Sie das Firebase JS SDK für Web mit npm:
npm install firebaseInitialisieren Sie Firebase in Ihrer App:
import { initializeApp } from "firebase/app"; import { initializeAppCheck, DebugProvider } from "firebase/app-check"; // 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);
Dart
Das Firebase AI Logic-Plug-in für Flutter (firebase_ai) bietet Zugriff auf die APIs für die Interaktion mit Gemini-Modellen.
Führen Sie im Flutter-Projektverzeichnis den folgenden Befehl aus, um die Plug-ins Firebase AI Logic und App Check zu installieren:
flutter pub add firebase_ai firebase_app_checkImportieren Sie in der Datei
lib/main.dartdie Plug-ins Firebase AI Logic und App Check:import 'package:firebase_core/firebase_core.dart'; import 'package:firebase_ai/firebase_ai.dart'; import 'package:firebase_app_check/firebase_app_check.dart'; import 'firebase_options.dart';Achten Sie außerdem darauf, dass Sie in Ihrer
lib/main.dart-Datei Firebase mit demDefaultFirebaseOptions-Objekt initialisiert haben, das von der Konfigurationsdatei exportiert wird:await Firebase.initializeApp( options: DefaultFirebaseOptions.currentPlatform, );Erstellen Sie Ihre Flutter-Anwendung neu:
flutter run
Einheit
Laden Sie das Firebase Unity SDK herunter und extrahieren Sie es an einem geeigneten Ort.
Das Firebase Unity SDK ist nicht plattformspezifisch.
Rufen Sie in Ihrem geöffneten Unity-Projekt Assets > Import Package > Custom Package auf.
Wählen Sie im extrahierten SDK die Pakete
FirebaseAIundFirebaseAppCheckaus.Klicken Sie im Fenster Import Unity Package (Unity-Paket importieren) auf Import (Importieren).
Schritt 3: App Check-Debug-Anbieter für die lokale Entwicklung konfigurieren
Ab Anfang Juli 2026 wird während des geführten Einrichtungsvorgangs in der Firebase-Konsole automatisch Firebase App Check für Firebase AI Logic erzwungen, um die Gemini API zu schützen.
Für die lokale Entwicklung können Sie den App Check-Debug-Anbieter einrichten und App Check für Firebase AI Logic weiterhin erzwingen.
Swift
So verwenden Sie den Debug-Anbieter, wenn Sie Ihre App interaktiv in einem Simulator ausführen (z. B. während der lokalen Entwicklung):
Importieren Sie in Ihrem Xcode-Projekt
FirebaseAppCheckund initialisieren Sie App Check mit der Debug-Anbieter-Factory bevor SieFirebasekonfigurieren.import SwiftUI import FirebaseCore import FirebaseAppCheck @main struct YourApp: App { init() { let providerFactory = AppCheckDebugProviderFactory() AppCheck.setAppCheckProviderFactory(providerFactory) FirebaseApp.configure() } var body: some Scene { WindowGroup { NavigationView { ContentView() } } } }Fehlerbehebungstoken abrufen:
Starten Sie die App im Simulator oder auf dem Testgerät.
Öffnen Sie die Xcode-Konsole und suchen Sie nach dem App Check-Debug-Token. Beispiel:
<Warning> [AppCheckCore][I-GAC004001] App Check debug token: '123a4567-b89c-12d3-e456-789012345678'.Kopieren Sie das Token (z. B.
123a4567-b89c-12d3-e456-789012345678).
Registrieren Sie Ihr Debug-Token bei App Check:
Weitere Informationen zum Debug-Anbieter (einschließlich des Abrufs eines neuen Debug-Tokens) finden Sie in der offiziellen App Check-Dokumentation.
Kotlin
So verwenden Sie den Debugging-Anbieter, während Sie Ihre App interaktiv in einem Emulator ausführen (z. B. während der lokalen Entwicklung):
Konfigurieren Sie in Ihrem Debug-Build App Check für die Verwendung der Debug-Anbieter-Factory:
Firebase.initialize(context = this) Firebase.appCheck.installAppCheckProviderFactory( DebugAppCheckProviderFactory.getInstance(), )
Fehlerbehebungstoken abrufen:
Führen Sie die App im Emulator oder auf Ihrem Testgerät aus.
Suchen Sie in Ihren Logs nach dem Debug-Token App Check. Beispiel:
D DebugAppCheckProvider: Enter this debug secret into the allow list in the Firebase Console for your project: 123a4567-b89c-12d3-e456-789012345678Kopieren Sie das Token (z. B.
123a4567-b89c-12d3-e456-789012345678).
Registrieren Sie Ihr Debug-Token bei App Check:
Rufen Sie in der Firebase-Konsole den Tab Sicherheit > App Check > Apps auf.
Suchen Sie Ihre App, klicken Sie auf das Dreipunkt-Menü und wählen Sie Debug-Tokens verwalten aus.
Folgen Sie der Anleitung auf dem Bildschirm, um Ihr Debug-Token zu registrieren.
Weitere Informationen zum Debugging-Anbieter (einschließlich des Abrufens eines neuen Debugging-Tokens) finden Sie in der offiziellen App Check-Dokumentation.
Java
So verwenden Sie den Debug-Anbieter, wenn Sie Ihre App interaktiv in einem Emulator ausführen (z. B. während der lokalen Entwicklung):
Konfigurieren Sie in Ihrem Debug-Build App Check für die Verwendung der Debug-Anbieter-Factory:
FirebaseApp.initializeApp(/*context=*/ this); FirebaseAppCheck firebaseAppCheck = FirebaseAppCheck.getInstance(); firebaseAppCheck.installAppCheckProviderFactory( DebugAppCheckProviderFactory.getInstance());
Fehlerbehebungstoken abrufen:
Führen Sie die App im Emulator oder auf Ihrem Testgerät aus.
Suchen Sie in Ihren Logs nach dem Debug-Token App Check. Beispiel:
D DebugAppCheckProvider: Enter this debug secret into the allow list in the Firebase Console for your project: 123a4567-b89c-12d3-e456-789012345678Kopieren Sie das Token (z. B.
123a4567-b89c-12d3-e456-789012345678).
Registrieren Sie Ihr Debug-Token bei App Check:
Weitere Informationen zum Debug-Anbieter (einschließlich des Abrufs eines neuen Debug-Tokens) finden Sie in der offiziellen App Check-Dokumentation.
Web
So verwenden Sie den Debug-Anbieter, wenn Sie Ihre App interaktiv über localhost ausführen (z. B. während der lokalen Entwicklung):
Aktivieren Sie in Ihrem Debug-Build den Fehlerbehebungsmodus, indem Sie
self.FIREBASE_APPCHECK_DEBUG_TOKENauftruesetzen, bevor Sie App Check initialisieren. Beispiel:self.FIREBASE_APPCHECK_DEBUG_TOKEN = true; initializeAppCheck(app, { /* App Check options */ });Rufen Sie Ihre Web-App lokal auf und öffnen Sie die Entwicklertools des Browsers. In der Debugging-Konsole wird ein Debugging-Token angezeigt:
AppCheck debug token: "123a4567-b89c-12d3-e456-789012345678". You will need to safelist it in the Firebase console for it to work.Registrieren Sie Ihr Fehlerbehebungstoken bei App Check:
Rufen Sie in der Firebase-Konsole den Tab Sicherheit > App Check > Apps auf.
Suchen Sie Ihre App, klicken Sie auf das Dreipunkt-Menü () und wählen Sie Debug-Tokens verwalten aus.
Folgen Sie der Anleitung auf dem Bildschirm, um Ihr Debug-Token zu registrieren.
Weitere Informationen zum Debug-Anbieter (einschließlich des Abrufs eines neuen Debug-Tokens) finden Sie in der offiziellen App Check-Dokumentation.
Dart
iOS+
So verwenden Sie den Debug-Anbieter, während Sie Ihre App interaktiv in einem Simulator ausführen (z. B. während der lokalen Entwicklung):
Aktivieren Sie App Check mit dem Debug-Anbieter direkt nach der Initialisierung Ihrer Firebase-App:
import 'package:flutter/material.dart'; import 'package:firebase_core/firebase_core.dart'; // Import the firebase_app_check plugin import 'package:firebase_app_check/firebase_app_check.dart'; Future<void> main() async { WidgetsFlutterBinding.ensureInitialized(); await Firebase.initializeApp(); await FirebaseAppCheck.instance.activate( // Set appleProvider to `AppleProvider.debug` appleProvider: AppleProvider.debug, ); runApp(App()); }Aktivieren Sie das Debug-Logging in Ihrem Xcode-Projekt:
- Öffnen Sie Product > Scheme > Edit scheme (Produkt > Schema > Schema bearbeiten).
- Wählen Sie im Menü auf der linken Seite Ausführen und dann den Tab Argumente aus.
- Fügen Sie im Bereich Beim Start übergebene Argumente
-FIRDebugEnabledhinzu.
Rufen Sie Ihr Debug-Token ab:
Öffnen Sie
ios/Runner.xcworkspacemit Xcode und führen Sie Ihre App im Simulator oder auf Ihrem Testgerät aus.Öffnen Sie die Xcode-Konsole und suchen Sie nach dem App Check-Debug-Token. Beispiel:
<Warning> [AppCheckCore][I-GAC004001] App Check debug token: '123a4567-b89c-12d3-e456-789012345678'.Kopieren Sie das Token (z. B.
123a4567-b89c-12d3-e456-789012345678).
Registrieren Sie Ihr Debug-Token bei App Check:
Android
So verwenden Sie den Debug-Anbieter, wenn Sie Ihre App interaktiv in einem Emulator ausführen (z. B. während der lokalen Entwicklung):
Aktivieren Sie App Check mit dem Debug-Anbieter direkt nach der Initialisierung Ihrer Firebase-App:
import 'package:flutter/material.dart'; import 'package:firebase_core/firebase_core.dart'; // Import the firebase_app_check plugin import 'package:firebase_app_check/firebase_app_check.dart'; Future<void> main() async { WidgetsFlutterBinding.ensureInitialized(); await Firebase.initializeApp(); await FirebaseAppCheck.instance.activate( // Set androidProvider to `AndroidProvider.debug` androidProvider: AndroidProvider.debug, ); runApp(App()); }Rufen Sie Ihr Debug-Token ab:
Führen Sie die App im Emulator oder auf Ihrem Testgerät aus.
Suchen Sie in Ihren Logs nach dem Debug-Token App Check. Beispiel:
D DebugAppCheckProvider: Enter this debug secret into the allow list in the Firebase Console for your project: 123a4567-b89c-12d3-e456-789012345678Kopieren Sie das Token (z. B.
123a4567-b89c-12d3-e456-789012345678).
Registrieren Sie Ihr Debug-Token bei App Check:
Web
So verwenden Sie den Debug-Anbieter, wenn Sie Ihre App interaktiv über localhost ausführen (z. B. bei der lokalen Entwicklung):
Aktivieren Sie in der Datei
web/index.htmlden Debug-Modus, indem Sieself.FIREBASE_APPCHECK_DEBUG_TOKENauftruesetzen:<body> <script> self.FIREBASE_APPCHECK_DEBUG_TOKEN = true; </script> ... </body>Führen Sie Ihre Web-App lokal aus und öffnen Sie die Entwicklertools des Browsers. In der Debug-Konsole wird ein Debug-Token angezeigt:
AppCheck debug token: "123a4567-b89c-12d3-e456-789012345678". You will need to safelist it in the Firebase console for it to work.Dieses Token wird lokal in Ihrem Browser gespeichert und immer dann verwendet, wenn Sie Ihre Anwendung im selben Browser auf demselben Computer verwenden. Wenn Sie das Token in einem anderen Browser oder auf einem anderen Computer verwenden möchten, legen Sie für
self.FIREBASE_APPCHECK_DEBUG_TOKENden Tokenstring anstelle vontruefest.Registrieren Sie Ihr Fehlerbehebungstoken bei App Check:
Weitere Informationen zum Debugging-Anbieter (einschließlich des Abrufens eines neuen Debugging-Tokens) finden Sie in der offiziellen App Check-Dokumentation.
Einheit
So verwenden Sie den Debug-Anbieter, wenn Sie Ihre App interaktiv in einem Emulator ausführen (z. B. während der lokalen Entwicklung):
Erstellen Sie in der Firebase Console ein Debug-Token:
Rufen Sie in der Firebase-Konsole den Tab Sicherheit > App Check > Apps auf.
Suchen Sie Ihre App, klicken Sie auf das Dreipunkt-Menü () und wählen Sie Debug-Tokens verwalten aus.
Folgen Sie der Anleitung auf dem Bildschirm, um ein neues Debug-Token zu erstellen.
Fügen Sie dem Initialisierungscode Ihrer App Folgendes hinzu:
using Firebase.AppCheck; void InitializeFirebase() { // Configure the Debug Provider factory with your debug token. DebugAppCheckProviderFactory.Instance.SetDebugToken("YOUR_DEBUG_TOKEN"); // Set App Check to use the debug provider factory FirebaseAppCheck.SetAppCheckProviderFactory( DebugAppCheckProviderFactory.Instance); // Proceed to initialize Firebase as normal }
Weitere Informationen zum Debug-Anbieter (einschließlich des Abrufs eines neuen Debug-Tokens) finden Sie in der offiziellen App Check-Dokumentation.
Schritt 4: Dienst initialisieren und Modellinstanz erstellen
|
Klicken Sie auf Ihren Gemini API-Anbieter, um anbieterspezifische Inhalte und Code auf dieser Seite aufzurufen. |
Bevor Sie einen Prompt an ein Gemini-Modell senden, initialisieren Sie den Dienst für den ausgewählten API-Anbieter und erstellen Sie eine GenerativeModel-Instanz.
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.8-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.8-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.8-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.8-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.8-flash');
Einheit
using Firebase;
using Firebase.AI;
// Initialize the Gemini Developer API backend service.
var ai = FirebaseAI.GetInstance(FirebaseAI.Backend.GoogleAI());
// Create a `GenerativeModel` instance with a model that supports your use case.
var model = ai.GetGenerativeModel(modelName: "gemini-3.8-flash");
Je nach verwendeter Funktion wird möglicherweise nicht immer eine GenerativeModel-Instanz erstellt. Wenn Sie Ein- und Ausgabe mit Gemini Live API streamen möchten, erstellen Sie eine LiveModel-Instanz.
Nachdem Sie diese Kurzanleitung durchgearbeitet haben, können Sie sich auch ansehen, wie Sie ein Modell für Ihren Anwendungsfall und Ihre App auswählen.
Schritt 5: Anfrage an ein Modell senden
Sie können jetzt eine Anfrage an ein Gemini-Modell senden.
Sie können generateContent() verwenden, um Text aus einem Prompt zu generieren, der Text enthält:
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.8-flash")
// Provide a prompt that contains text
let prompt = "Write a story about a magic backpack."
// To generate text output, call generateContent with the text input
let response = try await model.generateContent(prompt)
print(response.text ?? "No text in response.")
Kotlin
In Kotlin sind die Methoden in diesem SDK Suspend-Funktionen und müssen aus einem Koroutinenbereich aufgerufen werden.
// 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.8-flash")
// Provide a prompt that contains text
val prompt = "Write a story about a magic backpack."
// To generate text output, call generateContent with the text input
val response = model.generateContent(prompt)
print(response.text)
Java
Bei Java geben die Methoden in diesem SDK einListenableFuture zurück.
// 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.8-flash");
// Use the GenerativeModelFutures Java compatibility layer which offers
// support for ListenableFuture and Publisher APIs
GenerativeModelFutures model = GenerativeModelFutures.from(ai);
// Provide a prompt that contains text
Content prompt = new Content.Builder()
.addText("Write a story about a magic backpack.")
.build();
// To generate text output, call generateContent with the text input
ListenableFuture<GenerateContentResponse> response = model.generateContent(prompt);
Futures.addCallback(response, new FutureCallback<GenerateContentResponse>() {
@Override
public void onSuccess(GenerateContentResponse result) {
String resultText = result.getText();
System.out.println(resultText);
}
@Override
public void onFailure(Throwable t) {
t.printStackTrace();
}
}, executor);
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.8-flash" });
// Wrap in an async function so you can use await
async function run() {
// Provide a prompt that contains text
const prompt = "Write a story about a magic backpack."
// To generate text output, call generateContent with the text input
const result = await model.generateContent(prompt);
const response = result.response;
const text = response.text();
console.log(text);
}
run();
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.8-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);
Einheit
using Firebase;
using Firebase.AI;
// Initialize the Gemini Developer API backend service.
var ai = FirebaseAI.GetInstance(FirebaseAI.Backend.GoogleAI());
// Create a `GenerativeModel` instance with a model that supports your use case.
var model = ai.GetGenerativeModel(modelName: "gemini-3.8-flash");
// Provide a prompt that contains text
var prompt = "Write a story about a magic backpack.";
// To generate text output, call GenerateContentAsync with the text input
var response = await model.GenerateContentAsync(prompt);
UnityEngine.Debug.Log(response.Text ?? "No text in response.");
Was kannst du sonst noch alles für mich tun?
Weitere Informationen zu den unterstützten Modellen
Informationen zu den für verschiedene Anwendungsfälle verfügbaren Modellen und den zugehörigen Kontingenten und Preisen.
Andere Funktionen ausprobieren
- Weitere Informationen zum Generieren von Text aus reinen Text-Prompts, einschließlich des Streamings der Antwort.
- Sie können Text generieren lassen, indem Sie Prompts mit verschiedenen Dateitypen wie Bildern, PDFs, Videos und Audiodateien erstellen.
- Mehrfachdialoge (Chat) erstellen
- Strukturierte Ausgaben (z. B. JSON) generieren – sowohl aus Text- als auch aus multimodalen Prompts.
- Bilder aus Text- und multimodalen Prompts generieren und bearbeiten
- Eingabe und Ausgabe streamen (einschließlich Audio) mit Gemini Live API.
-
Verwenden Sie Tools wie Funktionsaufrufe und Fundierung mit
Google Search oderGoogle Maps , um ein Gemini-Modell mit anderen Teilen Ihrer Anwendung sowie mit externen Systemen und Informationen zu verbinden.
Informationen zum Steuern der Inhaltserstellung
- Informationen zum Prompt-Design, einschließlich Best Practices, Strategien und Beispiel-Prompts.
- Modellparameter konfigurieren, z. B. maximale Anzahl von Ausgabetokens oder Wahrscheinlichkeit von wiederholten Ausgabetokens.
- Verwenden Sie Sicherheitseinstellungen, um die Wahrscheinlichkeit anzupassen, dass Sie Antworten erhalten, die als schädlich eingestuft werden könnten.
Feedback zu Ihrer Erfahrung mit Firebase AI Logic geben