The latest Gemini models, like Gemini 3.1 Flash Image (Nano Banana 2), are available to use with Firebase AI Logic! Learn more.

Gemini 2.0 Flash and Flash-Lite models will shut down on June 1, 2026. To avoid service disruption, update to a newer model like gemini-2.5-flash-lite. Learn more.

All Imagen models will shut down on June 24, 2026. Learn about migrating your apps to use Nano Banana.

‫Gemini API باستخدام Firebase AI Logic

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

يضع Firebase AI Logic في متناولك أحدث نماذج الذكاء الاصطناعي التوليدي من Google، وهي نماذج Gemini.

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

تتوفّر حِزم تطوير البرامج (SDK) من جهة العميل هذه في Swift لمنصات Apple وKotlin وJava لنظام Android وJavaScript للويب وDart لـ Flutter وUnity.

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

البدء

الإمكانات الرئيسية

الإدخال المتعدّد الوسائط واللغة الطبيعية	Gemini هي نماذج متعددة الوسائط، لذا يمكن أن تتضمّن الطلبات التي يتم إرسالها إلى Gemini API نصوصًا وصورًا وملفات PDF وفيديوهات ومقاطع صوتية. يمكن لبعض نماذج Gemini أيضًا إنشاء نتائج متعدّدة الوسائط. يمكن توجيه الطلبات إلى نماذج Gemini باستخدام اللغة الطبيعية.
مجموعة متزايدة من الإمكانات	باستخدام حِزم SDK، يمكنك طلب Gemini API مباشرةً من تطبيقك على الأجهزة الجوّالة أو تطبيق الويب من أجل إنشاء تجارب محادثة مستندة إلى الذكاء الاصطناعي وإنشاء صور واستخدام أدوات (مثل استدعاء الدوال وتحديد المصدر من خلال "بحث Search") وبث الإدخال والإخراج المتعدّد الوسائط (بما في ذلك الصوت) وغير ذلك.
الأمان ومنع إساءة الاستخدام في تطبيقات الإنتاج	استخدِم Firebase App Check للمساعدة في حماية واجهات برمجة التطبيقات التي تصل إلى نماذج Gemini من إساءة الاستخدام من قِبل العملاء غير المصرّح لهم. تتضمّن Firebase AI Logic أيضًا حدودًا للطلبات لكل مستخدم تلقائيًا، ويمكن ضبط هذه الحدود بالكامل.
بنية تحتية قوية	يمكنك الاستفادة من بنية أساسية قابلة للتوسيع ومصمَّمة للاستخدام مع تطبيقات الأجهزة الجوّالة والويب، مثل إدارة الملفات باستخدام Cloud Storage for Firebase، وإدارة البيانات المنظَّمة باستخدام عروض قاعدة بيانات Firebase (مثل Cloud Firestore)، وتحديد إعدادات وقت التشغيل بشكل ديناميكي باستخدام Firebase Remote Config.

كيف تعمل هذه الميزة؟

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

دعم نماذج Google ومقدّمي خدمة "Gemini API"

تتوافق الخدمة مع جميع أحدث طُرز Gemini، ويمكنك اختيار مقدّم خدمة "Gemini API" المفضّل لديك للوصول إلى هذه الطُرز. نسمح باستخدام كل من Gemini Developer API وVertex AI Gemini API. تعرَّف على الاختلافات بين استخدام مزوّدَي واجهات برمجة التطبيقات.

وإذا اخترت استخدام Gemini Developer API، يمكنك الاستفادة من "المستوى المجاني" لتتمكّن من البدء والتشغيل بسرعة.

حِزم تطوير البرامج (SDK) الخاصة بالعملاء على الأجهزة الجوّالة والويب

يمكنك إرسال الطلبات إلى النماذج مباشرةً من تطبيقك على الأجهزة الجوّالة أو تطبيق الويب باستخدام حِزم تطوير البرامج (SDK) الخاصة بالعملاء، وهي متاحة بلغات Swift لمنصات Apple وKotlin وJava لنظام Android وJavaScript للويب وDart لـ Flutter وUnity.Firebase AI Logic

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

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

خدمة الخادم الوكيل

تعمل خدمة الوكيل كبوابة بين العميل ومقدّم خدمة Gemini API الذي اخترته (ونماذج Google). ويوفّر خدمات وعمليات دمج مهمة للتطبيقات على الأجهزة الجوّالة وتطبيقات الويب. على سبيل المثال، يمكنك إعداد Firebase App Check للمساعدة في حماية مقدّم خدمة واجهة برمجة التطبيقات الذي اخترته وموارد الخلفية من إساءة الاستخدام من قِبل العملاء غير المصرّح لهم.

ويكون ذلك مهمًا بشكل خاص إذا اخترت استخدام Gemini Developer API، لأنّ خدمة الوكيل وعملية الدمج App Check تضمنان بقاء مفتاح واجهة برمجة التطبيقات Gemini على الخادم وعدم تضمينه في قاعدة رموز تطبيقاتك.

مسار التنفيذ

	إعداد مشروع Firebase وربط تطبيقك بـ Firebase	استخدِم سير العمل الموجَّه في صفحة Firebase AI Logic في وحدة تحكّم Firebase لإعداد مشروعك (بما في ذلك تفعيل واجهات برمجة التطبيقات المطلوبة لموفّر Gemini API الذي اخترته)، وتسجيل تطبيقك في مشروعك على Firebase، ثم إضافة إعدادات Firebase إلى تطبيقك.
	تثبيت حزمة تطوير البرامج (SDK) وإعدادها	ثبِّت حزمة تطوير البرامج (SDK) Firebase AI Logic الخاصة بمنصة تطبيقك، ثم ابدأ الخدمة وأنشئ نموذجًا في تطبيقك.
	إرسال طلبات إلى نماذج Gemini	استخدِم حِزم SDK لإرسال طلبات تتضمّن نصًا فقط أو طلبات متعددة الوسائط إلى نموذج Gemini لإنشاء نصوص ورموز برمجية ونتائج منظَّمة (مثل JSON) وصور. يمكنك إنشاء تجارب أكثر تفاعلية باستخدام المحادثات المتعددة الأدوار والبث الثنائي الاتجاه (بما في ذلك الصوت) واستدعاء الدوال البرمجية.
	الاستعداد لإصدار التطبيق	يمكنك تنفيذ عمليات دمج مهمة لتطبيقات الأجهزة الجوّالة وتطبيقات الويب، مثل حماية واجهة برمجة التطبيقات من إساءة الاستخدام باستخدام Firebase App Check واستخدام Firebase Remote Config لتعديل المَعلمات في الرمز البرمجي عن بُعد (الأهم من ذلك، اسم النموذج).

الخطوات التالية

بدء الوصول إلى نموذج من تطبيقك على الأجهزة الجوّالة أو تطبيق الويب

الانتقال إلى دليل البدء

مزيد من المعلومات عن النماذج المتاحة

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