Bắt đầu sử dụng Gemini API bằng Firebase AI Logic SDK

Swift

Hướng dẫn này giả định rằng bạn đã quen thuộc với việc sử dụng Xcode để phát triển ứng dụng cho các nền tảng của Apple (chẳng hạn như iOS).

Đảm bảo rằng môi trường phát triển và ứng dụng của bạn trên các nền tảng của Apple đáp ứng những yêu cầu sau:

• Xcode 26.2 trở lên
• Ứng dụng của bạn nhắm đến iOS 15 trở lên hoặc macOS 12 trở lên

Kotlin

Hướng dẫn này giả định rằng bạn đã quen với việc sử dụng Android Studio để phát triển ứng dụng cho Android.

Đảm bảo rằng môi trường phát triển và ứng dụng Android của bạn đáp ứng các yêu cầu sau:

• Android Studio (phiên bản mới nhất)
• Ứng dụng của bạn nhắm đến API cấp 21 trở lên

Java

Hướng dẫn này giả định rằng bạn đã quen với việc sử dụng Android Studio để phát triển ứng dụng cho Android.

Đảm bảo rằng môi trường phát triển và ứng dụng Android của bạn đáp ứng các yêu cầu sau:

• Android Studio (phiên bản mới nhất)
• Ứng dụng của bạn nhắm đến API cấp 21 trở lên

Web

Hướng dẫn này giả định rằng bạn đã quen thuộc với việc sử dụng JavaScript để phát triển ứng dụng web. Hướng dẫn này không phụ thuộc vào khung.

Đảm bảo rằng môi trường phát triển và ứng dụng web của bạn đáp ứng các yêu cầu sau:

• (Không bắt buộc) Node.js
• Trình duyệt web hiện đại

Dart

Hướng dẫn này giả định rằng bạn đã quen thuộc với việc phát triển ứng dụng bằng Flutter.

Đảm bảo rằng môi trường phát triển và ứng dụng Flutter của bạn đáp ứng các yêu cầu sau:

• Dart 3.2.0 trở lên

Unity

Hướng dẫn này giả định rằng bạn đã quen với việc phát triển trò chơi bằng Unity.

Đảm bảo rằng môi trường phát triển và trò chơi Unity của bạn đáp ứng các yêu cầu sau:

• Unity Editor 2021 LTS trở lên

Swift

Dùng thử ứng dụng bắt đầu nhanh

Sử dụng ứng dụng khởi động nhanh để dùng thử SDK một cách nhanh chóng và xem cách triển khai hoàn chỉnh của nhiều trường hợp sử dụng. Hoặc sử dụng ứng dụng khởi động nhanh nếu bạn không có ứng dụng riêng cho nền tảng Apple. Để sử dụng ứng dụng khởi động nhanh, bạn cần kết nối ứng dụng đó với một dự án Firebase.

Chuyển đến ứng dụng hướng dẫn nhanh

Xem video hướng dẫn

Video này minh hoạ cách bắt đầu sử dụng Firebase AI Logic bằng cách tạo một ứng dụng lập kế hoạch bữa ăn dựa trên AI trong thế giới thực, ứng dụng này tạo ra các công thức từ một câu lệnh văn bản.

Bạn cũng có thể tải xuống và khám phá toàn bộ mã nguồn cho ứng dụng trong video.

Xem toàn bộ mã nguồn cho ứng dụng của video

Kotlin

Dùng thử ứng dụng bắt đầu nhanh

Sử dụng ứng dụng khởi động nhanh để dùng thử SDK một cách nhanh chóng và xem cách triển khai hoàn chỉnh của nhiều trường hợp sử dụng. Hoặc sử dụng ứng dụng khởi động nhanh nếu bạn không có ứng dụng Android riêng. Để sử dụng ứng dụng khởi động nhanh, bạn cần kết nối ứng dụng đó với một dự án Firebase.

Chuyển đến ứng dụng hướng dẫn nhanh

Xem video hướng dẫn

Video này minh hoạ cách bắt đầu sử dụng Firebase AI Logic bằng cách tạo một ứng dụng lập kế hoạch bữa ăn dựa trên AI trong thế giới thực, ứng dụng này tạo ra các công thức từ một câu lệnh văn bản.

Bạn cũng có thể tải xuống và khám phá toàn bộ mã nguồn cho ứng dụng trong video.

Xem toàn bộ mã nguồn cho ứng dụng của video

Java

Dùng thử ứng dụng bắt đầu nhanh

Sử dụng ứng dụng khởi động nhanh để dùng thử SDK một cách nhanh chóng và xem cách triển khai hoàn chỉnh của nhiều trường hợp sử dụng. Hoặc sử dụng ứng dụng khởi động nhanh nếu bạn không có ứng dụng Android riêng. Để sử dụng ứng dụng khởi động nhanh, bạn cần kết nối ứng dụng đó với một dự án Firebase.

