Inizia a utilizzare l'API Gemini con gli SDK Firebase AI Logic

Swift

Questa guida presuppone che tu abbia familiarità con l'utilizzo di Xcode per sviluppare app per piattaforme Apple (come iOS).

Assicurati che il tuo ambiente di sviluppo e l'app per le piattaforme Apple soddisfino questi requisiti:

• Xcode 26.2 o versioni successive
• La tua app ha come target iOS 15 o versioni successive oppure macOS 12 o versioni successive

Kotlin

Questa guida presuppone che tu abbia familiarità con l'utilizzo di Android Studio per sviluppare app per Android.

Assicurati che il tuo ambiente di sviluppo e la tua app per Android soddisfino questi requisiti:

• Android Studio (ultima versione)
• La tua app ha come target il livello API 21 o versioni successive

Java

Questa guida presuppone che tu abbia familiarità con l'utilizzo di Android Studio per sviluppare app per Android.

Assicurati che il tuo ambiente di sviluppo e la tua app per Android soddisfino questi requisiti:

• Android Studio (ultima versione)
• La tua app ha come target il livello API 21 o versioni successive

Web

Questa guida presuppone che tu abbia familiarità con l'utilizzo di JavaScript per sviluppare app web. Questa guida è indipendente dal framework.

Assicurati che il tuo ambiente di sviluppo e la tua app web soddisfino questi requisiti:

• (Facoltativo) Node.js
• Browser web moderno

Dart

Questa guida presuppone che tu abbia familiarità con lo sviluppo di app con Flutter.

Assicurati che il tuo ambiente di sviluppo e la tua app Flutter soddisfino questi requisiti:

• Dart 3.2.0+

Unity

Questa guida presuppone che tu abbia familiarità con lo sviluppo di giochi con Unity.

Assicurati che il tuo ambiente di sviluppo e il gioco Unity soddisfino questi requisiti:

• Unity Editor 2021 LTS o versioni successive

Swift

Prova l'app di avvio rapido

Utilizza l'app di avvio rapido per provare rapidamente l'SDK e visualizzare un'implementazione completa di vari casi d'uso. In alternativa, utilizza l'app di avvio rapido se non hai un'app per le piattaforme Apple. Per utilizzare l'app di avvio rapido, devi collegarla a un progetto Firebase.

Vai all'app Guida rapida

Guarda un tutorial video

Questo video mostra come iniziare a utilizzare Firebase AI Logic creando un'app di pianificazione dei pasti basata sull'AI che genera ricette da un prompt testuale.

Puoi anche scaricare ed esplorare il codice sorgente dell'app nel video.

Visualizzare la base di codice dell'app del video

Kotlin

Prova l'app di avvio rapido

Utilizza l'app di avvio rapido per provare rapidamente l'SDK e visualizzare un'implementazione completa di vari casi d'uso. In alternativa, utilizza l'app di avvio rapido se non hai un'app Android. Per utilizzare l'app di avvio rapido, devi collegarla a un progetto Firebase.

Vai all'app Guida rapida

Guarda un tutorial video

Questo video mostra come iniziare a utilizzare Firebase AI Logic creando un'app di pianificazione dei pasti basata sull'AI che genera ricette da un prompt testuale.

Puoi anche scaricare ed esplorare il codice sorgente dell'app nel video.

Visualizzare la base di codice dell'app del video

Java

Prova l'app di avvio rapido

Utilizza l'app di avvio rapido per provare rapidamente l'SDK e visualizzare un'implementazione completa di vari casi d'uso. In alternativa, utilizza l'app di avvio rapido se non hai un'app Android. Per utilizzare l'app di avvio rapido, devi collegarla a un progetto Firebase.

Vai all'app Guida rapida

Guarda un tutorial video

Questo video mostra come iniziare a utilizzare Firebase AI Logic creando un'app di pianificazione dei pasti basata sull'AI che genera ricette da un prompt di testo.^*

Puoi anche scaricare ed esplorare il codice sorgente dell'app nel video.

Visualizzare la base di codice dell'app del video

