بدء استخدام Gemini API باستخدام حِزم تطوير البرامج (SDK) الخاصة بمنطق الذكاء الاصطناعي من Firebase

Swift

يفترض هذا الدليل أنّك على دراية باستخدام Xcode لتطوير تطبيقات لمنصات Apple (مثل iOS).

تأكَّد من أنّ بيئة التطوير وتطبيق منصات Apple يستوفيان المتطلبات التالية:

• الإصدار 26.2 من Xcode أو إصدار أحدث
• يستهدف تطبيقك الإصدار iOS 15 أو إصدارًا أحدث، أو الإصدار macOS 12 أو إصدارًا أحدث

Kotlin

يفترض هذا الدليل أنّك على دراية بكيفية استخدام "استوديو Android" لتطوير تطبيقات Android.

يجب التأكّد من أنّ بيئة التطوير وتطبيق Android يستوفيان المتطلبات التالية:

• "استوديو Android" (أحدث إصدار)
• يستهدف تطبيقك المستوى 24 من واجهة برمجة التطبيقات (نظام التشغيل Android Nougat) أو المستويات الأحدث

Java

يفترض هذا الدليل أنّك على دراية بكيفية استخدام "استوديو Android" لتطوير تطبيقات Android.

يجب التأكّد من أنّ بيئة التطوير وتطبيق Android يستوفيان المتطلبات التالية:

• "استوديو Android" (أحدث إصدار)
• يستهدف تطبيقك المستوى 24 من واجهة برمجة التطبيقات (نظام التشغيل Android Nougat) أو المستويات الأحدث

Web

يفترض هذا الدليل أنّك على دراية باستخدام JavaScript لتطوير تطبيقات الويب. هذا الدليل مستقل عن أي إطار عمل.

تأكَّد من أنّ بيئة التطوير وتطبيق الويب يستوفيان المتطلبات التالية:

• (اختياري) Node.js
• متصفّح ويب حديث

Dart

يفترض هذا الدليل أنّك على دراية بتطوير التطبيقات باستخدام Flutter.

تأكَّد من أنّ بيئة التطوير وتطبيق Flutter يستوفيان المتطلبات التالية:

• ‫Dart 3.2.0 أو إصدار أحدث

Unity

يفترض هذا الدليل أنّك على دراية بتطوير الألعاب باستخدام Unity.

تأكَّد من أنّ بيئة التطوير ولعبة Unity تستوفيان المتطلبات التالية:

• الإصدار 2021 من Unity Editor أو أحدث

Swift

تجربة تطبيق Quickstart

استخدِم تطبيق التشغيل السريع لتجربة حزمة SDK بسرعة والاطّلاع على عملية تنفيذ كاملة لمختلف حالات الاستخدام. يمكنك أيضًا استخدام تطبيق Quickstart إذا لم يكن لديك تطبيق خاص بمنصات Apple. لاستخدام تطبيق Quickstart، عليك ربطه بمشروع Firebase.

الانتقال إلى تطبيق البدء السريع

مشاهدة فيديو تعليمي

يوضّح هذا الفيديو كيفية بدء استخدام Firebase AI Logic من خلال إنشاء تطبيق واقعي لتخطيط الوجبات يستند إلى الذكاء الاصطناعي وينشئ وصفات من طلب نصي.

يمكنك أيضًا تنزيل قاعدة الرموز البرمجية للتطبيق في الفيديو واستكشافها.

عرض قاعدة الرموز البرمجية لتطبيق الفيديو

Kotlin

تجربة تطبيق Quickstart

استخدِم تطبيق التشغيل السريع لتجربة حزمة SDK بسرعة والاطّلاع على عملية تنفيذ كاملة لمختلف حالات الاستخدام. يمكنك أيضًا استخدام تطبيق التشغيل السريع إذا لم يكن لديك تطبيق Android خاص بك. لاستخدام تطبيق التشغيل السريع، عليك ربطه بمشروع Firebase.

الانتقال إلى تطبيق البدء السريع

مشاهدة فيديو تعليمي

يوضّح هذا الفيديو كيفية بدء استخدام Firebase AI Logic من خلال إنشاء تطبيق واقعي لتخطيط الوجبات يستند إلى الذكاء الاصطناعي وينشئ وصفات من طلب نصي.

يمكنك أيضًا تنزيل قاعدة الرموز البرمجية للتطبيق في الفيديو واستكشافها.

عرض قاعدة الرموز البرمجية لتطبيق الفيديو

Java

تجربة تطبيق Quickstart

استخدِم تطبيق التشغيل السريع لتجربة حزمة SDK بسرعة والاطّلاع على عملية تنفيذ كاملة لمختلف حالات الاستخدام. يمكنك أيضًا استخدام تطبيق التشغيل السريع إذا لم يكن لديك تطبيق Android خاص بك. لاستخدام تطبيق التشغيل السريع، عليك ربطه بمشروع Firebase.

الانتقال إلى تطبيق البدء السريع

مشاهدة فيديو تعليمي