Chuyển đến ứng dụng hướng dẫn nhanh

Xem video hướng dẫn

Video này minh hoạ cách bắt đầu sử dụng Firebase AI Logic bằng cách tạo một ứng dụng lập kế hoạch bữa ăn dựa trên AI trong thế giới thực, ứng dụng này tạo ra các công thức từ một câu lệnh văn bản.^*

Bạn cũng có thể tải xuống và khám phá toàn bộ mã nguồn cho ứng dụng trong video.

Xem toàn bộ mã nguồn cho ứng dụng của video

^{* Video này và ứng dụng liên quan được viết bằng Kotlin, nhưng vẫn có thể giúp nhà phát triển Java hiểu những kiến thức cơ bản về cách bắt đầu với Firebase AI Logic.}

Web

Dùng thử ứng dụng bắt đầu nhanh

Sử dụng ứng dụng khởi động nhanh để dùng thử SDK một cách nhanh chóng và xem cách triển khai hoàn chỉnh của nhiều trường hợp sử dụng. Hoặc sử dụng ứng dụng khởi động nhanh nếu bạn không có ứng dụng web riêng. Để sử dụng ứng dụng khởi động nhanh, bạn cần kết nối ứng dụng đó với một dự án Firebase.

Chuyển đến ứng dụng hướng dẫn nhanh

Dart

Dùng thử ứng dụng bắt đầu nhanh

Sử dụng ứng dụng khởi động nhanh để dùng thử SDK một cách nhanh chóng và xem cách triển khai hoàn chỉnh của nhiều trường hợp sử dụng. Hoặc sử dụng ứng dụng khởi động nhanh nếu bạn không có ứng dụng Flutter riêng. Để sử dụng ứng dụng khởi động nhanh, bạn cần kết nối ứng dụng đó với một dự án Firebase.

Chuyển đến ứng dụng hướng dẫn nhanh

Xem video hướng dẫn

Video này minh hoạ cách bắt đầu sử dụng Firebase AI Logic bằng cách tạo một ứng dụng lập kế hoạch bữa ăn dựa trên AI trong thế giới thực, ứng dụng này tạo ra các công thức từ một câu lệnh văn bản.

Bạn cũng có thể tải xuống và khám phá toàn bộ mã nguồn cho ứng dụng trong video.

Xem toàn bộ mã nguồn cho ứng dụng của video

Unity

Dùng thử ứng dụng bắt đầu nhanh

Sử dụng ứng dụng khởi động nhanh để dùng thử SDK một cách nhanh chóng và xem cách triển khai hoàn chỉnh của nhiều trường hợp sử dụng. Hoặc sử dụng ứng dụng khởi động nhanh nếu bạn không có trò chơi Unity của riêng mình. Để sử dụng ứng dụng khởi động nhanh, bạn cần kết nối ứng dụng đó với một dự án Firebase.

Chuyển đến ứng dụng hướng dẫn nhanh

Swift

Sử dụng Swift Package Manager để cài đặt và quản lý các phần phụ thuộc của Firebase. Tìm hiểu về các lựa chọn cài đặt khác (nếu cần).

Thư viện Firebase AI Logic cung cấp quyền truy cập vào các API để tương tác với các mô hình Gemini. Thư viện này có trong Firebase SDK cho các nền tảng của Apple (firebase-ios-sdk).

Nếu bạn đang sử dụng Firebase, hãy đảm bảo gói Firebase của bạn là phiên bản 12.5.0 trở lên.

1. Trong Xcode, khi dự án ứng dụng của bạn đang mở, hãy chuyển đến File (Tệp) > Add Package Dependencies (Thêm phần phụ thuộc của gói).

2. Khi được nhắc, hãy thêm kho lưu trữ SDK nền tảng Apple của Firebase:

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

3. Chọn phiên bản SDK mới nhất.

4. Chọn thư viện FirebaseAILogic và thư viện FirebaseAppCheck.

Khi hoàn tất, Xcode sẽ tự động bắt đầu phân giải và tải các phần phụ thuộc xuống ở chế độ nền.

Kotlin

Firebase AI Logic SDK cho Android (firebase-ai) cung cấp quyền truy cập vào các API để tương tác với các mô hình Gemini.

Trong tệp Gradle (cấp ứng dụng) của mô-đun (chẳng hạn như <project>/<app-module>/build.gradle.kts), hãy thêm phần phụ thuộc cho thư viện Firebase AI Logic cho Android. Bạn nên sử dụng Firebase Android BoM để kiểm soát việc tạo phiên bản thư viện.

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