^{* Questo video e la relativa app sono in Kotlin, ma possono comunque aiutare gli sviluppatori Java a comprendere le nozioni di base su come iniziare a utilizzare Firebase AI Logic.}

Web

Prova l'app di avvio rapido

Utilizza l'app di avvio rapido per provare rapidamente l'SDK e visualizzare un'implementazione completa di vari casi d'uso. In alternativa, utilizza l'app di avvio rapido se non hai un'applicazione web. Per utilizzare l'app di avvio rapido, devi collegarla a un progetto Firebase.

Vai all'app Guida rapida

Dart

Prova l'app di avvio rapido

Utilizza l'app di avvio rapido per provare rapidamente l'SDK e visualizzare un'implementazione completa di vari casi d'uso. In alternativa, utilizza l'app di avvio rapido se non hai un'app Flutter. Per utilizzare l'app di avvio rapido, devi collegarla a un progetto Firebase.

Vai all'app Guida rapida

Guarda un tutorial video

Questo video mostra come iniziare a utilizzare Firebase AI Logic creando un'app di pianificazione dei pasti basata sull'AI che genera ricette da un prompt testuale.

Puoi anche scaricare ed esplorare il codice sorgente dell'app nel video.

Visualizzare la base di codice dell'app del video

Unity

Prova l'app di avvio rapido

Utilizza l'app di avvio rapido per provare rapidamente l'SDK e visualizzare un'implementazione completa di vari casi d'uso. Oppure utilizza l'app di avvio rapido se non hai un gioco Unity. Per utilizzare l'app di avvio rapido, devi collegarla a un progetto Firebase.

Vai all'app Guida rapida

Swift

Utilizza Swift Package Manager per installare e gestire le dipendenze di Firebase. Scopri altre opzioni di installazione, se necessario.

La libreria Firebase AI Logic fornisce l'accesso alle API per interagire con i modelli Gemini. La libreria è inclusa nell'SDK Firebase per le piattaforme Apple (firebase-ios-sdk).

Se utilizzi già Firebase, assicurati che il pacchetto Firebase sia v12.5.0 o versioni successive.

1. In Xcode, con il progetto dell'app aperto, vai a File > Add Package Dependencies (File > Aggiungi dipendenze pacchetto).

2. Quando richiesto, aggiungi il repository dell'SDK delle piattaforme Apple di Firebase:

   https://github.com/firebase/firebase-ios-sdk
   

3. Seleziona l'ultima versione dell'SDK.

4. Seleziona la raccolta FirebaseAILogic e la raccolta FirebaseAppCheck.

Al termine, Xcode inizierà automaticamente a risolvere e a scaricare le tue dipendenze in background.

Kotlin

L'SDK Firebase AI Logic per Android (firebase-ai) fornisce l'accesso alle API per interagire con i modelli Gemini.

Nel file Gradle (a livello di app) del modulo (ad esempio <project>/<app-module>/build.gradle.kts), aggiungi le dipendenze per le librerie Firebase AI Logic e App Check per Android. Ti consigliamo di utilizzare Firebase Android BoM per controllare il controllo delle versioni della libreria.

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")
}

Utilizzando la Firebase Android BoM, la tua app utilizzerà sempre versioni compatibili delle librerie Firebase Android.

dependencies {
  // Add the dependencies for the Firebase AI Logic and App Check libraries
  // When NOT using the BoM, you must specify versions in Firebase library dependencies
  implementation("com.google.firebase:firebase-ai:17.13.0")
  implementation("com.google.firebase:firebase-appcheck-debug:19.2.0")
}

Java

L'SDK Firebase AI Logic per Android (firebase-ai) fornisce l'accesso alle API per interagire con i modelli Gemini.

Nel file Gradle (a livello di app) del modulo (ad esempio <project>/<app-module>/build.gradle.kts), aggiungi le dipendenze per le librerie Firebase AI Logic e App Check per Android. Ti consigliamo di utilizzare Firebase Android BoM per controllare il controllo delle versioni della libreria.

Per Java, devi aggiungere due librerie aggiuntive.

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")
}

