شروع به کار با Gemini API بااستفاده از Firebase AI Logic SDKs

Swift

این راهنما فرض می‌کند که با استفاده از Xcode برای توسعه برنامه‌های پلاتفرم‌های Apple (مثل iOS) آشنایی دارید.

مطمئن شوید که محیط توسعه و برنامه پلاتفرم‌های Apple شما این الزامات را برآورده می‌کنند:

• ‫Xcode نسخه ۲۶.۲ یا بالاتر
• برنامه شما iOS 15 یا بالاتر، یا macOS 12 یا بالاتر را هدف‌یابی می‌کند

Kotlin

این راهنما فرض می‌کند که با استفاده از Android Studio برای توسعه برنامه‌های Android آشنا هستید.

مطمئن شوید که محیط توسعه و برنامه Android شما این الزامات را برآورده می‌کنند:

• استودیو Android (جدیدترین نسخه)
• برنامه‌تان سطح میانای برنامه‌سازی کاربردی ۲۴ (Nougat) یا بالاتر را هدف‌یابی می‌کند

Java

این راهنما فرض می‌کند که با استفاده از Android Studio برای توسعه برنامه‌های Android آشنا هستید.

مطمئن شوید که محیط توسعه و برنامه Android شما این الزامات را برآورده می‌کنند:

• استودیو Android (جدیدترین نسخه)
• برنامه‌تان سطح میانای برنامه‌سازی کاربردی ۲۴ (Nougat) یا بالاتر را هدف‌یابی می‌کند

Web

این راهنما فرض می‌کند که با استفاده از جاوا اسکریپت برای توسعه برنامه‌های وب آشنا هستید. این راهنما مستقل از چارچوب است.

مطمئن شوید محیط توسعه و برنامه وب شما این الزامات را برآورده می‌کند:

• (اختیاری) Node.js
• مرورگر وب مدرن

Dart

این راهنما فرض می‌کند که با توسعه برنامه‌ها با Flutter آشنا هستید.

مطمئن شوید که محیط توسعه و برنامه Flutter شما این الزامات را برآورده می‌کنند:

• ‫Dart نسخه 3.2.0 و بالاتر

Unity

این راهنما فرض می‌کند که شما با توسعه بازی با Unity آشنا هستید.

مطمئن شوید که محیط توسعه و بازی Unity شما این الزامات را برآورده می‌کنند:

• ‫Unity Editor 2021 LTS یا جدیدتر

Swift

برنامه شروع سریع را امتحان کنید

از برنامه شروع سریع برای امتحان کردن سریع کیت توسعه نرم‌افزار و دیدن پیاده‌سازی کامل موارد استفاده مختلف استفاده کنید. یا اگر برنامه پلاتفرم‌های Apple خودتان را ندارید، از برنامه شروع سریع استفاده کنید. برای استفاده از برنامه شروع سریع، باید آن را به پروژه Firebase متصل کنید.

رفتن به برنامه شروع سریع

تماشای آموزش ویدیویی

این ویدیو نشان می‌دهد که چگونه با ساختن برنامه هوشواره‌ای واقعی برای برنامه‌ریزی وعده‌های غذایی که دستورالعمل‌های غذا را از پیام‌واره نوشتاری تولید می‌کند، کار با Firebase AI Logic را شروع کنید.

همچنین می‌توانید پایگاه کد برنامه را در ویدیو بارگیری و کاوش کنید.

مشاهده پایگاه کد برای برنامه ویدیو

Kotlin

برنامه شروع سریع را امتحان کنید

از برنامه شروع سریع برای امتحان کردن سریع کیت توسعه نرم‌افزار و دیدن پیاده‌سازی کامل موارد استفاده مختلف استفاده کنید. یا اگر برنامه Android خودتان را ندارید، از برنامه شروع سریع استفاده کنید. برای استفاده از برنامه شروع سریع، باید آن را به پروژه Firebase متصل کنید.

رفتن به برنامه شروع سریع

تماشای آموزش ویدیویی