Bằng cách sử dụng Firebase Android BoM, ứng dụng của bạn sẽ luôn sử dụng những phiên bản tương thích của thư viện Android trên Firebase.

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

Firebase AI Logic SDK cho Android (firebase-ai) cung cấp quyền truy cập vào các API để tương tác với các mô hình Gemini.

Trong tệp Gradle (cấp ứng dụng) của mô-đun (chẳng hạn như <project>/<app-module>/build.gradle.kts), hãy thêm phần phụ thuộc cho thư viện Firebase AI Logic cho Android. Bạn nên sử dụng Firebase Android BoM để kiểm soát việc tạo phiên bản thư viện.

Đối với Java, bạn cần thêm 2 thư viện bổ sung.

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

Bằng cách sử dụng Firebase Android BoM, ứng dụng của bạn sẽ luôn sử dụng những phiên bản tương thích của thư viện Android trên Firebase.

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

Thư viện Firebase AI Logic cung cấp quyền truy cập vào các API để tương tác với các mô hình Gemini. Thư viện này được đưa vào dưới dạng một phần của SDK JavaScript của Firebase cho Web.

1. Cài đặt Firebase JS SDK cho Web bằng npm:

   npm install firebase
   

2. Khởi động Firebase trong ứng dụng của bạn:

   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

Trình bổ trợ Firebase AI Logic cho Flutter (firebase_ai) cung cấp quyền truy cập vào các API để tương tác với các mô hình Gemini.

1. Trong thư mục dự án Flutter, hãy chạy lệnh sau để cài đặt trình bổ trợ cốt lõi và trình bổ trợ Firebase AI Logic:

   flutter pub add firebase_ai firebase_app_check
   

2. Trong tệp lib/main.dart, hãy nhập các trình bổ trợ Firebase AI Logic và 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. Ngoài ra, trong tệp lib/main.dart, hãy đảm bảo rằng bạn đã khởi chạy Firebase bằng đối tượng DefaultFirebaseOptions do tệp cấu hình xuất:

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

4. Tạo lại ứng dụng Flutter:

   flutter run
   

Unity

1. Tải Firebase Unity SDK xuống, sau đó trích xuất SDK ở một nơi thuận tiện.

   SDK Firebase Unity không dành riêng cho nền tảng.

2. Trong dự án Unity đang mở, hãy chuyển đến Assets (Tài sản) > Import Package (Nhập gói) > Custom Package (Gói tuỳ chỉnh).

3. Trong SDK đã trích xuất, hãy chọn gói FirebaseAI và gói FirebaseAppCheck.

4. Trong cửa sổ Import Unity Package (Nhập gói Unity), hãy nhấp vào Import (Nhập).

Swift

Sau đây là cách sử dụng trình cung cấp gỡ lỗi trong khi chạy ứng dụng của bạn trong trình mô phỏng một cách tương tác (ví dụ: trong quá trình phát triển cục bộ):

1. Trong dự án Xcode, hãy nhập FirebaseAppCheck và khởi chạy App Check bằng nhà máy nhà cung cấp gỡ lỗi trước khi bạn định cấu hình 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. Lấy mã thông báo gỡ lỗi:

   1. Chạy ứng dụng trong trình mô phỏng hoặc trên thiết bị kiểm thử.

   2. Mở bảng điều khiển Xcode rồi tìm mã gỡ lỗi App Check. Ví dụ:

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

   3. Sao chép mã thông báo (ví dụ: 123a4567-b89c-12d3-e456-789012345678).

3. Đăng ký mã thông báo gỡ lỗi bằng App Check:

   1. Trong bảng điều khiển Firebase, hãy chuyển đến thẻ Bảo mật > App Check > Ứng dụng.

   2. Tìm ứng dụng của bạn, nhấp vào trình đơn tràn (more_vert), rồi chọn Quản lý mã gỡ lỗi.

   3. Làm theo hướng dẫn trên màn hình để đăng ký mã gỡ lỗi.

Để biết thông tin chi tiết về trình cung cấp gỡ lỗi (bao gồm cả cách lấy mã gỡ lỗi mới), hãy xem tài liệu App Check chính thức.

Kotlin

Sau đây là cách sử dụng trình cung cấp gỡ lỗi trong khi chạy ứng dụng của bạn trong trình mô phỏng một cách tương tác (ví dụ: trong quá trình phát triển cục bộ):

1. Trong bản gỡ lỗi, hãy định cấu hình App Check để sử dụng nhà máy trình cung cấp gỡ lỗi:

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

2. Lấy mã thông báo gỡ lỗi:

   1. Chạy ứng dụng trong trình mô phỏng hoặc trên thiết bị kiểm thử.

   2. Tìm mã thông báo gỡ lỗi App Check trong nhật ký của bạn. Ví dụ:

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

   3. Sao chép mã thông báo (ví dụ: 123a4567-b89c-12d3-e456-789012345678).