Utilizzando la Firebase Android BoM, la tua app utilizzerà sempre versioni compatibili delle librerie Firebase Android.

dependencies {
  // Add the dependencies for the Firebase AI Logic and App Check libraries
  // When NOT using the BoM, you must specify versions in Firebase library dependencies
  implementation("com.google.firebase:firebase-ai:17.13.0")
  implementation("com.google.firebase:firebase-appcheck-debug:19.2.0")
}

Web

La libreria Firebase AI Logic fornisce l'accesso alle API per interagire con i modelli Gemini. La libreria è inclusa nell'SDK Firebase JavaScript per il web.

1. Installa l'SDK Firebase JS per il web utilizzando npm:

   npm install firebase
   

2. Inizializza Firebase nella tua 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

Il plug-in Firebase AI Logic per Flutter (firebase_ai) fornisce l'accesso alle API per interagire con i modelli Gemini.

1. Dalla directory del progetto Flutter, esegui questo comando per installare i plug-in Firebase AI Logic e App Check:

   flutter pub add firebase_ai firebase_app_check
   

2. Nel file lib/main.dart, importa i plug-in Firebase AI Logic e 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';
   

3. Inoltre, nel file lib/main.dart, assicurati di aver inizializzato Firebase utilizzando l'oggetto DefaultFirebaseOptions esportato dal file di configurazione:

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

4. Ricrea l'applicazione Flutter:

   flutter run
   

Unity

1. Scarica l'SDK Firebase Unity, quindi estrailo in una posizione comoda.

   L'SDK Firebase Unity non è specifico della piattaforma.

2. Nel tuo progetto Unity aperto, vai a Assets > Import Package > Custom Package (Risorse > Importa pacchetto > Pacchetto personalizzato).

3. Dall'SDK estratto, seleziona i pacchetti FirebaseAI e FirebaseAppCheck.

4. Nella finestra Import Unity Package (Importa il pacchetto Unity), fai clic su Import (Importa).

Swift

Ecco come utilizzare il provider di debug durante l'esecuzione dell'app in un simulatore in modo interattivo (ad esempio, durante lo sviluppo locale):

1. Nel progetto Xcode, importa FirebaseAppCheck e inizializza App Check con la fabbrica del provider di debug prima di configurare Firebase.

   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()
         }
       }
     }
   }
   

2. Ottieni il token di debug:

   1. Avvia l'app nel simulatore o sul dispositivo di test.

   2. Apri la console Xcode e cerca il token di debug App Check. Ad esempio:

      <Warning> [AppCheckCore][I-GAC004001] App Check debug token: '123a4567-b89c-12d3-e456-789012345678'.
      

   3. Copia il token (ad esempio, 123a4567-b89c-12d3-e456-789012345678).

3. Registra il token di debug con App Check:

   1. Nella console Firebase, vai alla scheda Sicurezza > App Check > App.

   2. Trova la tua app, fai clic sul menu extra (more_vert) e poi seleziona Gestisci token di debug.

   3. Segui le istruzioni sullo schermo per registrare il token di debug.

Per informazioni dettagliate sul fornitore di debug (incluso come ottenere un nuovo token di debug), consulta la documentazione ufficiale di App Check.

Kotlin

Ecco come utilizzare il provider di debug durante l'esecuzione dell'app in un emulatore in modo interattivo (ad esempio, durante lo sviluppo locale):

1. Nella build di debug, configura App Check in modo da utilizzare la fabbrica del provider di debug:

   Firebase.initialize(context = this)
   Firebase.appCheck.installAppCheckProviderFactory(
       DebugAppCheckProviderFactory.getInstance(),
   )
   MainActivity.kt

2. Ottieni il token di debug:

   1. Esegui l'app nell'emulatore o sul dispositivo di test.

   2. Cerca il token di debug App Check nei log. Ad esempio:

      D DebugAppCheckProvider: Enter this debug secret into the allow list
      in the Firebase Console for your project: 123a4567-b89c-12d3-e456-789012345678
      

   3. Copia il token (ad esempio, 123a4567-b89c-12d3-e456-789012345678).

