Firebase SDK टूल में Vertex AI की मदद से, Gemini API का इस्तेमाल शुरू करें


इस गाइड में, चुने गए प्लैटफ़ॉर्म के लिए Vertex AI in Firebase SDK टूल का इस्तेमाल करके, अपने ऐप्लिकेशन से सीधे Vertex AI Gemini API को कॉल करने का तरीका बताया गया है.

  • वैकल्पिक तौर पर, Gemini API के किसी अन्य वर्शन "Google AI" के साथ एक्सपेरिमेंट करें
    Google AI Studio और Google AI क्लाइंट SDK टूल का इस्तेमाल करके, सीमाओं के अंदर और जहां उपलब्ध हो वहां बिना किसी शुल्क के ऐक्सेस पाएं. इन SDK टूल का इस्तेमाल, मोबाइल और वेब ऐप्लिकेशन में सिर्फ़ प्रोटोटाइप बनाने के लिए किया जाना चाहिए.

    Gemini API के काम करने के तरीके के बारे में जानने के बाद, हमारे Vertex AI in Firebase SDK टूल पर माइग्रेट करें. इन SDK टूल के दस्तावेज़ यहां दिए गए हैं. इनमें मोबाइल और वेब ऐप्लिकेशन के लिए कई ज़रूरी सुविधाएं हैं. जैसे, Firebase App Check का इस्तेमाल करके एपीआई को गलत इस्तेमाल से बचाना और अनुरोधों में बड़ी मीडिया फ़ाइलों के लिए सहायता.

  • Vertex AI Gemini API सर्वर-साइड को कॉल करें (जैसे, Python, Node.js या Go के साथ)
    Gemini API के लिए, सर्वर-साइड Vertex AI SDK टूल, Firebase Genkit या Firebase Extensions का इस्तेमाल करें.

ध्यान दें कि इस गाइड का इस्तेमाल, Vertex AI in Firebase SDK टूल का इस्तेमाल करके Imagen मॉडल ऐक्सेस करने के लिए भी किया जा सकता है.

ज़रूरी शर्तें

इस गाइड में यह माना गया है कि आपको Flutter की मदद से ऐप्लिकेशन बनाने के बारे में पता है.

  • पक्का करें कि आपका डेवलपमेंट एनवायरमेंट और Flutter ऐप्लिकेशन, इन ज़रूरी शर्तों को पूरा करता हो:

    • Dart 3.2.0 या इसके बाद का वर्शन

  • (ज़रूरी नहीं) सैंपल ऐप्लिकेशन देखें.

    सैंपल ऐप्लिकेशन डाउनलोड करना

    SDK टूल को तुरंत आज़माया जा सकता है. साथ ही, अलग-अलग इस्तेमाल के उदाहरणों को पूरी तरह से लागू किया जा सकता है. अगर आपके पास अपना Flutter ऐप्लिकेशन नहीं है, तो सैंपल ऐप्लिकेशन का इस्तेमाल किया जा सकता है. सैंपल ऐप्लिकेशन का इस्तेमाल करने के लिए, आपको उसे किसी Firebase प्रोजेक्ट से कनेक्ट करना होगा.

पहला चरण: Firebase प्रोजेक्ट सेट अप करना और अपने ऐप्लिकेशन को Firebase से कनेक्ट करना

अगर आपके पास पहले से ही Firebase प्रोजेक्ट और Firebase से जुड़ा ऐप्लिकेशन है

  1. Firebase console में, Gemini का इस्तेमाल करके ऐप्लिकेशन बनाएं पेज पर जाएं.

  2. Vertex AI in Firebase कार्ड पर क्लिक करके, ऐसा वर्कफ़्लो लॉन्च करें जिसकी मदद से ये काम किए जा सकते हैं:

  3. अपने ऐप्लिकेशन में SDK टूल जोड़ने के लिए, इस गाइड में अगले चरण पर जाएं.