يوضّح هذا الفيديو كيفية البدء باستخدام Firebase AI Logic من خلال إنشاء تطبيق حقيقي لتخطيط الوجبات يستند إلى الذكاء الاصطناعي وينشئ وصفات من طلب نصي.^*

يمكنك أيضًا تنزيل قاعدة الرموز البرمجية للتطبيق في الفيديو واستكشافها.

عرض قاعدة الرموز البرمجية لتطبيق الفيديو

^{* هذا الفيديو والتطبيق المعنيّان مكتوبان بلغة Kotlin، ولكن يمكنهما مع ذلك مساعدة مطوّري Java في فهم الأساسيات حول كيفية بدء استخدام Firebase AI Logic.}

Web

تجربة تطبيق Quickstart

استخدِم تطبيق التشغيل السريع لتجربة حزمة SDK بسرعة والاطّلاع على عملية تنفيذ كاملة لمختلف حالات الاستخدام. يمكنك أيضًا استخدام تطبيق التشغيل السريع إذا لم يكن لديك تطبيق ويب. لاستخدام تطبيق التشغيل السريع، عليك ربطه بمشروع Firebase.

الانتقال إلى تطبيق البدء السريع

Dart

تجربة تطبيق Quickstart

استخدِم تطبيق التشغيل السريع لتجربة حزمة SDK بسرعة والاطّلاع على عملية تنفيذ كاملة لمختلف حالات الاستخدام. يمكنك أيضًا استخدام تطبيق البدء السريع إذا لم يكن لديك تطبيق Flutter. لاستخدام تطبيق البدء السريع، عليك ربطه بمشروع Firebase.

الانتقال إلى تطبيق البدء السريع

مشاهدة فيديو تعليمي

يوضّح هذا الفيديو كيفية بدء استخدام Firebase AI Logic من خلال إنشاء تطبيق واقعي لتخطيط الوجبات يستند إلى الذكاء الاصطناعي وينشئ وصفات من طلب نصي.

يمكنك أيضًا تنزيل قاعدة الرموز البرمجية للتطبيق في الفيديو واستكشافها.

عرض قاعدة الرموز البرمجية لتطبيق الفيديو

Unity

تجربة تطبيق Quickstart

استخدِم تطبيق التشغيل السريع لتجربة حزمة SDK بسرعة والاطّلاع على عملية تنفيذ كاملة لمختلف حالات الاستخدام. أو يمكنك استخدام تطبيق Quickstart إذا لم تكن لديك لعبة Unity. لاستخدام تطبيق التشغيل السريع، عليك ربطه بمشروع Firebase.

الانتقال إلى تطبيق البدء السريع

Swift

استخدِم أداة Swift Package Manager لتثبيت الملحقات المطلوبة في Firebase وإدارتها. يمكنك الاطّلاع على خيارات التثبيت الأخرى إذا لزم الأمر.

تتيح مكتبة Firebase AI Logic الوصول إلى واجهات برمجة التطبيقات للتفاعل مع نماذج Gemini. يتم تضمين المكتبة كجزء من حزمة تطوير البرامج (SDK) لمنصة Firebase على أجهزة Apple (firebase-ios-sdk).

إذا كنت تستخدم Firebase حاليًا، تأكَّد من أنّ حزمة Firebase هي الإصدار 12.5.0 أو إصدار أحدث.

1. في Xcode، بعد فتح مشروع تطبيقك، انتقِل إلى ملف > إضافة موارد الاعتمادية للحزمة (File > Add Package Dependencies).

2. عندما يُطلب منك ذلك، أضِف مستودع حزمة تطوير البرامج (SDK) لمنصات Apple على Firebase:

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

3. اختَر أحدث إصدار من حزمة تطوير البرامج (SDK).

4. انقر على مكتبة FirebaseAILogic ومكتبة FirebaseAppCheck.

عند الانتهاء، سيبدأ Xcode تلقائيًا في حلّ التبعيات وتنزيلها في الخلفية.

Kotlin

توفّر حزمة Firebase AI Logic تطوير البرامج (SDK) لنظام التشغيل 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 تطوير البرامج (SDK) لنظام التشغيل 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. يتم تضمين المكتبة كجزء من حزمة تطوير البرامج (SDK) لخدمة Firebase JavaScript على الويب.

1. ثبِّت حزمة تطوير البرامج (SDK) من Firebase لتطبيقات الويب باستخدام 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. نزِّل حزمة تطوير البرامج (SDK) Firebase Unity، ثم استخرِجها في مكان مناسب.

   حزمة تطوير البرامج (SDK) Firebase Unity ليست خاصة بنظام أساسي معيّن.

2. في مشروع Unity المفتوح، انتقِل إلى Assets (الأصول) > Import Package (استيراد حزمة) > Custom Package (حزمة مخصّصة).

3. من حزمة SDK التي تم استخراجها، اختَر الحزمتَين 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. في إصدار مخصص لتصحيح الأخطاء، فعِّل وضع تصحيح الأخطاء من خلال ضبط 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.");