این ویدیو نشان می‌دهد که چگونه با ساختن برنامه هوشواره‌ای واقعی برای برنامه‌ریزی وعده‌های غذایی که دستورالعمل‌های غذا را از پیام‌واره نوشتاری تولید می‌کند، کار با Firebase AI Logic را شروع کنید.

همچنین می‌توانید پایگاه کد برنامه را در ویدیو بارگیری و کاوش کنید.

مشاهده پایگاه کد برای برنامه ویدیو

Java

برنامه شروع سریع را امتحان کنید

از برنامه شروع سریع برای امتحان کردن سریع کیت توسعه نرم‌افزار و دیدن پیاده‌سازی کامل موارد استفاده مختلف استفاده کنید. یا اگر برنامه Android خودتان را ندارید، از برنامه شروع سریع استفاده کنید. برای استفاده از برنامه شروع سریع، باید آن را به پروژه Firebase متصل کنید.

رفتن به برنامه شروع سریع

تماشای آموزش ویدیویی

این ویدیو نشان می‌دهد که چگونه با Firebase AI Logic شروع کنید و برنامه هوش مصنوعی برای برنامه‌ریزی وعده‌های غذایی در دنیای واقعی بسازید که دستورالعمل‌های غذا را از پیام‌واره نوشتاری تولید می‌کند.^*

همچنین می‌توانید پایگاه کد برنامه را در ویدیو بارگیری و کاوش کنید.

مشاهده پایگاه کد برای برنامه ویدیو

^{* این ویدیو و برنامه آن به زبان Kotlin است، اما همچنان می‌تواند به توسعه‌دهندگان Java کمک کند تا با اصول اولیه شروع کار با Firebase AI Logic آشنا شوند.}

Web

برنامه شروع سریع را امتحان کنید

از برنامه شروع سریع برای امتحان کردن سریع کیت توسعه نرم‌افزار و دیدن پیاده‌سازی کامل موارد استفاده مختلف استفاده کنید. یا اگر برنامه وب خودتان را ندارید، از برنامه شروع سریع استفاده کنید. برای استفاده از برنامه شروع سریع، باید آن را به پروژه Firebase متصل کنید.

رفتن به برنامه شروع سریع

Dart

برنامه شروع سریع را امتحان کنید

از برنامه شروع سریع برای امتحان کردن سریع کیت توسعه نرم‌افزار و دیدن پیاده‌سازی کامل موارد استفاده مختلف استفاده کنید. یا اگر برنامه Flutter خودتان را ندارید، از برنامه شروع سریع استفاده کنید. برای استفاده از برنامه شروع سریع، باید آن را به پروژه Firebase متصل کنید.

رفتن به برنامه شروع سریع

تماشای آموزش ویدیویی

این ویدیو نشان می‌دهد که چگونه با ساختن برنامه هوشواره‌ای واقعی برای برنامه‌ریزی وعده‌های غذایی که دستورالعمل‌های غذا را از پیام‌واره نوشتاری تولید می‌کند، کار با Firebase AI Logic را شروع کنید.

همچنین می‌توانید پایگاه کد برنامه را در ویدیو بارگیری و کاوش کنید.

مشاهده پایگاه کد برای برنامه ویدیو

Unity

برنامه شروع سریع را امتحان کنید

از برنامه شروع سریع برای امتحان کردن سریع کیت توسعه نرم‌افزار و دیدن پیاده‌سازی کامل موارد استفاده مختلف استفاده کنید. یا اگر بازی Unity خودتان را ندارید، از برنامه شروع سریع استفاده کنید. برای استفاده از برنامه شروع سریع، باید آن را به پروژه Firebase متصل کنید.

رفتن به برنامه شروع سریع

Swift

از «مدیر بسته Swift» برای نصب و مدیریت وابستگی‌های Firebase استفاده کنید. درصورت نیاز، با سایر گزینه‌های نصب آشنا شوید.

کتابخانه Firebase AI Logic امکان دسترسی به میاناهای برنامه‌سازی کاربردی را برای تعامل با مدل‌های Gemini فراهم می‌کند. این کتابخانه به‌عنوان بخشی از کیت توسعه نرم‌افزار Firebase برای پلاتفرم‌های Apple (firebase-ios-sdk) ارائه می‌شود.

