Ce guide vous explique comment commencer à appeler l'Gemini API directement depuis votre application à l'aide des SDK client Firebase AI Logic pour la plate-forme de votre choix.
Prérequis
Swift
Ce guide part du principe que vous savez utiliser Xcode pour développer des applications pour les plates-formes Apple (comme iOS).
Assurez-vous que votre environnement de développement et votre application pour les plates-formes Apple répondent aux exigences suivantes :
- Xcode 26.2 ou version ultérieure
- Votre application cible iOS 15 ou version ultérieure, ou macOS 12 ou version ultérieure
Kotlin
Ce guide suppose que vous savez utiliser Android Studio pour développer des applications pour Android.
Assurez-vous que votre environnement de développement et votre application Android répondent aux exigences suivantes :
- Android Studio (dernière version)
- Votre application cible le niveau d'API 21 ou supérieur.
Java
Ce guide suppose que vous savez utiliser Android Studio pour développer des applications pour Android.
Assurez-vous que votre environnement de développement et votre application Android répondent aux exigences suivantes :
- Android Studio (dernière version)
- Votre application cible le niveau d'API 21 ou supérieur.
Web
Ce guide part du principe que vous savez utiliser JavaScript pour développer des applications Web. Ce guide est indépendant du framework.
Assurez-vous que votre environnement de développement et votre application Web répondent aux exigences suivantes :
- (Facultatif) : Node.js
- Navigateur Web moderne
Dart
Dans ce guide, nous partons du principe que vous savez développer des applications avec Flutter.
Assurez-vous que votre environnement de développement et votre application Flutter répondent aux exigences suivantes :
- Dart 3.2.0+
Unity
Ce guide part du principe que vous savez développer des jeux avec Unity.
Assurez-vous que votre environnement de développement et votre jeu Unity répondent aux exigences suivantes :
- Unity Editor 2021 LTS ou version ultérieure
Consulter des ressources utiles
Swift
Essayer l'application de démarrage rapide
Utilisez l'application de démarrage rapide pour tester rapidement le SDK et voir une implémentation complète de divers cas d'utilisation. Vous pouvez également utiliser l'application de démarrage rapide si vous ne possédez pas votre propre application pour les plates-formes Apple. Pour utiliser l'application de démarrage rapide, vous devez l'associer à un projet Firebase.
Accéder à l'application de démarrage rapide
Regarder·un tutoriel vidéo
Cette vidéo montre comment commencer à utiliser Firebase AI Logic en créant une application de planification de repas optimisée par l'IA qui génère des recettes à partir d'un prompt textuel.
Vous pouvez également télécharger et explorer la base de code de l'application présentée dans la vidéo.
Afficher le codebase de l'application de la vidéo
Kotlin
Essayer l'application de démarrage rapide
Utilisez l'application de démarrage rapide pour tester rapidement le SDK et voir une implémentation complète de divers cas d'utilisation. Vous pouvez également utiliser l'application de démarrage rapide si vous n'avez pas votre propre application Android. Pour utiliser l'application de démarrage rapide, vous devez l'associer à un projet Firebase.
Accéder à l'application de démarrage rapide
Regarder·un tutoriel vidéo
Cette vidéo montre comment commencer à utiliser Firebase AI Logic en créant une application de planification de repas optimisée par l'IA qui génère des recettes à partir d'un prompt textuel.
Vous pouvez également télécharger et explorer la base de code de l'application présentée dans la vidéo.
Afficher le codebase de l'application de la vidéo
Java
Essayer l'application de démarrage rapide
Utilisez l'application de démarrage rapide pour tester rapidement le SDK et voir une implémentation complète de divers cas d'utilisation. Vous pouvez également utiliser l'application de démarrage rapide si vous n'avez pas votre propre application Android. Pour utiliser l'application de démarrage rapide, vous devez l'associer à un projet Firebase.
Accéder à l'application de démarrage rapide
Regarder·un tutoriel vidéo
Cette vidéo montre comment commencer à utiliser Firebase AI Logic en créant une application de planification de repas optimisée par l'IA qui génère des recettes à partir d'un prompt textuel.*
Vous pouvez également télécharger et explorer la base de code de l'application présentée dans la vidéo.
Afficher le codebase de l'application de la vidéo
* Cette vidéo et son application sont en Kotlin, mais elles peuvent tout de même aider les développeurs Java à comprendre les bases pour commencer à utiliser Firebase AI Logic.
Web
Essayer l'application de démarrage rapide
Utilisez l'application de démarrage rapide pour tester rapidement le SDK et voir une implémentation complète de divers cas d'utilisation. Vous pouvez également utiliser l'application de démarrage rapide si vous n'avez pas votre propre application Web. Pour utiliser l'application de démarrage rapide, vous devez l'associer à un projet Firebase.
Dart
Essayer l'application de démarrage rapide
Utilisez l'application de démarrage rapide pour tester rapidement le SDK et voir une implémentation complète de divers cas d'utilisation. Vous pouvez également utiliser l'application de démarrage rapide si vous ne possédez pas votre propre application Flutter. Pour utiliser l'application de démarrage rapide, vous devez l'associer à un projet Firebase.
Accéder à l'application de démarrage rapide
Regarder·un tutoriel vidéo
Cette vidéo montre comment commencer à utiliser Firebase AI Logic en créant une application de planification de repas optimisée par l'IA qui génère des recettes à partir d'un prompt textuel.
Vous pouvez également télécharger et explorer la base de code de l'application présentée dans la vidéo.
Afficher le codebase de l'application de la vidéo
Unity
Essayer l'application de démarrage rapide
Utilisez l'application de démarrage rapide pour tester rapidement le SDK et voir une implémentation complète de divers cas d'utilisation. Vous pouvez également utiliser l'application de démarrage rapide si vous n'avez pas votre propre jeu Unity. Pour utiliser l'application de démarrage rapide, vous devez l'associer à un projet Firebase.
Étape 1 : Configurez un projet Firebase et activez les API
Connectez-vous à la console Firebase, puis sélectionnez votre projet Firebase.
Dans la console Firebase, accédez à Services d'IA > Logique d'IA.
Cliquez sur Premiers pas pour lancer un workflow guidé qui vous aide à configurer les API requises et les ressources pour votre projet.
Si vous y êtes invité, suivez les instructions à l'écran pour enregistrer votre application et ajouter votre configuration Firebase à votre application.
Lorsque vous êtes invité à choisir un "fournisseur d'API Gemini", nous vous recommandons de sélectionner l'API Gemini Developer, qui vous permet de commencer rapidement et sans frais.
Vous pourrez toujours configurer Vertex AI Gemini API (et ses exigences de facturation) à tout moment.
Poursuivez le workflow pour configurer les API requises et les services associés pour Firebase AI Logic.
À partir de début juillet 2026, cette étape du workflow appliquera automatiquement Firebase App Check pour AI Logic, qui est un service critique pour protéger Gemini API lorsqu'il est directement accessible depuis votre application. Pour commencer (voir les étapes plus loin dans ce guide), vous devrez configurer le fournisseur de débogage App Check pour le développement local lorsque App Check est appliqué.
Passez à l'étape suivante de ce guide pour ajouter les SDK requis à votre application.
Étape 2 : Ajouter les SDK nécessaires
Maintenant que votre projet Firebase est configuré et que les API requises sont activées (voir l'étape précédente), vous pouvez ajouter les SDK requis à votre application.
Swift
Utilisez Swift Package Manager pour installer et gérer les dépendances Firebase. Si nécessaire, découvrez les autres options d'installation.
La bibliothèque Firebase AI Logic permet d'accéder aux API pour interagir avec les modèles Gemini. La bibliothèque est incluse dans le SDK Firebase pour les plates-formes Apple (firebase-ios-sdk).
Si vous utilisez déjà Firebase, assurez-vous que votre package Firebase est la version 12.5.0 ou ultérieure.
Dans Xcode, à partir de votre projet d'application ouvert, accédez à File > Add Package Dependencies (Fichier > Ajouter des dépendances de package).
Lorsque vous y êtes invité, ajoutez le dépôt du SDK des plates-formes Firebase pour Apple :
https://github.com/firebase/firebase-ios-sdkSélectionnez la dernière version du SDK.
Sélectionnez les bibliothèques
FirebaseAILogicetFirebaseAppCheck.
Lorsque vous avez terminé, Xcode commence à résoudre et à télécharger automatiquement vos dépendances en arrière-plan.
Kotlin
Le SDK Firebase AI Logic pour Android (firebase-ai) permet d'accéder aux API pour interagir avec les modèles Gemini.
Dans le fichier Gradle de votre module (au niveau de l'application) (comme <project>/<app-module>/build.gradle.kts), ajoutez la dépendance pour la bibliothèque Firebase AI Logic pour Android.
Nous vous recommandons d'utiliser Firebase Android BoM pour contrôler la gestion des versions de la bibliothèque.
dependencies { // ... other androidx dependencies // Import the BoM for the Firebase platform implementation(platform("com.google.firebase:firebase-bom:34.15.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") }
En utilisant la Firebase Android BoM, votre application utilisera toujours des versions compatibles des bibliothèques Firebase Android.
Java
Le SDK Firebase AI Logic pour Android (firebase-ai) permet d'accéder aux API pour interagir avec les modèles Gemini.
Dans le fichier Gradle de votre module (au niveau de l'application) (comme <project>/<app-module>/build.gradle.kts), ajoutez la dépendance pour la bibliothèque Firebase AI Logic pour Android.
Nous vous recommandons d'utiliser Firebase Android BoM pour contrôler la gestion des versions de la bibliothèque.
Pour Java, vous devez ajouter deux bibliothèques supplémentaires.
dependencies { // ... other androidx dependencies // Import the BoM for the Firebase platform implementation(platform("com.google.firebase:firebase-bom:34.15.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") }
En utilisant la Firebase Android BoM, votre application utilisera toujours des versions compatibles des bibliothèques Firebase Android.
Web
La bibliothèque Firebase AI Logic permet d'accéder aux API pour interagir avec les modèles Gemini. La bibliothèque est incluse dans le SDK JavaScript Firebase pour le Web.
Installez le SDK JS Firebase pour le Web à l'aide de npm :
npm install firebaseInitialisez Firebase dans votre application :
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
Le plug-in Firebase AI Logic pour Flutter (firebase_ai) permet d'accéder aux API pour interagir avec les modèles Gemini.
Depuis le répertoire de votre projet Flutter, exécutez la commande suivante pour installer le plug-in principal et le plug-in Firebase AI Logic :
flutter pub add firebase_ai firebase_app_checkDans votre fichier
lib/main.dart, importez les plug-ins Firebase AI Logic et 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';Toujours dans votre fichier
lib/main.dart, assurez-vous d'avoir initialisé Firebase à l'aide de l'objetDefaultFirebaseOptionsexporté par le fichier de configuration :await Firebase.initializeApp( options: DefaultFirebaseOptions.currentPlatform, );Recompilez votre application Flutter :
flutter run
Unity
Téléchargez le SDK Firebase Unity, puis extrayez-le dans un emplacement pratique.
Le SDK Firebase Unity n'est pas spécifique à une plate-forme.
Dans votre projet Unity ouvert, accédez à Assets > Import Package > Custom Package (Éléments > Importer un package > Package personnalisé).
Dans le SDK extrait, sélectionnez le package
FirebaseAIet le packageFirebaseAppCheck.Dans la fenêtre Import Unity Package (Importer un package Unity) qui s'ouvre, cliquez sur Import (Importer).
Étape 3 : Configurer le fournisseur de débogage App Check pour le développement local
Début juillet 2026, dans le cadre du workflow de configuration guidée pour AI Logic dans la console, Firebase App Check sera automatiquement appliqué pour protéger le Gemini API. Pour le développement local, vous devez configurer le fournisseur de débogage App Check afin de contourner l'attestation tout en maintenant l'application de App Check.
Swift
Voici comment utiliser le fournisseur de débogage lors de l'exécution interactive de votre application dans un simulateur (par exemple, lors du développement local) :
Dans votre projet Xcode, importez
FirebaseAppChecket initialisez App Check avec la fabrique de fournisseurs de débogage avant de configurerFirebase.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() } } } }Obtenez votre jeton de débogage :
Lancez votre application dans le simulateur ou sur votre appareil de test.
Ouvrez la console Xcode et recherchez le jeton de débogage App Check. Exemple :
<Warning> [AppCheckCore][I-GAC004001] App Check debug token: '123a4567-b89c-12d3-e456-789012345678'.Copiez le jeton (par exemple,
123a4567-b89c-12d3-e456-789012345678).
Enregistrez votre jeton de débogage auprès de App Check :
Dans la consoleFirebase, accédez à l'onglet Applications : Sécurité > App Check.
Recherchez votre application, cliquez sur le menu à développer (), puis sélectionnez Gérer les jetons de débogage.
Suivez les instructions à l'écran pour enregistrer votre jeton de débogage.
Pour en savoir plus sur le fournisseur de débogage (y compris sur la façon d'obtenir un nouveau jeton de débogage), consultez la documentation officielle App Check.
Kotlin
Voici comment utiliser le fournisseur de débogage lorsque vous exécutez votre application de manière interactive dans un émulateur (par exemple, lors du développement local) :
Dans votre build de débogage, configurez App Check pour utiliser la fabrique de fournisseurs de débogage :
Firebase.initialize(context = this) Firebase.appCheck.installAppCheckProviderFactory( DebugAppCheckProviderFactory.getInstance(), )
Obtenez votre jeton de débogage :
Exécutez votre application dans l'émulateur ou sur votre appareil de test.
Recherchez le jeton de débogage App Check dans vos journaux. Exemple :
D DebugAppCheckProvider: Enter this debug secret into the allow list in the Firebase Console for your project: 123a4567-b89c-12d3-e456-789012345678Copiez le jeton (par exemple,
123a4567-b89c-12d3-e456-789012345678).
Enregistrez votre jeton de débogage auprès de App Check :
Dans la consoleFirebase, accédez à l'onglet Applications : Sécurité > App Check.
Recherchez votre application, cliquez sur le menu à développer (), puis sélectionnez Gérer les jetons de débogage.
Suivez les instructions à l'écran pour enregistrer votre jeton de débogage.
Pour en savoir plus sur le fournisseur de débogage (y compris sur la façon d'obtenir un nouveau jeton de débogage), consultez la documentation officielle App Check.
Java
Voici comment utiliser le fournisseur de débogage lorsque vous exécutez votre application de manière interactive dans un émulateur (par exemple, lors du développement local) :
Dans votre build de débogage, configurez App Check pour utiliser la fabrique de fournisseurs de débogage :
FirebaseApp.initializeApp(/*context=*/ this); FirebaseAppCheck firebaseAppCheck = FirebaseAppCheck.getInstance(); firebaseAppCheck.installAppCheckProviderFactory( DebugAppCheckProviderFactory.getInstance());
Obtenez votre jeton de débogage :
Exécutez votre application dans l'émulateur ou sur votre appareil de test.
Recherchez le jeton de débogage App Check dans vos journaux. Exemple :
D DebugAppCheckProvider: Enter this debug secret into the allow list in the Firebase Console for your project: 123a4567-b89c-12d3-e456-789012345678Copiez le jeton (par exemple,
123a4567-b89c-12d3-e456-789012345678).
Enregistrez votre jeton de débogage auprès de App Check :
Dans la consoleFirebase, accédez à l'onglet Applications : Sécurité > App Check.
Recherchez votre application, cliquez sur le menu à développer (), puis sélectionnez Gérer les jetons de débogage.
Suivez les instructions à l'écran pour enregistrer votre jeton de débogage.
Pour en savoir plus sur le fournisseur de débogage (y compris sur la façon d'obtenir un nouveau jeton de débogage), consultez la documentation officielle App Check.
Web
Voici comment utiliser le fournisseur de débogage lors de l'exécution interactive de votre application à partir de localhost (par exemple, lors du développement local) :
Dans votre build de débogage, activez le mode débogage en définissant
self.FIREBASE_APPCHECK_DEBUG_TOKENsurtrueavant d'initialiser App Check. Exemple :self.FIREBASE_APPCHECK_DEBUG_TOKEN = true; initializeAppCheck(app, { /* App Check options */ });Accédez à votre application Web en local et ouvrez l'outil pour les développeurs du navigateur. Dans la console de débogage, un jeton de débogage s'affiche :
AppCheck debug token: "123a4567-b89c-12d3-e456-789012345678". You will need to safelist it in the Firebase console for it to work.Enregistrez votre jeton de débogage auprès de App Check :
Dans la consoleFirebase, accédez à l'onglet Applications : Sécurité > App Check.
Recherchez votre application, cliquez sur le menu à développer (), puis sélectionnez Gérer les jetons de débogage.
Suivez les instructions à l'écran pour enregistrer votre jeton de débogage.
Pour en savoir plus sur le fournisseur de débogage (y compris sur la façon d'obtenir un nouveau jeton de débogage), consultez la documentation officielle App Check.
Dart
iOS+
Voici comment utiliser le fournisseur de débogage lors de l'exécution interactive de votre application dans un simulateur (par exemple, lors du développement local) :
Activez App Check avec le fournisseur de débogage juste après avoir initialisé votre application Firebase :
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()); }Activez la journalisation des données de débogage dans votre projet Xcode :
- Ouvrez Product > Scheme > Edit scheme (Produit > Schéma > Modifier le schéma).
- Sélectionnez Run (Exécuter) dans le menu de gauche, puis l'onglet Arguments.
- Dans la section Arguments Passed on Launch (Arguments transmis au lancement), ajoutez
-FIRDebugEnabled.
Obtenez votre jeton de débogage :
Ouvrez
ios/Runner.xcworkspaceavec Xcode et exécutez votre application dans le simulateur ou sur votre appareil de test.Ouvrez la console Xcode et recherchez le jeton de débogage App Check. Exemple :
<Warning> [AppCheckCore][I-GAC004001] App Check debug token: '123a4567-b89c-12d3-e456-789012345678'.Copiez le jeton (par exemple,
123a4567-b89c-12d3-e456-789012345678).
Enregistrez votre jeton de débogage auprès de App Check :
Dans la consoleFirebase, accédez à l'onglet Applications : Sécurité > App Check.
Recherchez votre application, cliquez sur le menu à développer (), puis sélectionnez Gérer les jetons de débogage.
Suivez les instructions à l'écran pour enregistrer votre jeton de débogage.
Android
Voici comment utiliser le fournisseur de débogage lorsque vous exécutez votre application de manière interactive dans un émulateur (par exemple, lors du développement local) :
Activez App Check avec le fournisseur de débogage juste après avoir initialisé votre application Firebase :
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()); }Obtenez votre jeton de débogage :
Exécutez votre application dans l'émulateur ou sur votre appareil de test.
Recherchez le jeton de débogage App Check dans vos journaux. Exemple :
D DebugAppCheckProvider: Enter this debug secret into the allow list in the Firebase Console for your project: 123a4567-b89c-12d3-e456-789012345678Copiez le jeton (par exemple,
123a4567-b89c-12d3-e456-789012345678).
Enregistrez votre jeton de débogage auprès de App Check :
Dans la consoleFirebase, accédez à l'onglet Applications : Sécurité > App Check.
Recherchez votre application, cliquez sur le menu à développer (), puis sélectionnez Gérer les jetons de débogage.
Suivez les instructions à l'écran pour enregistrer votre jeton de débogage.
Web
Voici comment utiliser le fournisseur de débogage lors de l'exécution de votre application à partir de localhost de manière interactive (par exemple, lors du développement local) :
Dans le fichier
web/index.html, activez le mode de débogage en définissantself.FIREBASE_APPCHECK_DEBUG_TOKENsurtrue:<body> <script> self.FIREBASE_APPCHECK_DEBUG_TOKEN = true; </script> ... </body>Exécutez votre application Web localement et ouvrez l'outil pour les développeurs du navigateur. Dans la console de débogage, un jeton de débogage s'affiche :
AppCheck debug token: "123a4567-b89c-12d3-e456-789012345678". You will need to safelist it in the Firebase console for it to work.Ce jeton est stocké localement dans votre navigateur et sera utilisé chaque fois que vous utiliserez votre application dans le même navigateur sur la même machine. Si vous souhaitez utiliser le jeton dans un autre navigateur ou sur une autre machine, définissez
self.FIREBASE_APPCHECK_DEBUG_TOKENsur la chaîne de jeton au lieu detrue.Enregistrez votre jeton de débogage auprès de App Check :
Dans la consoleFirebase, accédez à l'onglet Applications : Sécurité > App Check.
Recherchez votre application, cliquez sur le menu à développer (), puis sélectionnez Gérer les jetons de débogage.
Suivez les instructions à l'écran pour enregistrer votre jeton de débogage.
Pour en savoir plus sur le fournisseur de débogage (y compris sur la façon d'obtenir un nouveau jeton de débogage), consultez la documentation officielle App Check.
Unity
Voici comment utiliser le fournisseur de débogage lorsque vous exécutez votre application de manière interactive dans un émulateur (par exemple, lors du développement local) :
Dans la console Firebase, créez un jeton de débogage :
Dans la consoleFirebase, accédez à Sécurité > App Check > onglet Applications.
Recherchez votre application, cliquez sur le menu à développer (), puis sélectionnez Gérer les jetons de débogage.
Suivez les instructions à l'écran pour créer un jeton de débogage.
Dans le code d'initialisation de votre application, ajoutez ce qui suit :
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 }
Pour en savoir plus sur le fournisseur de débogage (y compris sur la façon d'obtenir un nouveau jeton de débogage), consultez la documentation officielle App Check.
Étape 4 : Initialisez le service et créez une instance de modèle
|
Cliquez sur votre fournisseur Gemini API pour afficher le contenu et le code spécifiques à ce fournisseur sur cette page. |
Avant d'envoyer une requête à un modèle Gemini, initialisez le service pour le fournisseur d'API de votre choix et créez une instance 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
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.5-flash");
Notez que selon la fonctionnalité que vous utilisez, vous ne créerez pas toujours une instance GenerativeModel. Pour diffuser des entrées et des sorties à l'aide de Gemini Live API, créez une instance LiveModel.
De plus, une fois ce guide de démarrage terminé, découvrez comment choisir un modèle pour votre cas d'utilisation et votre application.
Étape 5 : Envoyer une requête à un modèle
Vous êtes maintenant prêt à envoyer une requête à un modèle Gemini.
Vous pouvez utiliser generateContent() pour générer du texte à partir d'une requête textuelle :
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")
// 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
Pour Kotlin, les méthodes de ce SDK sont des fonctions de suspension et doivent être appelées à partir d'un champ d'application de coroutine.
// 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")
// 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
Pour Java, les méthodes de ce SDK renvoient unListenableFuture.
// 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);
// 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.5-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.5-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);
Unity
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.5-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.");
Qu'est-ce que tu sais faire d'autre ?
En savoir plus sur les modèles compatibles
Découvrez les modèles disponibles pour différents cas d'utilisation, ainsi que leurs quotas et leurs tarifs.
Essayer d'autres fonctionnalités
- Découvrez comment générer du texte à partir de requêtes textuelles uniquement, y compris comment diffuser la réponse.
- Générez du texte en utilisant différents types de fichiers comme requêtes, par exemple des images, des PDF, des vidéos et des fichiers audio.
- Créez des conversations multitours (chat).
- Générez des résultats structurés (comme JSON) à partir de requêtes textuelles et multimodales.
- Générez et modifiez des images à partir de requêtes textuelles et multimodales.
- Entrée et sortie de flux (y compris audio) à l'aide de Gemini Live API.
- Utilisez des outils (comme l'appel de fonction et l'ancrage avec la recherche Google) pour connecter un modèle Gemini à d'autres parties de votre application, ainsi qu'à des systèmes et informations externes.
Découvrez comment contrôler la génération de contenu
- Comprendre la conception des requêtes, y compris les bonnes pratiques, les stratégies et des exemples de requêtes.
- Configurez les paramètres du modèle, comme le nombre maximal de jetons de sortie, la probabilité de jetons de sortie répétés, etc.
- Utilisez les paramètres de sécurité pour ajuster la probabilité d'obtenir des réponses qui peuvent être considérées comme dangereuses.
Envoyer des commentaires sur votre expérience avec Firebase AI Logic