شروع به کار با 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 2022 LTS (2022.3)‎ یا جدیدتر

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 Package Manager برای نصب و مدیریت وابستگی‌های 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.2"))

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

  // 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 برای وب گنجانده شده است.

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 SDK را بارگیری کنید، سپس SDK را در جایی مناسب از حالت فشرده خارج کنید.

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

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

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

4. در پنجره Import Unity Package، روی Import کلیک کنید.

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. در ساخت اشکال‌زدایی، حالت اشکال‌زدایی را با تنظیم self.FIREBASE_APPCHECK_DEBUG_TOKEN روی true قبل‌از مقداردهی اولیه App Check فعال کنید. برای مثال:

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