اگر ازقبل از Firebase استفاده می‌کنید، مطمئن شوید بسته Firebase شما نسخه ۱۲.۵.۰ یا بالاتر باشد.

1. در Xcode، با باز بودن پروژه برنامه، به File (فایل) > Add Package Dependencies (افزودن وابستگی‌های بسته) پیمایش کنید.

2. وقتی درخواست شد، مخزن کیت توسعه نرم‌افزار پلاتفرم‌های Firebase Apple را اضافه کنید:

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

3. جدیدترین نسخه کیت توسعه نرم‌افزار را انتخاب کنید.

4. کتابخانه FirebaseAILogic و کتابخانه FirebaseAppCheck را انتخاب کنید.

پس‌از اتمام، Xcode به‌طور خودکار شروع به حل و بارگیری وابستگی‌های شما در پس‌زمینه می‌کند.

Kotlin

«کیت توسعه نرم‌افزار Firebase AI Logic برای Android» (firebase-ai) امکان دسترسی به میاناهای برنامه‌سازی کاربردی برای تعامل با مدل‌های Gemini را فراهم می‌کند.

در فایل Gradle واحد (سطح برنامه) (مثل <project>/<app-module>/build.gradle.kts)، وابستگی‌های کتابخانه‌های Firebase AI Logic و App Check برای Android را اضافه کنید. توصیه می‌کنیم از Firebase Android BoM برای کنترل نسخه‌بندی کتابخانه استفاده کنید.

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

بااستفاده از Firebase Android BoM، برنامه شما همیشه از نسخه‌های سازگار کتابخانه‌های 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:18.0.0")
  implementation("com.google.firebase:firebase-appcheck-debug:20.0.0")
}

Java

«کیت توسعه نرم‌افزار Firebase AI Logic برای Android» (firebase-ai) امکان دسترسی به میاناهای برنامه‌سازی کاربردی برای تعامل با مدل‌های Gemini را فراهم می‌کند.

در فایل Gradle واحد (سطح برنامه) (مثل <project>/<app-module>/build.gradle.kts)، وابستگی‌های کتابخانه‌های Firebase AI Logic و App Check برای Android را اضافه کنید. توصیه می‌کنیم از Firebase Android BoM برای کنترل نسخه‌بندی کتابخانه استفاده کنید.

برای Java، باید دو کتابخانه دیگر اضافه کنید.

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

بااستفاده از Firebase Android BoM، برنامه شما همیشه از نسخه‌های سازگار کتابخانه‌های 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:18.0.0")
  implementation("com.google.firebase:firebase-appcheck-debug:20.0.0")
}

Web

کتابخانه Firebase AI Logic امکان دسترسی به میاناهای برنامه‌سازی کاربردی را برای تعامل با مدل‌های Gemini فراهم می‌کند. این کتابخانه به‌عنوان بخشی از کیت توسعه نرم‌افزار Firebase JavaScript برای وب ارائه می‌شود.

1. «کیت توسعه نرم‌افزار Firebase JS» را برای «وب» بااستفاده از npm نصب کنید:

   npm install firebase
   

2. مقداردهی اولیه Firebase در برنامه:

   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

افزایه Firebase AI Logic برای Flutter (firebase_ai) امکان دسترسی به میاناهای برنامه‌سازی کاربردی برای تعامل با مدل‌های Gemini را فراهم می‌کند.

1. از فهرست راهنمای پروژه Flutter، فرمان زیر را برای نصب افزایه‌های Firebase AI Logic و App Check اجرا کنید:

   flutter pub add firebase_ai firebase_app_check
   

2. در فایل lib/main.dart، افزایه‌های Firebase AI Logic و 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. همچنین در فایل lib/main.dart، مطمئن شوید که Firebase را بااستفاده از شیء DefaultFirebaseOptions صادرشده توسط فایل پیکربندی مقداردهی اولیه کرده‌اید:

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

4. برنامه Flutter خود را بازسازی کنید:

   flutter run
   

