इस गाइड में, अपने चुने गए प्लैटफ़ॉर्म के लिए Firebase AI Logic क्लाइंट एसडीके का इस्तेमाल करके, सीधे अपने ऐप्लिकेशन से Gemini API को कॉल करने का तरीका बताया गया है.
ज़रूरी शर्तें
Swift
इस गाइड में यह माना गया है कि आपको iOS जैसे Apple प्लैटफ़ॉर्म के लिए ऐप्लिकेशन डेवलप करने के लिए, Xcode का इस्तेमाल करने के बारे में जानकारी है.
पक्का करें कि आपका डेवलपमेंट एनवायरमेंट और Apple प्लैटफ़ॉर्म ऐप्लिकेशन, इन ज़रूरी शर्तों को पूरा करता हो:
- Xcode 26.2 या इसके बाद का वर्शन
- आपका ऐप्लिकेशन iOS 15 या इसके बाद के वर्शन या macOS 12 या इसके बाद के वर्शन को टारगेट करता हो
Kotlin
इस गाइड में यह माना गया है कि आपको Android के लिए ऐप्लिकेशन डेवलप करने के लिए, Android Studio का इस्तेमाल करने के बारे में जानकारी है.
पक्का करें कि आपका डेवलपमेंट एनवायरमेंट और Android ऐप्लिकेशन, इन ज़रूरी शर्तों को पूरा करते हों:
- Android Studio (नया वर्शन)
- आपका ऐप्लिकेशन, एपीआई लेवल 24 (Nougat) या इसके बाद के वर्शन को टारगेट करता हो
Java
इस गाइड में यह माना गया है कि आपको Android के लिए ऐप्लिकेशन डेवलप करने के लिए, Android Studio का इस्तेमाल करने के बारे में जानकारी है.
पक्का करें कि आपका डेवलपमेंट एनवायरमेंट और Android ऐप्लिकेशन, इन ज़रूरी शर्तों को पूरा करते हों:
- Android Studio (नया वर्शन)
- आपका ऐप्लिकेशन, एपीआई लेवल 24 (Nougat) या इसके बाद के वर्शन को टारगेट करता हो
Web
इस गाइड में यह माना गया है कि आपको वेब ऐप्लिकेशन डेवलप करने के लिए, JavaScript का इस्तेमाल करने के बारे में जानकारी है. यह गाइड किसी फ़्रेमवर्क पर निर्भर नहीं है.
पक्का करें कि आपका डेवलपमेंट एनवायरमेंट और वेब ऐप्लिकेशन इन ज़रूरी शर्तों को पूरा करते हों:
- (ज़रूरी नहीं है) Node.js
- मॉडर्न वेब ब्राउज़र
Dart
यह गाइड इस बात को ध्यान में रखकर बनाई गई है कि आपको Flutter की मदद से ऐप्लिकेशन डेवलप करने के बारे में जानकारी है.
पक्का करें कि आपका डेवलपमेंट एनवायरमेंट और Flutter ऐप्लिकेशन, इन ज़रूरी शर्तों को पूरा करता हो:
- Dart 3.2.0+
Unity
यह गाइड इस बात को ध्यान में रखकर बनाई गई है कि आपको Unity की मदद से गेम डेवलप करने के बारे में जानकारी है.
पक्का करें कि आपका डेवलपमेंट एनवायरमेंट और Unity गेम, इन ज़रूरी शर्तों को पूरा करते हों:
- Unity Editor 2022 LTS (2022.3) या इसके बाद का वर्शन
मददगार संसाधन देखें
Swift
क्विकस्टार्ट ऐप्लिकेशन आज़माना
SDK टूल को तुरंत आज़माने और इस्तेमाल के अलग-अलग उदाहरणों को पूरी तरह से लागू करने के लिए, क्विकस्टार्ट ऐप्लिकेशन का इस्तेमाल करें. अगर आपके पास Apple प्लैटफ़ॉर्म के लिए अपना ऐप्लिकेशन नहीं है, तो क्विकस्टार्ट ऐप्लिकेशन का इस्तेमाल करें. क्विकस्टार्ट ऐप्लिकेशन का इस्तेमाल करने के लिए, आपको इसे किसी Firebase प्रोजेक्ट से कनेक्ट करना होगा.
क्विकस्टार्ट ऐप्लिकेशन पर जाना
वीडियो ट्यूटोरियल देखना
इस वीडियो में, Firebase AI Logic का इस्तेमाल शुरू करने का तरीका बताया गया है. इसके लिए, एआई की मदद से काम करने वाला एक ऐसा ऐप्लिकेशन बनाया गया है जो असल दुनिया में डाइट प्लान बनाने में मदद करता है. यह ऐप्लिकेशन, टेक्स्ट प्रॉम्प्ट से रेसिपी जनरेट करता है.
वीडियो में दिखाए गए ऐप्लिकेशन के कोड बेस को डाउनलोड करके, उसे एक्सप्लोर भी किया जा सकता है.
वीडियो में दिखाए गए ऐप्लिकेशन का कोड बेस देखना
Kotlin
क्विकस्टार्ट ऐप्लिकेशन आज़माना
SDK टूल को तुरंत आज़माने और इस्तेमाल के अलग-अलग उदाहरणों को पूरी तरह से लागू करने के लिए, क्विकस्टार्ट ऐप्लिकेशन का इस्तेमाल करें. अगर आपके पास अपना Android ऐप्लिकेशन नहीं है, तो क्विकस्टार्ट ऐप्लिकेशन का इस्तेमाल करें. क्विकस्टार्ट ऐप्लिकेशन का इस्तेमाल करने के लिए, आपको उसे Firebase प्रोजेक्ट से कनेक्ट करना होगा.
क्विकस्टार्ट ऐप्लिकेशन पर जाना
वीडियो ट्यूटोरियल देखना
इस वीडियो में, Firebase AI Logic का इस्तेमाल शुरू करने का तरीका बताया गया है. इसके लिए, एआई की मदद से काम करने वाला एक ऐसा ऐप्लिकेशन बनाया गया है जो असल दुनिया में डाइट प्लान बनाने में मदद करता है. यह ऐप्लिकेशन, टेक्स्ट प्रॉम्प्ट से रेसिपी जनरेट करता है.
वीडियो में दिखाए गए ऐप्लिकेशन के कोड बेस को डाउनलोड करके, उसे एक्सप्लोर भी किया जा सकता है.
वीडियो में दिखाए गए ऐप्लिकेशन का कोड बेस देखना
Java
क्विकस्टार्ट ऐप्लिकेशन आज़माना
SDK टूल को तुरंत आज़माने और इस्तेमाल के अलग-अलग उदाहरणों को पूरी तरह से लागू करने के लिए, क्विकस्टार्ट ऐप्लिकेशन का इस्तेमाल करें. अगर आपके पास अपना Android ऐप्लिकेशन नहीं है, तो क्विकस्टार्ट ऐप्लिकेशन का इस्तेमाल करें. क्विकस्टार्ट ऐप्लिकेशन का इस्तेमाल करने के लिए, आपको उसे Firebase प्रोजेक्ट से कनेक्ट करना होगा.
क्विकस्टार्ट ऐप्लिकेशन पर जाना
वीडियो ट्यूटोरियल देखना
इस वीडियो में, Firebase AI Logic का इस्तेमाल शुरू करने का तरीका बताया गया है. इसके लिए, एआई की मदद से काम करने वाला एक ऐसा ऐप्लिकेशन बनाया गया है जो असल दुनिया में डाइट प्लान करने में मदद करता है. यह ऐप्लिकेशन, टेक्स्ट प्रॉम्प्ट से रेसिपी जनरेट करता है.*
वीडियो में दिखाए गए ऐप्लिकेशन के कोड बेस को डाउनलोड करके, उसे एक्सप्लोर भी किया जा सकता है.
वीडियो में दिखाए गए ऐप्लिकेशन का कोड बेस देखना
* यह वीडियो और इसमें मौजूद ऐप्लिकेशन Kotlin में है. हालांकि, इससे Java डेवलपर को Firebase AI Logic का इस्तेमाल शुरू करने के बारे में बुनियादी जानकारी मिल सकती है.
Web
क्विकस्टार्ट ऐप्लिकेशन आज़माना
SDK टूल को तुरंत आज़माने और इस्तेमाल के अलग-अलग उदाहरणों को पूरी तरह से लागू करने के लिए, क्विकस्टार्ट ऐप्लिकेशन का इस्तेमाल करें. अगर आपके पास अपना वेब ऐप्लिकेशन नहीं है, तो क्विकस्टार्ट ऐप्लिकेशन का इस्तेमाल करें. क्विकस्टार्ट ऐप्लिकेशन का इस्तेमाल करने के लिए, आपको इसे किसी Firebase प्रोजेक्ट से कनेक्ट करना होगा.
Dart
क्विकस्टार्ट ऐप्लिकेशन आज़माना
SDK टूल को तुरंत आज़माने और इस्तेमाल के अलग-अलग उदाहरणों को पूरी तरह से लागू करने के लिए, क्विकस्टार्ट ऐप्लिकेशन का इस्तेमाल करें. अगर आपके पास खुद का Flutter ऐप्लिकेशन नहीं है, तो क्विकस्टार्ट ऐप्लिकेशन का इस्तेमाल करें. क्विकस्टार्ट ऐप्लिकेशन का इस्तेमाल करने के लिए, आपको इसे किसी Firebase प्रोजेक्ट से कनेक्ट करना होगा.
क्विकस्टार्ट ऐप्लिकेशन पर जाना
वीडियो ट्यूटोरियल देखना
इस वीडियो में, Firebase AI Logic का इस्तेमाल शुरू करने का तरीका बताया गया है. इसके लिए, एआई की मदद से काम करने वाला एक ऐसा ऐप्लिकेशन बनाया गया है जो असल दुनिया में डाइट प्लान बनाने में मदद करता है. यह ऐप्लिकेशन, टेक्स्ट प्रॉम्प्ट से रेसिपी जनरेट करता है.
वीडियो में दिखाए गए ऐप्लिकेशन के कोड बेस को डाउनलोड करके, उसे एक्सप्लोर भी किया जा सकता है.
वीडियो में दिखाए गए ऐप्लिकेशन का कोड बेस देखना
Unity
क्विकस्टार्ट ऐप्लिकेशन आज़माना
SDK टूल को तुरंत आज़माने और इस्तेमाल के अलग-अलग उदाहरणों को पूरी तरह से लागू करने के लिए, क्विकस्टार्ट ऐप्लिकेशन का इस्तेमाल करें. अगर आपके पास Unity गेम नहीं है, तो क्विकस्टार्ट ऐप्लिकेशन का इस्तेमाल करें. क्विकस्टार्ट ऐप्लिकेशन का इस्तेमाल करने के लिए, आपको इसे किसी Firebase प्रोजेक्ट से कनेक्ट करना होगा.
पहला चरण: Firebase प्रोजेक्ट सेट अप करना और एपीआई चालू करना
Firebase कंसोल में साइन इन करें. इसके बाद, अपना Firebase प्रोजेक्ट चुनें.
Firebase कंसोल में, एआई सेवाएं > एआई लॉजिक पर जाएं.
निर्देशों के साथ काम करने वाला वर्कफ़्लो लॉन्च करने के लिए, शुरू करें पर क्लिक करें. इससे आपको अपने प्रोजेक्ट के लिए, ज़रूरी एपीआई और संसाधन सेट अप करने में मदद मिलेगी.
अगर कहा जाए, तो अपने ऐप्लिकेशन को रजिस्टर करने और उसमें Firebase कॉन्फ़िगरेशन जोड़ने के लिए, स्क्रीन पर दिए गए निर्देशों का पालन करें.
"Gemini API की सेवा देने वाली कंपनी" चुनने के लिए कहे जाने पर, हमारा सुझाव है कि आप Gemini Developer API को चुनें. इससे आपको बिना किसी शुल्क के तुरंत शुरुआत करने में मदद मिलती है.
आपके पास बाद में किसी भी समय, Agent Platform Gemini API (formerly Vertex AI) को सेट अप करने का विकल्प होता है. साथ ही, बिलिंग के लिए ज़रूरी जानकारी भी जोड़ी जा सकती है.
Firebase AI Logic के लिए ज़रूरी एपीआई और उनसे जुड़ी सेवाएं सेट अप करने के लिए, वर्कफ़्लो में आगे बढ़ें.
जुलाई 2026 की शुरुआत से, वर्कफ़्लो का यह चरण AI Logic के लिए Firebase App Check को अपने-आप लागू कर देता है. यह एक ज़रूरी सेवा है, जो आपके ऐप्लिकेशन से सीधे ऐक्सेस किए जाने पर Gemini API को सुरक्षित रखने में मदद करती है. शुरू करने के लिए (इस गाइड में बाद में दिए गए चरण देखें), आपको लोकल डेवलपमेंट के लिए App Check डीबग प्रोवाइडर को कॉन्फ़िगर करना होगा. ऐसा तब करना होगा, जब App Check को लागू किया जाएगा.
अपने ऐप्लिकेशन में ज़रूरी एसडीके जोड़ने के लिए, इस गाइड में दिए गए अगले चरण पर जाएं.
दूसरा चरण: ज़रूरी एसडीके जोड़ना
Firebase प्रोजेक्ट सेट अप करने और ज़रूरी एपीआई चालू करने के बाद, अपने ऐप्लिकेशन में ज़रूरी SDK टूल जोड़े जा सकते हैं. इसके लिए, पिछला चरण देखें.
Swift
Firebase डिपेंडेंसी इंस्टॉल और मैनेज करने के लिए, Swift Package Manager का इस्तेमाल करें. ज़रूरत पड़ने पर, इंस्टॉल करने के अन्य विकल्पों के बारे में जानें.
Firebase AI Logic लाइब्रेरी, Gemini मॉडल के साथ इंटरैक्ट करने के लिए एपीआई का ऐक्सेस देती है. यह लाइब्रेरी, Apple प्लैटफ़ॉर्म के लिए Firebase SDK टूल (firebase-ios-sdk) के हिस्से के तौर पर शामिल है.
अगर पहले से Firebase का इस्तेमाल किया जा रहा है, तो पक्का करें कि आपके Firebase पैकेज का वर्शन 12.5.0 या इसके बाद का हो.
Xcode में, अपना ऐप्लिकेशन प्रोजेक्ट खोलें. इसके बाद, File > Add Package Dependencies पर जाएं.
प्रॉम्प्ट मिलने पर, Firebase Apple प्लैटफ़ॉर्म SDK टूल की रिपॉज़िटरी जोड़ें:
https://github.com/firebase/firebase-ios-sdkएसडीके का सबसे नया वर्शन चुनें.
FirebaseAILogicलाइब्रेरी औरFirebaseAppCheckलाइब्रेरी को चुनें.
इसके बाद, Xcode आपके पैकेज की डिपेंडेंसी से जुड़ी समस्या को हल करना शुरू कर देगा और उन्हें बैकग्राउंड में डाउनलोड करेगा.
Kotlin
Firebase AI Logic SDK for Android (firebase-ai) की मदद से, Gemini मॉडल के साथ इंटरैक्ट करने के लिए एपीआई ऐक्सेस किए जा सकते हैं.
अपनी मॉड्यूल (ऐप्लिकेशन-लेवल) की Gradle फ़ाइल (जैसे, <project>/<app-module>/build.gradle.kts) में, Android के लिए 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: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 लाइब्रेरी के साथ काम करने वाले वर्शन का इस्तेमाल करेगा.
Java
Firebase AI Logic SDK for Android (firebase-ai) की मदद से, Gemini मॉडल के साथ इंटरैक्ट करने के लिए एपीआई ऐक्सेस किए जा सकते हैं.
अपनी मॉड्यूल (ऐप्लिकेशन-लेवल) की Gradle फ़ाइल (जैसे, <project>/<app-module>/build.gradle.kts) में, Android के लिए Firebase AI Logic और App Check लाइब्रेरी की डिपेंडेंसी जोड़ें. हमारा सुझाव है कि लाइब्रेरी के वर्शन को कंट्रोल करने के लिए,
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 लाइब्रेरी के साथ काम करने वाले वर्शन का इस्तेमाल करेगा.
Web
Firebase AI Logic लाइब्रेरी, Gemini मॉडल के साथ इंटरैक्ट करने के लिए एपीआई का ऐक्सेस देती है. यह लाइब्रेरी, वेब के लिए Firebase JavaScript SDK टूल के हिस्से के तौर पर शामिल है.
npm का इस्तेमाल करके, वेब के लिए Firebase JS SDK टूल इंस्टॉल करें:
npm install firebaseअपने ऐप्लिकेशन में 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
Flutter (firebase_ai) के लिए Firebase AI Logic प्लग इन, Gemini मॉडल के साथ इंटरैक्ट करने के लिए एपीआई का ऐक्सेस देता है.
Firebase AI Logic और App Check प्लग इन इंस्टॉल करने के लिए, अपनी Flutter प्रोजेक्ट डायरेक्ट्री से यह कमांड चलाएं:
flutter pub add firebase_ai firebase_app_checkअपनी
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';साथ ही, अपनी
lib/main.dartफ़ाइल में, पक्का करें कि आपने कॉन्फ़िगरेशन फ़ाइल से एक्सपोर्ट किए गएDefaultFirebaseOptionsऑब्जेक्ट का इस्तेमाल करके, Firebase को शुरू किया हो:await Firebase.initializeApp( options: DefaultFirebaseOptions.currentPlatform, );अपने Flutter ऐप्लिकेशन को फिर से बनाएं:
flutter run
Unity
Firebase Unity SDK डाउनलोड करें. इसके बाद, SDK टूल को किसी सुविधाजनक जगह पर एक्सट्रैक्ट करें.
Firebase Unity SDK टूल, किसी खास प्लैटफ़ॉर्म के लिए नहीं है.
अपने खुले हुए Unity प्रोजेक्ट में, Assets > Import Package > Custom Package पर जाएं.
एक्सट्रैक्ट किए गए SDK टूल से,
FirebaseAIऔरFirebaseAppCheckपैकेज चुनें.Import Unity Package विंडो में, Import पर क्लिक करें.
तीसरा चरण: लोकल डेवलपमेंट के लिए, App Check डीबग प्रोवाइडर को कॉन्फ़िगर करना
जुलाई 2026 की शुरुआत से, Firebase कंसोल में सेटअप करने के लिए दिए गए निर्देशों के दौरान, Firebase Firebase AI Logic के लिए Firebase App Check को अपने-आप लागू कर देता है. इससे Gemini API को सुरक्षित रखने में मदद मिलती है.
लोकल डेवलपमेंट के लिए, App Check डीबग प्रोवाइडर को सेट अप किया जा सकता है. साथ ही, Firebase AI Logic के लिए App Check को लागू रखा जा सकता है.
Swift
सिम्युलेटर में ऐप्लिकेशन को इंटरैक्टिव तरीके से चलाने के दौरान, डीबग प्रोवाइडर का इस्तेमाल करने का तरीका यहां बताया गया है. उदाहरण के लिए, लोकल डेवलपमेंट के दौरान:
अपने Xcode प्रोजेक्ट में,
FirebaseAppCheckको इंपोर्ट करें. इसके बाद,Firebaseको कॉन्फ़िगर करने से पहले, डीबग प्रोवाइडर फ़ैक्ट्री की मदद से App Check को शुरू करें.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() } } } }अपना डीबग टोकन पाना:
सिम्युलेटर या टेस्ट डिवाइस पर अपना ऐप्लिकेशन लॉन्च करें.
Xcode कंसोल खोलें और App Check डीबग टोकन ढूंढें. उदाहरण के लिए:
<Warning> [AppCheckCore][I-GAC004001] App Check debug token: '123a4567-b89c-12d3-e456-789012345678'.टोकन कॉपी करें (उदाहरण के लिए,
123a4567-b89c-12d3-e456-789012345678).
App Check पर अपना डीबग टोकन रजिस्टर करें:
Firebase कंसोल में, सुरक्षा > App Check > ऐप्लिकेशन टैब पर जाएं.
अपना ऐप्लिकेशन ढूंढें और ओवरफ़्लो मेन्यू () पर क्लिक करें. इसके बाद, डीबग टोकन मैनेज करें को चुनें.
डीबग टोकन को रजिस्टर करने के लिए, स्क्रीन पर दिए गए निर्देशों का पालन करें.
डीबग प्रोवाइडर के बारे में ज़्यादा जानने के लिए, आधिकारिक App Check दस्तावेज़ देखें. इसमें नया डीबग टोकन पाने का तरीका भी बताया गया है.
Kotlin
एम्युलेटर में ऐप्लिकेशन को इंटरैक्टिव तरीके से चलाने के दौरान, डीबग प्रोवाइडर का इस्तेमाल करने का तरीका यहां बताया गया है. उदाहरण के लिए, लोकल डेवलपमेंट के दौरान:
डीबग प्रोवाइडर फ़ैक्ट्री का इस्तेमाल करने के लिए, डीबग के लिए बिल्ड में App Check को कॉन्फ़िगर करें:
Firebase.initialize(context = this) Firebase.appCheck.installAppCheckProviderFactory( DebugAppCheckProviderFactory.getInstance(), )
अपना डीबग टोकन पाना:
एम्युलेटर या टेस्ट के लिए इस्तेमाल किए जा रहे डिवाइस पर अपना ऐप्लिकेशन चलाएं.
अपने लॉग में App Check डीबग टोकन ढूंढें. उदाहरण के लिए:
D DebugAppCheckProvider: Enter this debug secret into the allow list in the Firebase Console for your project: 123a4567-b89c-12d3-e456-789012345678टोकन कॉपी करें (उदाहरण के लिए,
123a4567-b89c-12d3-e456-789012345678).
App Check पर अपना डीबग टोकन रजिस्टर करें:
Firebase कंसोल में, सुरक्षा > App Check > ऐप्लिकेशन टैब पर जाएं.
अपना ऐप्लिकेशन ढूंढें और ओवरफ़्लो मेन्यू () पर क्लिक करें. इसके बाद, डीबग टोकन मैनेज करें को चुनें.
डीबग टोकन को रजिस्टर करने के लिए, स्क्रीन पर दिए गए निर्देशों का पालन करें.
डीबग प्रोवाइडर के बारे में ज़्यादा जानने के लिए, आधिकारिक App Check दस्तावेज़ देखें. इसमें नया डीबग टोकन पाने का तरीका भी बताया गया है.
Java
एम्युलेटर में ऐप्लिकेशन को इंटरैक्टिव तरीके से चलाने के दौरान, डीबग प्रोवाइडर का इस्तेमाल करने का तरीका यहां बताया गया है. उदाहरण के लिए, लोकल डेवलपमेंट के दौरान:
डीबग प्रोवाइडर फ़ैक्ट्री का इस्तेमाल करने के लिए, डीबग के लिए बिल्ड में App Check को कॉन्फ़िगर करें:
FirebaseApp.initializeApp(/*context=*/ this); FirebaseAppCheck firebaseAppCheck = FirebaseAppCheck.getInstance(); firebaseAppCheck.installAppCheckProviderFactory( DebugAppCheckProviderFactory.getInstance());
अपना डीबग टोकन पाना:
एम्युलेटर या टेस्ट के लिए इस्तेमाल किए जा रहे डिवाइस पर अपना ऐप्लिकेशन चलाएं.
अपने लॉग में App Check डीबग टोकन ढूंढें. उदाहरण के लिए:
D DebugAppCheckProvider: Enter this debug secret into the allow list in the Firebase Console for your project: 123a4567-b89c-12d3-e456-789012345678टोकन कॉपी करें (उदाहरण के लिए,
123a4567-b89c-12d3-e456-789012345678).
App Check पर अपना डीबग टोकन रजिस्टर करें:
Firebase कंसोल में, सुरक्षा > App Check > ऐप्लिकेशन टैब पर जाएं.
अपना ऐप्लिकेशन ढूंढें और ओवरफ़्लो मेन्यू () पर क्लिक करें. इसके बाद, डीबग टोकन मैनेज करें को चुनें.
डीबग टोकन को रजिस्टर करने के लिए, स्क्रीन पर दिए गए निर्देशों का पालन करें.
डीबग प्रोवाइडर के बारे में ज़्यादा जानने के लिए, आधिकारिक App Check दस्तावेज़ देखें. इसमें नया डीबग टोकन पाने का तरीका भी बताया गया है.
Web
localhost से इंटरैक्टिव तरीके से ऐप्लिकेशन चलाते समय, डीबग प्रोवाइडर का इस्तेमाल करने का तरीका यहां बताया गया है. उदाहरण के लिए, लोकल डेवलपमेंट के दौरान:
App Check को शुरू करने से पहले, डीबग के लिए बिल्ड में डीबग मोड चालू करें. इसके लिए,
self.FIREBASE_APPCHECK_DEBUG_TOKENकोtrueपर सेट करें. उदाहरण के लिए:self.FIREBASE_APPCHECK_DEBUG_TOKEN = true; initializeAppCheck(app, { /* App Check options */ });अपने वेब ऐप्लिकेशन को स्थानीय तौर पर ऐक्सेस करें और ब्राउज़र के डेवलपर टूल खोलें. डीबग कंसोल में, आपको एक डीबग टोकन दिखेगा:
AppCheck debug token: "123a4567-b89c-12d3-e456-789012345678". You will need to safelist it in the Firebase console for it to work.App Check पर अपना डीबग टोकन रजिस्टर करें:
Firebase कंसोल में, सुरक्षा > App Check > ऐप्लिकेशन टैब पर जाएं.
अपना ऐप्लिकेशन ढूंढें और ओवरफ़्लो मेन्यू () पर क्लिक करें. इसके बाद, डीबग टोकन मैनेज करें को चुनें.
डीबग टोकन को रजिस्टर करने के लिए, स्क्रीन पर दिए गए निर्देशों का पालन करें.
डीबग प्रोवाइडर के बारे में ज़्यादा जानने के लिए, आधिकारिक App Check दस्तावेज़ देखें. इसमें नया डीबग टोकन पाने का तरीका भी बताया गया है.
Dart
iOS+
सिम्युलेटर में ऐप्लिकेशन को इंटरैक्टिव तरीके से चलाने के दौरान, डीबग प्रोवाइडर का इस्तेमाल करने का तरीका यहां बताया गया है. उदाहरण के लिए, लोकल डेवलपमेंट के दौरान:
अपने Firebase ऐप्लिकेशन को शुरू करने के तुरंत बाद, डीबग प्रोवाइडर की मदद से App Check को चालू करें:
import 'package:flutter/material.dart'; import 'package:firebase_core/firebase_core.dart'; // Import the firebase_app_check plugin import 'package:firebase_app_check/firebase_app_check.dart'; Future<void> main() async { WidgetsFlutterBinding.ensureInitialized(); await Firebase.initializeApp(); await FirebaseAppCheck.instance.activate( // Set appleProvider to `AppleProvider.debug` appleProvider: AppleProvider.debug, ); runApp(App()); }अपने Xcode प्रोजेक्ट में डीबग लॉगिंग चालू करें:
- Product > Scheme > Edit scheme खोलें.
- बाईं ओर मौजूद मेन्यू से, Run को चुनें. इसके बाद, Arguments टैब को चुनें.
- Arguments Passed on Launch सेक्शन में,
-FIRDebugEnabledजोड़ें.
अपना डीबग टोकन पाना:
Xcode की मदद से
ios/Runner.xcworkspaceखोलें और सिम्युलेटर या टेस्ट के लिए इस्तेमाल किए जा रहे डिवाइस पर अपना ऐप्लिकेशन चलाएं.Xcode कंसोल खोलें और App Check डीबग टोकन ढूंढें. उदाहरण के लिए:
<Warning> [AppCheckCore][I-GAC004001] App Check debug token: '123a4567-b89c-12d3-e456-789012345678'.टोकन को कॉपी करें (उदाहरण के लिए,
123a4567-b89c-12d3-e456-789012345678).
App Check पर अपना डीबग टोकन रजिस्टर करें:
Firebase कंसोल में, सुरक्षा > App Check > ऐप्लिकेशन टैब पर जाएं.
अपना ऐप्लिकेशन ढूंढें और ओवरफ़्लो मेन्यू () पर क्लिक करें. इसके बाद, डीबग टोकन मैनेज करें को चुनें.
डीबग टोकन को रजिस्टर करने के लिए, स्क्रीन पर दिए गए निर्देशों का पालन करें.
Android
एम्युलेटर में ऐप्लिकेशन को इंटरैक्टिव तरीके से चलाने के दौरान, डीबग प्रोवाइडर का इस्तेमाल करने का तरीका यहां बताया गया है. उदाहरण के लिए, लोकल डेवलपमेंट के दौरान:
अपने Firebase ऐप्लिकेशन को शुरू करने के तुरंत बाद, डीबग प्रोवाइडर की मदद से App Check को चालू करें:
import 'package:flutter/material.dart'; import 'package:firebase_core/firebase_core.dart'; // Import the firebase_app_check plugin import 'package:firebase_app_check/firebase_app_check.dart'; Future<void> main() async { WidgetsFlutterBinding.ensureInitialized(); await Firebase.initializeApp(); await FirebaseAppCheck.instance.activate( // Set androidProvider to `AndroidProvider.debug` androidProvider: AndroidProvider.debug, ); runApp(App()); }अपना डीबग टोकन पाना:
एम्युलेटर या टेस्ट के लिए इस्तेमाल किए जा रहे डिवाइस पर अपना ऐप्लिकेशन चलाएं.
अपने लॉग में App Check डीबग टोकन ढूंढें. उदाहरण के लिए:
D DebugAppCheckProvider: Enter this debug secret into the allow list in the Firebase Console for your project: 123a4567-b89c-12d3-e456-789012345678टोकन को कॉपी करें (उदाहरण के लिए,
123a4567-b89c-12d3-e456-789012345678).
App Check पर अपना डीबग टोकन रजिस्टर करें:
Firebase कंसोल में, सुरक्षा > App Check > ऐप्लिकेशन टैब पर जाएं.
अपना ऐप्लिकेशन ढूंढें और ओवरफ़्लो मेन्यू () पर क्लिक करें. इसके बाद, डीबग टोकन मैनेज करें को चुनें.
डीबग टोकन को रजिस्टर करने के लिए, स्क्रीन पर दिए गए निर्देशों का पालन करें.
वेब
localhost से इंटरैक्टिव तरीके से ऐप्लिकेशन चलाते समय, डीबग प्रोवाइडर का इस्तेमाल करने का तरीका यहां बताया गया है. उदाहरण के लिए, लोकल डेवलपमेंट के दौरान:
web/index.htmlफ़ाइल में,self.FIREBASE_APPCHECK_DEBUG_TOKENकोtrueपर सेट करके डीबग मोड चालू करें:<body> <script> self.FIREBASE_APPCHECK_DEBUG_TOKEN = true; </script> ... </body>अपने वेब ऐप्लिकेशन को स्थानीय तौर पर चलाएं और ब्राउज़र के डेवलपर टूल खोलें. डीबग कंसोल में, आपको एक डीबग टोकन दिखेगा:
AppCheck debug token: "123a4567-b89c-12d3-e456-789012345678". You will need to safelist it in the Firebase console for it to work.यह टोकन आपके ब्राउज़र में सेव किया जाता है. इसका इस्तेमाल तब किया जाएगा, जब उसी मशीन पर उसी ब्राउज़र में ऐप्लिकेशन का इस्तेमाल किया जाएगा. अगर आपको टोकन का इस्तेमाल किसी दूसरे ब्राउज़र या मशीन पर करना है, तो
self.FIREBASE_APPCHECK_DEBUG_TOKENकोtrueके बजाय टोकन स्ट्रिंग पर सेट करें.App Check पर अपना डीबग टोकन रजिस्टर करें:
Firebase कंसोल में, सुरक्षा > App Check > ऐप्लिकेशन टैब पर जाएं.
अपना ऐप्लिकेशन ढूंढें और ओवरफ़्लो मेन्यू () पर क्लिक करें. इसके बाद, डीबग टोकन मैनेज करें को चुनें.
डीबग टोकन को रजिस्टर करने के लिए, स्क्रीन पर दिए गए निर्देशों का पालन करें.
डीबग प्रोवाइडर के बारे में ज़्यादा जानने के लिए, आधिकारिक App Check दस्तावेज़ देखें. इसमें नया डीबग टोकन पाने का तरीका भी बताया गया है.
Unity
एम्युलेटर में ऐप्लिकेशन को इंटरैक्टिव तरीके से चलाने के दौरान, डीबग प्रोवाइडर का इस्तेमाल करने का तरीका यहां बताया गया है. उदाहरण के लिए, लोकल डेवलपमेंट के दौरान:
Firebase कंसोल में, डीबग टोकन बनाएं:
Firebase कंसोल में, सुरक्षा > App Check > ऐप्लिकेशन टैब पर जाएं.
अपना ऐप्लिकेशन ढूंढें और ओवरफ़्लो मेन्यू () पर क्लिक करें. इसके बाद, डीबग टोकन मैनेज करें को चुनें.
नया डीबग टोकन बनाने के लिए, स्क्रीन पर दिए गए निर्देशों का पालन करें.
अपने ऐप्लिकेशन के शुरू होने वाले कोड में, यह जोड़ें:
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 दस्तावेज़ देखें. इसमें नया डीबग टोकन पाने का तरीका भी बताया गया है.
चौथा चरण: सेवा को शुरू करना और मॉडल का इंस्टेंस बनाना
|
इस पेज पर, Gemini API की सेवा देने वाली कंपनी के हिसाब से कॉन्टेंट और कोड देखने के लिए, सेवा देने वाली कंपनी के नाम पर क्लिक करें. |
Gemini मॉडल को प्रॉम्प्ट भेजने से पहले, चुने गए एपीआई प्रोवाइडर के लिए सेवा को शुरू करें और GenerativeModel इंस्टेंस बनाएं.
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");
ध्यान दें कि इस्तेमाल की जा रही सुविधा के आधार पर, ऐसा हो सकता है कि आपको हमेशा GenerativeModel इंस्टेंस बनाने का विकल्प न मिले. Gemini Live API का इस्तेमाल करके इनपुट और आउटपुट को स्ट्रीम करने के लिए, LiveModel इंस्टेंस बनाएं.
साथ ही, इस शुरुआती निर्देश को पूरा करने के बाद, अपने इस्तेमाल के उदाहरण और ऐप्लिकेशन के लिए मॉडल चुनने का तरीका जानें.
पांचवां चरण: किसी मॉडल को अनुरोध भेजना
अब Gemini मॉडल को अनुरोध भेजा जा सकता है.
टेक्स्ट वाले प्रॉम्प्ट से जनरेट किया गया टेक्स्ट बनाने के लिए, generateContent() का इस्तेमाल किया जा सकता है:
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
Kotlin के लिए, इस एसडीके में मौजूद तरीके, सस्पेंड फ़ंक्शन हैं. इन्हें Coroutine स्कोप से कॉल करना ज़रूरी है.
// 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
Java के लिए, इस एसडीके के तरीकेListenableFuture दिखाते हैं.
// 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.");
तुम और क्या कर सकती हो?
इस्तेमाल किए जा सकने वाले मॉडल के बारे में ज़्यादा जानें
अलग-अलग कामों के लिए उपलब्ध मॉडल, उनके कोटा, और कीमत के बारे में जानें.
अन्य सुविधाएं आज़माना
- सिर्फ़ टेक्स्ट वाले प्रॉम्प्ट से जनरेट किया गया टेक्स्ट जनरेट करने के बारे में ज़्यादा जानें. इसमें जवाब को स्ट्रीम करने का तरीका भी शामिल है.
- अलग-अलग फ़ाइल टाइप का इस्तेमाल करके टेक्स्ट जनरेट करना. जैसे, इमेज, PDF, वीडियो, और ऑडियो.
- सिलसिलेवार बातचीत (चैट) की सुविधा बनाएं.
- टेक्स्ट और मल्टीमोडल प्रॉम्प्ट, दोनों से JSON जैसा स्ट्रक्चर्ड आउटपुट जनरेट करना.
- टेक्स्ट और टेक्स्ट, इमेज वग़ैरह का एक साथ इस्तेमाल करके प्रॉम्प्ट डालकर, इमेज जनरेट करना और उनमें बदलाव करना.
- Gemini Live API का इस्तेमाल करके, इनपुट और आउटपुट को स्ट्रीम करना (इसमें ऑडियो भी शामिल है).
-
Gemini मॉडल को अपने ऐप्लिकेशन के अन्य हिस्सों, बाहरी सिस्टम, और जानकारी से कनेक्ट करने के लिए, टूल इस्तेमाल करें. जैसे, फ़ंक्शन कॉलिंग और
Google Search याGoogle Maps के साथ ग्राउंडिंग.
कॉन्टेंट जनरेट करने की सुविधा को कंट्रोल करने का तरीका जानें
- प्रॉम्प्ट डिज़ाइन करने के बारे में जानें. इसमें सबसे सही तरीके, रणनीतियां, और प्रॉम्प्ट के उदाहरण शामिल हैं.
- मॉडल के पैरामीटर कॉन्फ़िगर करें. जैसे, ज़्यादा से ज़्यादा आउटपुट टोकन, बार-बार मिलने वाले आउटपुट टोकन की संभावना वगैरह.
- सुरक्षा सेटिंग का इस्तेमाल करें, ताकि नुकसान पहुंचाने वाले जवाब मिलने की संभावना को कम किया जा सके.
Firebase AI Logic के साथ अपने अनुभव के बारे में सुझाव/राय देना या शिकायत करना