3. Registra il token di debug con App Check:

   1. Nella console Firebase, vai alla scheda Sicurezza > App Check > App.

   2. Trova la tua app, fai clic sul menu extra (more_vert) e poi seleziona Gestisci token di debug.

   3. Segui le istruzioni sullo schermo per registrare il token di debug.

Per informazioni dettagliate sul fornitore di debug (incluso come ottenere un nuovo token di debug), consulta la documentazione ufficiale di App Check.

Java

Ecco come utilizzare il provider di debug durante l'esecuzione dell'app in un emulatore in modo interattivo (ad esempio, durante lo sviluppo locale):

1. Nella build di debug, configura App Check in modo da utilizzare la fabbrica del provider di debug:

   FirebaseApp.initializeApp(/*context=*/ this);
   FirebaseAppCheck firebaseAppCheck = FirebaseAppCheck.getInstance();
   firebaseAppCheck.installAppCheckProviderFactory(
           DebugAppCheckProviderFactory.getInstance());
   MainActivity.java

2. Ottieni il token di debug:

   1. Esegui l'app nell'emulatore o sul dispositivo di test.

   2. Cerca il token di debug App Check nei log. Ad esempio:

      D DebugAppCheckProvider: Enter this debug secret into the allow list
      in the Firebase Console for your project: 123a4567-b89c-12d3-e456-789012345678
      

   3. Copia il token (ad esempio, 123a4567-b89c-12d3-e456-789012345678).

3. Registra il token di debug con App Check:

   1. Nella console Firebase, vai alla scheda Sicurezza > App Check > App.

   2. Trova la tua app, fai clic sul menu extra (more_vert) e poi seleziona Gestisci token di debug.

   3. Segui le istruzioni sullo schermo per registrare il token di debug.

Per informazioni dettagliate sul fornitore di debug (incluso come ottenere un nuovo token di debug), consulta la documentazione ufficiale di App Check.

Web

Ecco come utilizzare il provider di debug durante l'esecuzione dell'app da localhost in modo interattivo (ad esempio, durante lo sviluppo locale):

1. Nella build di debug, attiva la modalità di debug impostando self.FIREBASE_APPCHECK_DEBUG_TOKEN su true prima di inizializzare App Check. Ad esempio:

   self.FIREBASE_APPCHECK_DEBUG_TOKEN = true;
   initializeAppCheck(app, { /* App Check options */ });
   

2. Visita la tua app web in locale e apri gli strumenti per sviluppatori del browser. Nella console di debug, vedrai un token di debug:

   AppCheck debug token: "123a4567-b89c-12d3-e456-789012345678".
   You will need to safelist it in the Firebase console for it to work.
   

3. Registra il token di debug con App Check:

   1. Nella console Firebase, vai alla scheda Sicurezza > App Check > App.

   2. Trova la tua app, fai clic sul menu extra (more_vert) e poi seleziona Gestisci token di debug.

   3. Segui le istruzioni sullo schermo per registrare il token di debug.

Per informazioni dettagliate sul fornitore di debug (incluso come ottenere un nuovo token di debug), consulta la documentazione ufficiale di App Check.

Dart

Per informazioni dettagliate sul fornitore di debug (incluso come ottenere un nuovo token di debug), consulta la documentazione ufficiale di App Check.

Unity

Ecco come utilizzare il provider di debug durante l'esecuzione dell'app in un emulatore in modo interattivo (ad esempio, durante lo sviluppo locale):

1. Nella console Firebase, crea un token di debug:

   1. Nella console Firebase, vai alla scheda Sicurezza > App Check > App.

   2. Trova la tua app, fai clic sul menu extra (more_vert) e poi seleziona Gestisci token di debug.

   3. Segui le istruzioni sullo schermo per creare un nuovo token di debug.

2. Nel codice di inizializzazione dell'app, aggiungi quanto segue:

   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
   }
   

Per informazioni dettagliate sul fornitore di debug (incluso come ottenere un nuovo token di debug), consulta la documentazione ufficiale di App Check.

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");

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

// 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

// 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.");