अगर आपके पास पहले से कोई Firebase प्रोजेक्ट और Firebase से कनेक्ट किया गया ऐप्लिकेशन नहीं है

  1. Firebase console में साइन इन करें.

  2. प्रोजेक्ट बनाएं पर क्लिक करें. इसके बाद, इनमें से किसी एक विकल्प का इस्तेमाल करें:

    • पहला विकल्प: "प्रोजेक्ट बनाएं" वर्कफ़्लो के पहले चरण में, प्रोजेक्ट का नया नाम डालकर, एक नया Firebase प्रोजेक्ट (और उसके तहत मौजूद Google Cloud प्रोजेक्ट अपने-आप) बनाएं.

    • दूसरा विकल्प: "प्रोजेक्ट बनाएं" वर्कफ़्लो के पहले चरण में, ड्रॉप-डाउन मेन्यू से अपने Google Cloud प्रोजेक्ट का नाम चुनकर, किसी मौजूदा Google Cloud प्रोजेक्ट में "Firebase जोड़ें".

    ध्यान दें कि जब आपसे कहा जाए, तब Vertex AI in Firebase SDKs का इस्तेमाल करने के लिए, आपको Google Analytics सेट अप करने की ज़रूरत नहीं है.

  3. Firebase console में, Gemini का इस्तेमाल करके ऐप्लिकेशन बनाएं पेज पर जाएं.

  4. Vertex AI in Firebase कार्ड पर क्लिक करके, ऐसा वर्कफ़्लो लॉन्च करें जिसकी मदद से ये काम किए जा सकते हैं:

  1. ज़रूरी कमांड-लाइन टूल इंस्टॉल करें:

    1. अगर आपने पहले से ऐसा नहीं किया है, तो Firebase सीएलआई इंस्टॉल करें.

    2. अपने Google खाते का इस्तेमाल करके Firebase में लॉग इन करने के लिए, यह कमांड चलाएं:

      firebase login

    3. किसी भी डायरेक्ट्री से यह कमांड चलाकर, FlutterFire सीएलआई इंस्टॉल करें:

      dart pub global activate flutterfire_cli

  2. Firebase का इस्तेमाल करने के लिए, अपने ऐप्लिकेशन कॉन्फ़िगर करें:

    FlutterFire CLI का इस्तेमाल करके, अपने Flutter ऐप्लिकेशन को Firebase से कनेक्ट करने के लिए कॉन्फ़िगर करें.

    ऐप्लिकेशन कॉन्फ़िगरेशन वर्कफ़्लो शुरू करने के लिए, अपनी Flutter प्रोजेक्ट डायरेक्ट्री से यह कमांड चलाएं:

    flutterfire configure

    flutterfire configure वर्कफ़्लो ये काम करता है:

    • आपसे उन प्लैटफ़ॉर्म (iOS, Android, वेब) को चुनने के लिए कहता है जिन पर आपका Flutter ऐप्लिकेशन काम करता है. चुने गए हर प्लैटफ़ॉर्म के लिए, FlutterFire CLI आपके Firebase प्रोजेक्ट में एक नया Firebase ऐप्लिकेशन बनाता है.

      आपके पास किसी मौजूदा Firebase प्रोजेक्ट का इस्तेमाल करने या नया Firebase प्रोजेक्ट बनाने का विकल्प होता है. अगर आपके पास पहले से ही किसी मौजूदा Firebase प्रोजेक्ट में रजिस्टर किए गए ऐप्लिकेशन हैं, तो FlutterFire CLI आपके मौजूदा Flutter प्रोजेक्ट कॉन्फ़िगरेशन के आधार पर, उन्हें मैच करने की कोशिश करेगा.

    • Firebase कॉन्फ़िगरेशन फ़ाइल (firebase_options.dart) बनाता है और उसे आपके Flutter ऐप्लिकेशन की lib/ डायरेक्ट्री में जोड़ता है.

  3. इस गाइड के अगले चरणों में, आपको अपने ऐप्लिकेशन में Vertex AI in Firebase SDK टूल जोड़ना होगा. साथ ही, SDK टूल और Gemini API का इस्तेमाल करने के लिए, ज़रूरी शुरूआती प्रोसेस पूरी करनी होगी.


दूसरा चरण: SDK टूल जोड़ना

Firebase प्रोजेक्ट सेट अप करने और ऐप्लिकेशन को Firebase से कनेक्ट करने (पिछला चरण देखें) के बाद, अब अपने ऐप्लिकेशन में Vertex AI in Firebase SDK टूल जोड़ा जा सकता है.

