इस गाइड में बताया गया है कि चुने गए प्लैटफ़ॉर्म के लिए Firebase AI Logic क्लाइंट एसडीके का इस्तेमाल करके, Gemini API को सीधे अपने ऐप्लिकेशन से कॉल करना कैसे शुरू करें.
ज़रूरी शर्तें
Swift
इस गाइड में यह माना गया है कि आपको Apple प्लैटफ़ॉर्म (जैसे, iOS) के लिए ऐप्लिकेशन डेवलप करने के लिए, Xcode का इस्तेमाल करने के बारे में जानकारी है.
पक्का करें कि आपका डेवलपमेंट एनवायरमेंट और Apple प्लैटफ़ॉर्म ऐप्लिकेशन, इन ज़रूरी शर्तों को पूरा करता हो:
- Xcode 26.2 या इसके बाद का वर्शन
- आपका ऐप्लिकेशन, iOS 15 या इसके बाद के वर्शन या macOS 12 या इसके बाद के वर्शन को टारगेट करता हो
Kotlin
इस गाइड में यह माना गया है कि आपको Android के लिए ऐप्लिकेशन डेवलप करने के लिए, Android Studio का इस्तेमाल करने के बारे में जानकारी है.
पक्का करें कि आपका डेवलपमेंट एनवायरमेंट और Android ऐप्लिकेशन, इन ज़रूरी शर्तों को पूरा करता हो:
- Android Studio (नवीनतम वर्शन)
- आपका ऐप्लिकेशन, एपीआई लेवल 21 या उसके बाद के लेवल को टारगेट करता हो
Java
इस गाइड में यह माना गया है कि आपको Android के लिए ऐप्लिकेशन डेवलप करने के लिए, Android Studio का इस्तेमाल करने के बारे में जानकारी है.
पक्का करें कि आपका डेवलपमेंट एनवायरमेंट और Android ऐप्लिकेशन, इन ज़रूरी शर्तों को पूरा करता हो:
- Android Studio (नवीनतम वर्शन)
- आपका ऐप्लिकेशन, एपीआई लेवल 21 या उसके बाद के लेवल को टारगेट करता हो
Web
इस गाइड में यह माना गया है कि आपको वेब ऐप्लिकेशन डेवलप करने के लिए, JavaScript का इस्तेमाल करने के बारे में जानकारी है. यह गाइड, फ़्रेमवर्क से अलग है.
पक्का करें कि आपका डेवलपमेंट एनवायरमेंट और वेब ऐप्लिकेशन, इन ज़रूरी शर्तों को पूरा करते हों:
- (ज़रूरी नहीं) Node.js
- मॉडर्न वेब ब्राउज़र
Dart
इस गाइड में यह माना गया है कि आपको Flutter की मदद से ऐप्लिकेशन डेवलप करने के बारे में जानकारी है.
पक्का करें कि आपका डेवलपमेंट एनवायरमेंट और Flutter ऐप्लिकेशन, इन ज़रूरी शर्तों को पूरा करते हों:
- Dart 3.2.0+
Unity
इस गाइड में यह माना गया है कि आपको Unity का इस्तेमाल करके गेम डेवलप करने के बारे में जानकारी है.
पक्का करें कि आपका डेवलपमेंट एनवायरमेंट और Unity गेम, इन ज़रूरी शर्तों को पूरा करते हों:
- Unity Editor 2021 LTS या इसके बाद का वर्शन
काम के संसाधन देखें
Swift
क्विकस्टार्ट ऐप्लिकेशन आज़माएं
एसडीके को तुरंत आज़माने के लिए, क्विकस्टार्ट ऐप्लिकेशन का इस्तेमाल करें. साथ ही, इस्तेमाल के अलग-अलग उदाहरणों को पूरी तरह से लागू करके देखें. अगर आपके पास Apple प्लैटफ़ॉर्म का अपना ऐप्लिकेशन नहीं है, तो क्विकस्टार्ट ऐप्लिकेशन का इस्तेमाल करें. क्विकस्टार्ट ऐप्लिकेशन का इस्तेमाल करने के लिए, आपको इसे किसी Firebase प्रोजेक्ट से कनेक्ट करना होगा.
क्विकस्टार्ट ऐप्लिकेशन पर जाएं
वीडियो ट्यूटोरियल देखना
इस वीडियो में, Firebase AI Logic का इस्तेमाल शुरू करने का तरीका बताया गया है. इसके लिए, एआई की मदद से काम करने वाला एक ऐसा ऐप्लिकेशन बनाया गया है जो टेक्स्ट प्रॉम्प्ट से रेसिपी जनरेट करता है.
वीडियो में दिखाए गए ऐप्लिकेशन के कोड बेस को डाउनलोड करके भी देखा जा सकता है.
वीडियो के ऐप्लिकेशन का कोडबेस देखना
Kotlin
क्विकस्टार्ट ऐप्लिकेशन आज़माएं
एसडीके को तुरंत आज़माने के लिए, क्विकस्टार्ट ऐप्लिकेशन का इस्तेमाल करें. साथ ही, इस्तेमाल के अलग-अलग उदाहरणों को पूरी तरह से लागू करके देखें. अगर आपके पास अपना Android ऐप्लिकेशन नहीं है, तो क्विकस्टार्ट ऐप्लिकेशन का इस्तेमाल करें. क्विकस्टार्ट ऐप्लिकेशन का इस्तेमाल करने के लिए, आपको इसे किसी Firebase प्रोजेक्ट से कनेक्ट करना होगा.
क्विकस्टार्ट ऐप्लिकेशन पर जाएं
वीडियो ट्यूटोरियल देखना
इस वीडियो में, Firebase AI Logic का इस्तेमाल शुरू करने का तरीका बताया गया है. इसके लिए, एआई की मदद से काम करने वाला एक ऐसा ऐप्लिकेशन बनाया गया है जो टेक्स्ट प्रॉम्प्ट से रेसिपी जनरेट करता है.
वीडियो में दिखाए गए ऐप्लिकेशन के कोड बेस को डाउनलोड करके भी देखा जा सकता है.
वीडियो के ऐप्लिकेशन का कोडबेस देखना
Java
क्विकस्टार्ट ऐप्लिकेशन आज़माएं
एसडीके को तुरंत आज़माने के लिए, क्विकस्टार्ट ऐप्लिकेशन का इस्तेमाल करें. साथ ही, इस्तेमाल के अलग-अलग उदाहरणों को पूरी तरह से लागू करके देखें. अगर आपके पास अपना Android ऐप्लिकेशन नहीं है, तो क्विकस्टार्ट ऐप्लिकेशन का इस्तेमाल करें. क्विकस्टार्ट ऐप्लिकेशन का इस्तेमाल करने के लिए, आपको इसे किसी Firebase प्रोजेक्ट से कनेक्ट करना होगा.
क्विकस्टार्ट ऐप्लिकेशन पर जाएं
वीडियो ट्यूटोरियल देखना
इस वीडियो में, Firebase AI Logic का इस्तेमाल शुरू करने का तरीका बताया गया है. इसके लिए, एआई की मदद से काम करने वाला एक ऐसा ऐप्लिकेशन बनाया गया है जो खाने की प्लानिंग करता है. यह ऐप्लिकेशन, टेक्स्ट प्रॉम्प्ट से रेसिपी जनरेट करता है.*
वीडियो में दिखाए गए ऐप्लिकेशन के कोड बेस को डाउनलोड करके भी देखा जा सकता है.
वीडियो के ऐप्लिकेशन का कोडबेस देखना
* यह वीडियो और इसका ऐप्लिकेशन Kotlin में है. हालांकि, इससे Java डेवलपर को Firebase AI Logic के बारे में बुनियादी जानकारी मिल सकती है.
Web
क्विकस्टार्ट ऐप्लिकेशन आज़माएं
एसडीके को तुरंत आज़माने के लिए, क्विकस्टार्ट ऐप्लिकेशन का इस्तेमाल करें. साथ ही, इस्तेमाल के अलग-अलग उदाहरणों को पूरी तरह से लागू करके देखें. अगर आपके पास अपना वेब ऐप्लिकेशन नहीं है, तो क्विकस्टार्ट ऐप्लिकेशन का इस्तेमाल करें. क्विकस्टार्ट ऐप्लिकेशन का इस्तेमाल करने के लिए, आपको इसे किसी Firebase प्रोजेक्ट से कनेक्ट करना होगा.
Dart
क्विकस्टार्ट ऐप्लिकेशन आज़माएं
एसडीके को तुरंत आज़माने के लिए, क्विकस्टार्ट ऐप्लिकेशन का इस्तेमाल करें. साथ ही, इस्तेमाल के अलग-अलग उदाहरणों को पूरी तरह से लागू करके देखें. अगर आपके पास अपना Flutter ऐप्लिकेशन नहीं है, तो क्विकस्टार्ट ऐप्लिकेशन का इस्तेमाल करें. क्विकस्टार्ट ऐप्लिकेशन का इस्तेमाल करने के लिए, आपको इसे किसी Firebase प्रोजेक्ट से कनेक्ट करना होगा.
क्विकस्टार्ट ऐप्लिकेशन पर जाएं
वीडियो ट्यूटोरियल देखना
इस वीडियो में, Firebase AI Logic का इस्तेमाल शुरू करने का तरीका बताया गया है. इसके लिए, एआई की मदद से काम करने वाला एक ऐसा ऐप्लिकेशन बनाया गया है जो टेक्स्ट प्रॉम्प्ट से रेसिपी जनरेट करता है.
वीडियो में दिखाए गए ऐप्लिकेशन के कोड बेस को डाउनलोड करके भी देखा जा सकता है.
वीडियो के ऐप्लिकेशन का कोडबेस देखना
Unity
क्विकस्टार्ट ऐप्लिकेशन आज़माएं
एसडीके को तुरंत आज़माने के लिए, क्विकस्टार्ट ऐप्लिकेशन का इस्तेमाल करें. साथ ही, इस्तेमाल के अलग-अलग उदाहरणों को पूरी तरह से लागू करके देखें. अगर आपके पास अपना Unity गेम नहीं है, तो क्विकस्टार्ट ऐप्लिकेशन का इस्तेमाल करें. क्विकस्टार्ट ऐप्लिकेशन का इस्तेमाल करने के लिए, आपको इसे Firebase प्रोजेक्ट से कनेक्ट करना होगा.
पहला चरण: Firebase प्रोजेक्ट सेट अप करना और एपीआई चालू करना
Firebase कंसोल में साइन इन करें. इसके बाद, अपना Firebase प्रोजेक्ट चुनें.
Firebase console में, एआई सेवाएं > एआई लॉजिक पर जाएं.
शुरू करें पर क्लिक करके, निर्देशों के साथ वर्कफ़्लो लॉन्च करें. इससे आपको अपने प्रोजेक्ट के लिए ज़रूरी एपीआई और संसाधन सेट अप करने में मदद मिलेगी.
अगर कहा जाए, तो स्क्रीन पर दिए गए निर्देशों का पालन करके, अपने ऐप्लिकेशन को रजिस्टर करें. साथ ही, अपने ऐप्लिकेशन में Firebase कॉन्फ़िगरेशन जोड़ें.
"Gemini API उपलब्ध कराने वाली कंपनी" चुनने के लिए कहा जाने पर, हम आपको Gemini Developer API चुनने का सुझाव देते हैं. इससे आपको बिना किसी शुल्क के तुरंत शुरुआत करने में मदद मिलती है.
बाद में किसी भी समय, Agent Platform Gemini API (formerly Vertex AI) को सेट अप किया जा सकता है. साथ ही, बिलिंग के लिए ज़रूरी जानकारी भी दी जा सकती है.
Firebase AI Logic के लिए, ज़रूरी एपीआई और उनसे जुड़ी सेवाओं को सेट अप करने के लिए, वर्कफ़्लो में आगे बढ़ें.
जुलाई 2026 की शुरुआत से, वर्कफ़्लो का यह चरण AI Logic के लिए Firebase App Check को अपने-आप लागू कर देगा. यह Gemini API की सुरक्षा के लिए ज़रूरी सेवा है. ऐसा तब होता है, जब Gemini API को सीधे आपके ऐप्लिकेशन से ऐक्सेस किया जाता है. शुरू करने के लिए, आपको App Check डीबग प्रोवाइडर को कॉन्फ़िगर करना होगा. इसके बारे में इस गाइड में बाद में बताया गया है. ऐसा तब करना होगा, जब App Check लागू किया गया हो.
ऐसा करने से, उपयोगकर्ता App Check लागू होने पर इस सुविधा का इस्तेमाल कर पाएंगे.अपने ऐप्लिकेशन में ज़रूरी एसडीके टूल जोड़ने के लिए, इस गाइड में दिए गए अगले चरण पर जाएं.
दूसरा चरण: ज़रूरी एसडीके जोड़ना
Firebase प्रोजेक्ट सेट अप करने और ज़रूरी एपीआई चालू करने के बाद (पिछला चरण देखें), अब अपने ऐप्लिकेशन में ज़रूरी SDK टूल जोड़े जा सकते हैं.
Swift
Firebase डिपेंडेंसी इंस्टॉल और मैनेज करने के लिए, Swift Package Manager का इस्तेमाल करें. अगर ज़रूरत हो, तो इंस्टॉल करने के अन्य विकल्पों के बारे में जानें.
Firebase AI Logic लाइब्रेरी की मदद से, Gemini मॉडल के साथ इंटरैक्ट करने के लिए एपीआई ऐक्सेस किए जा सकते हैं. यह लाइब्रेरी, Apple प्लैटफ़ॉर्म (firebase-ios-sdk) के लिए Firebase 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 Android के लिए SDK टूल (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:34.18.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 लाइब्रेरी के साथ काम करने वाले वर्शन का इस्तेमाल करेगा.
Java
Firebase AI Logic Android के लिए SDK टूल (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:34.18.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 लाइब्रेरी के साथ काम करने वाले वर्शन का इस्तेमाल करेगा.
Web
Firebase AI Logic लाइब्रेरी की मदद से, Gemini मॉडल के साथ इंटरैक्ट करने के लिए एपीआई ऐक्सेस किए जा सकते हैं. यह लाइब्रेरी, Web के लिए 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 डाउनलोड करें. इसके बाद, एसडीके को किसी सुविधाजनक जगह पर एक्सट्रैक्ट करें.
Firebase Unity एसडीके टूल, प्लैटफ़ॉर्म के हिसाब से नहीं होता.
खुले हुए यूनिटी प्रोजेक्ट में, ऐसेट > पैकेज इंपोर्ट करें > कस्टम पैकेज पर जाएं.
एक्सट्रैक्ट किए गए 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जोड़ें.
अपना डीबग टोकन पाएं:
ios/Runner.xcworkspaceको Xcode की मदद से खोलें और अपने ऐप्लिकेशन को सिम्युलेटर में या टेस्ट के लिए डिवाइस पर चलाएं.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.7-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.7-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.7-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.7-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.7-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.7-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.7-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 के लिए, इस एसडीके में मौजूद तरीके सस्पेंड फ़ंक्शन हैं. इन्हें कोरूटीन स्कोप से कॉल करना ज़रूरी है.
// 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.7-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.7-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.7-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.7-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.7-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 के साथ अपने अनुभव के बारे में सुझाव/राय दें या शिकायत करें