Unity

1. کیت توسعه نرم‌افزار Firebase Unity را بارگیری کنید، سپس کیت توسعه نرم‌افزار را در جایی مناسب استخراج کنید.

   «کیت توسعه نرم‌افزار» Firebase Unity مختص پلاتفرم نیست.

2. در پروژه Unity باز خود، به دارایی‌ها > وارد کردن بسته > بسته سفارشی پیمایش کنید.

3. از کیت توسعه نرم‌افزار استخراج‌شده، FirebaseAI و FirebaseAppCheck بسته‌ها را انتخاب کنید.

4. در پنجره وارد کردن بسته Unity، روی وارد کردن کلیک کنید.

Swift

در اینجا نحوه استفاده از ارائه‌دهنده اشکال‌زدایی درحین اجرای تعاملی برنامه در شبیه‌ساز (برای مثال، درطول توسعه محلی) آمده است:

1. در پروژه Xcode، FirebaseAppCheck را وارد کنید و App Check را با کارخانه ارائه‌دهنده اشکال‌زدایی قبل‌از پیکربندی 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. نمودار اشکال‌زدایی خود را دریافت کنید:

   1. برنامه‌تان را در شبیه‌ساز یا در دستگاه آزمایشی‌تان راه‌اندازی کنید.

   2. کنسول Xcode را باز کنید و به‌دنبال نشان اشکال‌زدایی App Check بگردید. برای مثال:

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

   3. کد را کپی کنید (برای مثال، 123a4567-b89c-12d3-e456-789012345678).

3. توکن اشکال‌زدایی خود را در App Check ثبت کنید:

   1. در کنسول Firebase، به امنیت > بررسی برنامه > برگه برنامه‌ها بروید.

   2. برنامه‌تان را پیدا کنید، روی منو سرریز (more_vert) کلیک کنید، و سپس مدیریت نشان‌های اشکال‌زدایی را انتخاب کنید.

   3. برای ثبت کردن کد اشکال‌زدایی، دستورالعمل‌های روی صفحه را دنبال کنید.

برای جزئیات مربوط به ارائه‌دهنده اشکال‌زدایی (ازجمله نحوه دریافت کد اشکال‌زدایی جدید)، به اسناد رسمی App Check مراجعه کنید.

Kotlin

نحوه استفاده از ارائه‌دهنده اشکال‌زدایی هنگام اجرای تعاملی برنامه در شبیه‌ساز (برای مثال، درطول توسعه محلی) در اینجا آمده است:

1. در ساخت اشکال‌زدایی، App Check را پیکربندی کنید تا از کارخانه فراهم‌کننده اشکال‌زدایی استفاده کند:

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

2. نمودار اشکال‌زدایی خود را دریافت کنید:

   1. برنامه‌تان را در شبیه‌ساز یا در دستگاه آزمایشی‌تان اجرا کنید.

   2. نشانه اشکال‌زدایی App Check را در گزارش‌هایتان پیدا کنید. برای مثال:

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

   3. کد را کپی کنید (برای مثال، 123a4567-b89c-12d3-e456-789012345678).

3. توکن اشکال‌زدایی خود را در App Check ثبت کنید:

   1. در کنسول Firebase، به امنیت > بررسی برنامه > برگه برنامه‌ها بروید.

   2. برنامه‌تان را پیدا کنید، روی منو سرریز (more_vert) کلیک کنید، و سپس مدیریت نشان‌های اشکال‌زدایی را انتخاب کنید.

   3. برای ثبت کردن کد اشکال‌زدایی، دستورالعمل‌های روی صفحه را دنبال کنید.

برای جزئیات مربوط به ارائه‌دهنده اشکال‌زدایی (ازجمله نحوه دریافت کد اشکال‌زدایی جدید)، به اسناد رسمی App Check مراجعه کنید.

Java

نحوه استفاده از ارائه‌دهنده اشکال‌زدایی هنگام اجرای تعاملی برنامه در شبیه‌ساز (برای مثال، درطول توسعه محلی) در اینجا آمده است:

