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

Swift

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

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

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

Kotlin

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

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

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

Java

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

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

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

Web

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

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

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

Dart

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

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

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

Unity

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

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

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

Swift

تجربة تطبيق البدء السريع

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

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

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

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

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

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

Kotlin

تجربة تطبيق Quickstart

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

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

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

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

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

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

Java

تجربة تطبيق البدء السريع

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

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

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

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

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

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

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

Web

تجربة تطبيق Quickstart

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

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

Dart

تجربة تطبيق البدء السريع

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

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

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

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

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

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

Unity

تجربة تطبيق البدء السريع

استخدِم تطبيق البدء السريع لتجربة حزمة تطوير البرامج (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

تتيح حزمة تطوير البرامج (SDK) لـ 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

تتيح حزمة تطوير البرامج (SDK) لـ 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. يتم تضمين المكتبة كجزء من حزمة تطوير البرامج (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.");