3. Đăng ký mã thông báo gỡ lỗi bằng App Check:

   1. Trong bảng điều khiển Firebase, hãy chuyển đến thẻ Bảo mật > App Check > Ứng dụng.

   2. Tìm ứng dụng của bạn, nhấp vào trình đơn tràn (more_vert), rồi chọn Quản lý mã gỡ lỗi.

   3. Làm theo hướng dẫn trên màn hình để đăng ký mã gỡ lỗi.

Để biết thông tin chi tiết về trình cung cấp gỡ lỗi (bao gồm cả cách lấy mã gỡ lỗi mới), hãy xem tài liệu App Check chính thức.

Java

Sau đây là cách sử dụng trình cung cấp gỡ lỗi trong khi chạy ứng dụng của bạn trong trình mô phỏng một cách tương tác (ví dụ: trong quá trình phát triển cục bộ):

1. Trong bản gỡ lỗi, hãy định cấu hình App Check để sử dụng nhà máy trình cung cấp gỡ lỗi:

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

2. Lấy mã thông báo gỡ lỗi:

   1. Chạy ứng dụng trong trình mô phỏng hoặc trên thiết bị kiểm thử.

   2. Tìm mã thông báo gỡ lỗi App Check trong nhật ký của bạn. Ví dụ:

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

   3. Sao chép mã thông báo (ví dụ: 123a4567-b89c-12d3-e456-789012345678).

3. Đăng ký mã thông báo gỡ lỗi bằng App Check:

   1. Trong bảng điều khiển Firebase, hãy chuyển đến thẻ Bảo mật > App Check > Ứng dụng.

   2. Tìm ứng dụng của bạn, nhấp vào trình đơn tràn (more_vert), rồi chọn Quản lý mã gỡ lỗi.

   3. Làm theo hướng dẫn trên màn hình để đăng ký mã gỡ lỗi.

Để biết thông tin chi tiết về trình cung cấp gỡ lỗi (bao gồm cả cách lấy mã gỡ lỗi mới), hãy xem tài liệu App Check chính thức.

Web

Sau đây là cách sử dụng trình cung cấp gỡ lỗi trong khi chạy ứng dụng từ localhost một cách tương tác (ví dụ: trong quá trình phát triển cục bộ):

1. Trong bản gỡ lỗi, hãy bật chế độ gỡ lỗi bằng cách đặt self.FIREBASE_APPCHECK_DEBUG_TOKEN thành true trước khi bạn khởi chạy App Check. Ví dụ:

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

2. Truy cập vào ứng dụng web của bạn trên thiết bị và mở công cụ dành cho nhà phát triển của trình duyệt. Trong bảng điều khiển gỡ lỗi, bạn sẽ thấy một mã gỡ lỗi:

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

3. Đăng ký mã thông báo gỡ lỗi bằng App Check:

   1. Trong bảng điều khiển Firebase, hãy chuyển đến thẻ Bảo mật > App Check > Ứng dụng.

   2. Tìm ứng dụng của bạn, nhấp vào trình đơn tràn (more_vert), rồi chọn Quản lý mã gỡ lỗi.

   3. Làm theo hướng dẫn trên màn hình để đăng ký mã gỡ lỗi.

Để biết thông tin chi tiết về trình cung cấp gỡ lỗi (bao gồm cả cách lấy mã gỡ lỗi mới), hãy xem tài liệu App Check chính thức.

Dart

Để biết thông tin chi tiết về trình cung cấp gỡ lỗi (bao gồm cả cách lấy mã gỡ lỗi mới), hãy xem tài liệu App Check chính thức.

Unity

Sau đây là cách sử dụng trình cung cấp gỡ lỗi trong khi chạy ứng dụng của bạn trong trình mô phỏng một cách tương tác (ví dụ: trong quá trình phát triển cục bộ):

1. Trong bảng điều khiển Firebase, hãy tạo mã thông báo gỡ lỗi:

   1. Trong bảng điều khiển Firebase, hãy chuyển đến thẻ Bảo mật > App Check > Ứng dụng.

   2. Tìm ứng dụng của bạn, nhấp vào trình đơn tràn (more_vert), rồi chọn Quản lý mã gỡ lỗi.

   3. Làm theo hướng dẫn trên màn hình để tạo mã gỡ lỗi mới.

2. Trong mã khởi chạy của ứng dụng, hãy thêm nội dung sau:

   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
   }
   

Để biết thông tin chi tiết về trình cung cấp gỡ lỗi (bao gồm cả cách lấy mã gỡ lỗi mới), hãy xem tài liệu App Check chính thức.

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