با استفاده از SDKهای Logic API Firebase با API شروع کنید

سویفت

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

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

• Xcode 26.2 یا بالاتر
• برنامه شما iOS 15 یا بالاتر یا macOS 12 یا بالاتر را هدف قرار می‌دهد

Kotlin

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

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

• اندروید استودیو (آخرین نسخه)
• برنامه شما سطح API 21 یا بالاتر را هدف قرار می‌دهد.

Java

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

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

• اندروید استودیو (آخرین نسخه)
• برنامه شما سطح API 21 یا بالاتر را هدف قرار می‌دهد.

Web

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

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

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

Dart

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

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

• دارت ۳.۲.۰+

وحدت

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

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

• ویرایشگر یونیتی نسخه 2021 LTS یا جدیدتر

سویفت

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

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

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

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

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

همچنین می‌توانید کدبیس برنامه را که در ویدیو آمده است دانلود و بررسی کنید.

کدبیس برنامه‌ی مربوط به ویدیو را مشاهده کنید

Kotlin

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

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

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

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

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

همچنین می‌توانید کدبیس برنامه را که در ویدیو آمده است دانلود و بررسی کنید.

کدبیس برنامه‌ی مربوط به ویدیو را مشاهده کنید

Java

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

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

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

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

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

همچنین می‌توانید کدبیس برنامه را که در ویدیو آمده است دانلود و بررسی کنید.

کدبیس برنامه‌ی مربوط به ویدیو را مشاهده کنید

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

Web

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

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

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

Dart

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

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

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

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

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

همچنین می‌توانید کدبیس برنامه را که در ویدیو آمده است دانلود و بررسی کنید.

کدبیس برنامه‌ی مربوط به ویدیو را مشاهده کنید

وحدت

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

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

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

سویفت

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

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

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

1. در Xcode، با باز کردن پروژه برنامه خود، به File > Add Package Dependencies بروید.

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

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

3. آخرین نسخه SDK را انتخاب کنید.

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

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

Kotlin

کیت توسعه نرم‌افزاری منطق هوش مصنوعی فایربیس برای اندروید ( firebase-ai ) دسترسی به APIها را برای تعامل با مدل‌های جمینی فراهم می‌کند.

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

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

با استفاده از Firebase Android BoM ، برنامه شما همیشه از نسخه‌های سازگار کتابخانه‌های اندروید 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 ) دسترسی به APIها را برای تعامل با مدل‌های جمینی فراهم می‌کند.

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

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

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

با استفاده از Firebase Android BoM ، برنامه شما همیشه از نسخه‌های سازگار کتابخانه‌های اندروید 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

کتابخانه Firebase AI Logic دسترسی به APIها را برای تعامل با مدل‌های Gemini فراهم می‌کند. این کتابخانه به عنوان بخشی از Firebase JavaScript SDK for Web گنجانده شده است.

1. نصب Firebase JS SDK برای وب با استفاده از npm:

   npm install firebase
   

2. مقداردهی اولیه فایربیس در برنامه شما:

   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 ) دسترسی به APIها را برای تعامل با مدل‌های 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
   

وحدت

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

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

2. در پروژه باز Unity خود، به مسیر Assets > Import Package > Custom Package بروید.

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

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

سویفت

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

1. در پروژه Xcode خود، FirebaseAppCheck را وارد کنید و قبل از پیکربندی Firebase App Check با debug provider factory مقداردهی اولیه کنید.

   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 ، به تب Security > App Check > Apps بروید.

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

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

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

Kotlin

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

1. در نسخه اشکال‌زدایی (debug build)، App Check طوری پیکربندی کنید که از debug provider factory استفاده کند:

   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 ، به تب Security > App Check > Apps بروید.

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

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

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

Java

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

1. در نسخه اشکال‌زدایی (debug build)، App Check طوری پیکربندی کنید که از debug provider factory استفاده کند:

   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 ، به تب Security > App Check > Apps بروید.

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

   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 ، به تب Security > App Check > Apps بروید.

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

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

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

Dart

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

وحدت

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

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

   1. در کنسول Firebase ، به تب Security > App Check > Apps بروید.

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

   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 مراجعه کنید.

سویفت

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

وحدت

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

سویفت

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

وحدت

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