1. در ساخت اشکال‌زدایی، App Check را پیکربندی کنید تا از کارخانه فراهم‌کننده اشکال‌زدایی استفاده کند:

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

2. نمودار اشکال‌زدایی خود را دریافت کنید:

   1. برنامه‌تان را در شبیه‌ساز یا در دستگاه آزمایشی‌تان اجرا کنید.

   2. نشانه اشکال‌زدایی App Check را در گزارش‌هایتان پیدا کنید. برای مثال:

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

   3. کد را کپی کنید (برای مثال، 123a4567-b89c-12d3-e456-789012345678).

3. توکن اشکال‌زدایی خود را در App Check ثبت کنید:

   1. در کنسول Firebase، به امنیت > بررسی برنامه > برگه برنامه‌ها بروید.

   2. برنامه‌تان را پیدا کنید، روی منو سرریز (more_vert) کلیک کنید، و سپس مدیریت نشان‌های اشکال‌زدایی را انتخاب کنید.

   3. برای ثبت کردن کد اشکال‌زدایی، دستورالعمل‌های روی صفحه را دنبال کنید.

برای جزئیات مربوط به ارائه‌دهنده اشکال‌زدایی (ازجمله نحوه دریافت کد اشکال‌زدایی جدید)، به اسناد رسمی App Check مراجعه کنید.

Web

در اینجا نحوه استفاده از ارائه‌دهنده اشکال‌زدایی درحین اجرای localhost تعاملی برنامه (برای مثال، درطول توسعه محلی) آورده شده است:

1. در ساخت اشکال‌زدایی، قبل‌از مقداردهی اولیه کردن App Check، با تنظیم self.FIREBASE_APPCHECK_DEBUG_TOKEN روی true، حالت اشکال‌زدایی را فعال کنید. برای مثال:

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

2. به‌صورت محلی از برنامه وب خود بازدید کنید و ابزارهای توسعه‌دهنده مرورگر را باز کنید. در کنسول اشکال‌زدایی، یک کد اشکال‌زدایی خواهید دید:

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

3. توکن اشکال‌زدایی خود را در App Check ثبت کنید:

   1. در کنسول Firebase، به امنیت > بررسی برنامه > برگه برنامه‌ها بروید.

   2. برنامه‌تان را پیدا کنید، روی منو سرریز (more_vert) کلیک کنید، و سپس مدیریت نشان‌های اشکال‌زدایی را انتخاب کنید.

   3. برای ثبت کردن کد اشکال‌زدایی، دستورالعمل‌های روی صفحه را دنبال کنید.

برای جزئیات مربوط به ارائه‌دهنده اشکال‌زدایی (ازجمله نحوه دریافت کد اشکال‌زدایی جدید)، به اسناد رسمی App Check مراجعه کنید.

Dart

برای جزئیات مربوط به ارائه‌دهنده اشکال‌زدایی (ازجمله نحوه دریافت کد اشکال‌زدایی جدید)، به اسناد رسمی App Check مراجعه کنید.

Unity

نحوه استفاده از ارائه‌دهنده اشکال‌زدایی هنگام اجرای تعاملی برنامه در شبیه‌ساز (برای مثال، درطول توسعه محلی) در اینجا آمده است:

1. در کنسول Firebase، یک کد اشکال‌زدایی ایجاد کنید:

   1. در کنسول Firebase، به امنیت > بررسی برنامه > برگه برنامه‌ها بروید.

   2. برنامه‌تان را پیدا کنید، روی منو سرریز (more_vert) کلیک کنید، و سپس مدیریت نشان‌های اشکال‌زدایی را انتخاب کنید.

   3. برای ایجاد یک کد اشکال‌زدایی جدید، دستورالعمل‌های روی صفحه را دنبال کنید.

2. در کد مقداردهی اولیه برنامه، موارد زیر را اضافه کنید:

   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
   }
   

برای جزئیات مربوط به ارائه‌دهنده اشکال‌زدایی (ازجمله نحوه دریافت کد اشکال‌زدایی جدید)، به اسناد رسمی 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.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');

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.8-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.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

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

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

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