Flutter (firebase_vertexai) के लिए Vertex AI in Firebase प्लग इन, Gemini और Imagen मॉडल के साथ इंटरैक्ट करने के लिए, एपीआई का ऐक्सेस देता है.

  1. Flutter प्रोजेक्ट डायरेक्ट्री में, कोर प्लग इन और Vertex AI in Firebase प्लग इन इंस्टॉल करने के लिए, यह कमांड चलाएं:

    flutter pub add firebase_core && flutter pub add firebase_vertexai

  2. अपनी lib/main.dart फ़ाइल में, Firebase कोर प्लगिन, Vertex AI in Firebase प्लगिन, और पहले जनरेट की गई कॉन्फ़िगरेशन फ़ाइल इंपोर्ट करें:

    import 'package:firebase_core/firebase_core.dart';
import 'package:firebase_vertexai/firebase_vertexai.dart';
import 'firebase_options.dart';

  3. अपनी lib/main.dart फ़ाइल में, कॉन्फ़िगरेशन फ़ाइल से एक्सपोर्ट किए गए DefaultFirebaseOptions ऑब्जेक्ट का इस्तेमाल करके Firebase को शुरू करें:

    await Firebase.initializeApp(
  options: DefaultFirebaseOptions.currentPlatform,
);

  4. अपना Flutter ऐप्लिकेशन फिर से बनाएं:

    flutter run

तीसरा चरण: Vertex AI सेवा और जनरेटिव मॉडल को शुरू करना

कोई भी एपीआई कॉल करने और Gemini मॉडल को प्रॉम्प्ट करने से पहले, आपको Vertex AI सेवा और जनरेटिव मॉडल को शुरू करना होगा.

import 'package:firebase_vertexai/firebase_vertexai.dart';
import 'package:firebase_core/firebase_core.dart';
import 'firebase_options.dart';

// Initialize FirebaseApp
await Firebase.initializeApp(
  options: DefaultFirebaseOptions.currentPlatform,
);

// Initialize the Vertex AI service and the generative model
// Specify a model that supports your use case
final model =
      FirebaseVertexAI.instance.generativeModel(model: 'gemini-2.0-flash');

शुरू करने से जुड़ी इस गाइड को पढ़ने के बाद, अपने इस्तेमाल के उदाहरण और ऐप्लिकेशन के हिसाब से सही मॉडल और (ज़रूरी नहीं) जगह चुनने का तरीका जानें.

चौथा चरण: किसी मॉडल को प्रॉम्प्ट का अनुरोध भेजना

अपने ऐप्लिकेशन को Firebase से कनेक्ट करने, SDK टूल जोड़ने, और Vertex AI सेवा और जनरेटिव मॉडल को शुरू करने के बाद, अब आपके पास Gemini मॉडल को प्रॉम्प्ट अनुरोध भेजने का विकल्प है.

सिर्फ़ टेक्स्ट वाले प्रॉम्प्ट अनुरोध से टेक्स्ट जनरेट करने के लिए, generateContent() का इस्तेमाल किया जा सकता है:

import 'package:firebase_vertexai/firebase_vertexai.dart';
import 'package:firebase_core/firebase_core.dart';
import 'firebase_options.dart';

await Firebase.initializeApp(
  options: DefaultFirebaseOptions.currentPlatform,
);

// Initialize the Vertex AI service and the generative model
// Specify a model that supports your use case
final model =
      FirebaseVertexAI.instance.generativeModel(model: 'gemini-2.0-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);

तुम और क्या कर सकती हो?

इस्तेमाल किए जा सकने वाले मॉडल के बारे में ज़्यादा जानें

अलग-अलग कामों के लिए उपलब्ध मॉडल, उनके कोटे, और कीमत के बारे में जानें.

Gemini API की अन्य सुविधाएं आज़माएं

कॉन्टेंट जनरेशन को कंट्रोल करने का तरीका जानें

Vertex AI Studio का इस्तेमाल करके, प्रॉम्प्ट और मॉडल कॉन्फ़िगरेशन के साथ भी एक्सपेरिमेंट किया जा सकता है.


Vertex AI in Firebase के इस्तेमाल के अपने अनुभव के बारे में सुझाव/राय देना या शिकायत करना