Vertex AI in Firebase SDK के GA वर्शन से, Firebase AI Logic SDK पर माइग्रेट करना


Firebase AI Logic और इसके क्लाइंट एसडीके को पहले "Vertex AI in Firebase" कहा जाता था. हमारी सेवाओं और सुविधाओं के बारे में बेहतर तरीके से बताने के लिए (उदाहरण के लिए, अब हम Gemini Developer API के साथ काम करते हैं!), हमने अपनी सेवाओं का नाम बदलकर उन्हें Firebase AI Logic के तौर पर फिर से पैकेज किया है.

अपने मोबाइल या वेब ऐप्लिकेशन से सीधे Google के जनरेटिव एआई मॉडल को सुरक्षित तरीके से ऐक्सेस करने के लिए, अब "Gemini API" सेवा देने वाली कंपनी को चुना जा सकता है — चाहे वह लंबे समय से उपलब्ध Agent Platform Gemini API (formerly Vertex AI) हो या अब Gemini Developer API. इसका मतलब है कि अब आपके पास Gemini Developer API का इस्तेमाल करने का विकल्प है. इसमें बिना किसी शुल्क के इस्तेमाल किया जा सकने वाला टियर मिलता है. इसमें अनुरोध संख्या सीमित करने की सुविधा और कोटा भी मिलता है.

Firebase AI Logic एसडीके पर माइग्रेट करने के तरीके

  • पहला चरण: अपने ऐप्लिकेशन और इस्तेमाल के उदाहरणों के लिए, सबसे सही "Gemini API" सेवा देने वाली कंपनी चुनें.

  • दूसरा चरण: अपना Firebase प्रोजेक्ट सेट अप करें, ताकि Gemini Developer API का इस्तेमाल किया जा सके.
    यह सिर्फ़ तब लागू होता है, जब Agent Platform Gemini API (formerly Vertex AI) के बजाय Gemini Developer API का इस्तेमाल किया जा रहा हो.

  • तीसरा चरण: अपने ऐप्लिकेशन में इस्तेमाल की गई लाइब्रेरी को अपडेट करें.

  • चौथा चरण: अपने ऐप्लिकेशन में इनिशलाइज़ेशन को अपडेट करें.

  • पांचवां चरण: इस्तेमाल की जाने वाली सुविधाओं के हिसाब से अपना कोड अपडेट करें.

पहला चरण: अपने ऐप्लिकेशन के लिए, "Gemini API" की सुविधा देने वाला सबसे सही प्लैटफ़ॉर्म चुनें

इस माइग्रेशन के बाद, आपके पास "Gemini API" की सेवा देने वाली कंपनी चुनने का विकल्प होगा:

  • पुराने "Vertex AI in Firebase" एसडीके, सिर्फ़ Agent Platform Gemini API (formerly Vertex AI) का इस्तेमाल कर सकते थे.

  • नए Firebase AI Logic SDK टूल की मदद से, यह चुना जा सकता है कि आपको अपने मोबाइल या वेब ऐप्लिकेशन से, "Gemini API" की सुविधा देने वाली किस कंपनी को सीधे कॉल करना है – Gemini Developer API या Agent Platform Gemini API (formerly Vertex AI).

Gemini API की सेवा देने वाली दोनों कंपनियों के बीच के अंतर को समझें. खास तौर पर, उपलब्ध सुविधाओं, कीमत, और अनुरोध संख्या सीमित करने के बारे में जानें. उदाहरण के लिए, Gemini Developer API में Cloud Storage यूआरएल का इस्तेमाल करके फ़ाइलें उपलब्ध कराने की सुविधा नहीं है. हालांकि, अगर आपको बिना किसी शुल्क के मिलने वाले टियर और सही कोटा का फ़ायदा लेना है, तो यह एक अच्छा विकल्प हो सकता है.

दूसरा चरण: अपना Firebase प्रोजेक्ट सेट अप करें, ताकि Gemini Developer API का इस्तेमाल किया जा सके

यह चरण सिर्फ़ तब ज़रूरी है, जब आपको Firebase AI Logic क्लाइंट SDK टूल के साथ Gemini Developer API का इस्तेमाल करना हो. हालांकि, अगर आपको Agent Platform Gemini API (formerly Vertex AI) का इस्तेमाल जारी रखना है, तोअगले चरण पर जाएं.

ध्यान दें कि आपके प्रोजेक्ट में, "Gemini API" की सेवा देने वाली दोनों कंपनियों को एक साथ चालू किया जा सकता है.

  1. Firebase कंसोल में, एआई सेवाएं > एआई लॉजिक पर जाएं.

  2. सेटिंग टैब पर जाएं और Gemini Developer API को चुनें.

  3. Gemini Developer API को चालू करें.

    कंसोल यह पक्का करेगा कि ज़रूरी एपीआई चालू हों. साथ ही, आपके Firebase प्रोजेक्ट में Gemini एपीआई पासकोड जनरेट करेगा.
    इस Gemini एपीआई पासकोड को अपने ऐप्लिकेशन के कोड बेस में न जोड़ें. ज़्यादा जानें.

  4. अपने ऐप्लिकेशन में लाइब्रेरी और इनिशलाइज़ेशन को अपडेट करने के लिए, माइग्रेट करने से जुड़ी इस गाइड को पढ़ें.

तीसरा चरण: अपने ऐप्लिकेशन में इस्तेमाल की गई लाइब्रेरी को अपडेट करना

Firebase AI Logic लाइब्रेरी का इस्तेमाल करने के लिए, अपने ऐप्लिकेशन के कोड बेस को अपडेट करें.

Swift

  1. Xcode में, अपना ऐप्लिकेशन प्रोजेक्ट खोलें. इसके बाद, इनमें से किसी एक विकल्प का इस्तेमाल करके, अपने Firebase पैकेज को v12.5.0 या इसके बाद के वर्शन पर अपडेट करें:

    • पहला विकल्प: सभी पैकेज अपडेट करें: File > Packages > Update to Latest Package Versions पर जाएं.

    • दूसरा विकल्प: Firebase को अलग से अपडेट करें: Package Dependencies सेक्शन में जाकर, Firebase पैकेज पर जाएं. Firebase पैकेज पर राइट क्लिक करें. इसके बाद, Update Package को चुनें.

  2. पक्का करें कि Firebase पैकेज अब v12.5.0 या इसके बाद का वर्शन दिखा रहा हो. अगर ऐसा नहीं है, तो पुष्टि करें कि आपने पैकेज की जो ज़रूरी शर्तें तय की हैं उनके मुताबिक, SDK टूल को v12.5.0 या इसके बाद के वर्शन पर अपडेट किया जा सकता है.

  3. प्रोजेक्ट एडिटर में अपने ऐप्लिकेशन का टारगेट चुनें. इसके बाद, फ़्रेमवर्क, लाइब्रेरी, और एम्बेड किया गया कॉन्टेंट सेक्शन पर जाएं.

  4. नई लाइब्रेरी जोड़ें: + बटन को चुनें. इसके बाद, Firebase पैकेज से FirebaseAILogic जोड़ें.

  5. अपने ऐप्लिकेशन को माइग्रेट करने के बाद (इस गाइड में बाकी सेक्शन देखें), पुरानी लाइब्रेरी को हटाना न भूलें:
    FirebaseVertexAI को चुनें. इसके बाद, — बटन दबाएं.

Kotlin

  1. अपनी मॉड्यूल (ऐप्लिकेशन-लेवल) की Gradle फ़ाइल (आम तौर पर, <project>/<app-module>/build.gradle.kts या <project>/<app-module>/build.gradle) में, पुरानी डिपेंडेंसी (अगर लागू हो) को इनसे बदलें.

    ध्यान दें कि पुरानी डिपेंडेंसी को मिटाने से पहले, अपने ऐप्लिकेशन के कोड बेस को माइग्रेट करना आसान हो सकता है. इस बारे में जानने के लिए, इस गाइड के बाकी सेक्शन देखें.

    // BEFORE
    dependencies {
      implementation(platform("com.google.firebase:firebase-bom:33.x.y"))
      implementation("com.google.firebase:firebase-vertexai")
      // OR if not using the BoM
      implementation("com.google.firebase:firebase-vertexai:16.x.y")
    }
    
    
    // AFTER
    dependencies {
      // Import the BoM for the Firebase platform
      implementation(platform("com.google.firebase:firebase-bom:35.1.0"))
    
      // Add the dependency for the Firebase AI Logic library
      // When using the BoM, you don't specify versions in Firebase library dependencies
      implementation("com.google.firebase:firebase-ai")
    }
  2. अपने Android प्रोजेक्ट को Gradle फ़ाइलों के साथ सिंक करें.

ध्यान दें कि अगर आपको Firebase Android BoM का इस्तेमाल नहीं करना है, तो बस firebase-ai लाइब्रेरी के लिए डिपेंडेंसी जोड़ें और Android Studio के सुझाए गए नए वर्शन को स्वीकार करें.

Java

  1. अपनी मॉड्यूल (ऐप्लिकेशन-लेवल) की Gradle फ़ाइल (आम तौर पर, <project>/<app-module>/build.gradle.kts या <project>/<app-module>/build.gradle) में, पुरानी डिपेंडेंसी (अगर लागू हो) को इनसे बदलें.

    ध्यान दें कि पुरानी डिपेंडेंसी को मिटाने से पहले, अपने ऐप्लिकेशन के कोड बेस को माइग्रेट करना आसान हो सकता है. इस बारे में जानने के लिए, इस गाइड के बाकी सेक्शन देखें.

    // BEFORE
    dependencies {
      implementation(platform("com.google.firebase:firebase-bom:33.x.y"))
      implementation("com.google.firebase:firebase-vertexai")
      // OR if not using the BoM
      implementation("com.google.firebase:firebase-vertexai:16.x.y")
    }
    
    
    // AFTER
    dependencies {
      // Import the BoM for the Firebase platform
      implementation(platform("com.google.firebase:firebase-bom:35.1.0"))
    
      // Add the dependency for the Firebase AI Logic library
      // When using the BoM, you don't specify versions in Firebase library dependencies
      implementation("com.google.firebase:firebase-ai")
    }
  2. अपने Android प्रोजेक्ट को Gradle फ़ाइलों के साथ सिंक करें.

ध्यान दें कि अगर आपको Firebase Android BoM का इस्तेमाल नहीं करना है, तो बस firebase-ai लाइब्रेरी के लिए डिपेंडेंसी जोड़ें और Android Studio के सुझाए गए नए वर्शन को स्वीकार करें.

Web

  1. npm का इस्तेमाल करके, वेब के लिए Firebase JS SDK टूल का नया वर्शन डाउनलोड करें:

    npm i firebase@latest

    या

    yarn add firebase@latest
  2. आपने जहां भी लाइब्रेरी इंपोर्ट की है वहां इंपोर्ट स्टेटमेंट को अपडेट करें, ताकि firebase/ai का इस्तेमाल किया जा सके.

    ध्यान दें कि पुराने इंपोर्ट मिटाने से पहले, अपने ऐप्लिकेशन के कोड बेस को माइग्रेट करना आसान हो सकता है. इस बारे में जानने के लिए, इस गाइड के बाकी सेक्शन देखें.

    // BEFORE
    import { initializeApp } from "firebase/app";
    import { getVertexAI, getGenerativeModel } from "firebase/vertexai";
    
    
    // AFTER
    import { initializeApp } from "firebase/app";
    import { getAI, getGenerativeModel } from "firebase/ai";

Dart

  1. अपनी Flutter प्रोजेक्ट डायरेक्ट्री से यह कमांड चलाकर, pubspec.yaml फ़ाइल में firebase_ai पैकेज का इस्तेमाल करने के लिए अपडेट करें:

    flutter pub add firebase_ai
  2. अपने Flutter प्रोजेक्ट को फिर से बनाएं:

    flutter run
  3. अपने ऐप्लिकेशन को माइग्रेट करने के बाद (इस गाइड में बाकी सेक्शन देखें), पुराने पैकेज को मिटाना न भूलें:

    flutter pub remove firebase_vertexai

Unity

"Vertex AI in Firebase" से Unity के लिए सहायता उपलब्ध नहीं थी.

Unity के लिए Firebase AI Logic SDK टूल का इस्तेमाल शुरू करने का तरीका जानें.

चौथा चरण: अपने ऐप्लिकेशन में इनिशलाइज़ेशन को अपडेट करना

इस पेज पर, Gemini API की सेवा देने वाली कंपनी के हिसाब से कॉन्टेंट और कोड देखने के लिए, सेवा देने वाली कंपनी के नाम पर क्लिक करें.

एपीआई की सेवा देने वाली चुनी गई कंपनी के लिए, सेवा को शुरू करने का तरीका अपडेट करें और 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

"Vertex AI in Firebase" से Unity के लिए सहायता उपलब्ध नहीं थी.

Unity के लिए Firebase AI Logic SDK टूल का इस्तेमाल शुरू करने का तरीका जानें.

ध्यान दें कि इस्तेमाल की जा रही सुविधा के आधार पर, ऐसा हो सकता है कि आप हमेशा GenerativeModel इंस्टेंस न बना पाएं. Gemini Live API का इस्तेमाल करके इनपुट और आउटपुट को स्ट्रीम करने के लिए, LiveModel इंस्टेंस बनाएं.

पांचवां चरण: इस्तेमाल की जाने वाली सुविधाओं के हिसाब से अपना कोड अपडेट करना

इस चरण में उन बदलावों के बारे में बताया गया है जो आपको अपनी ज़रूरत के हिसाब से करने पड़ सकते हैं.

  • अगर आपने Cloud Storage यूआरएल और इस माइग्रेशन में Gemini Developer API का इस्तेमाल किया है, तो आपको मल्टीमोडल अनुरोधों को अपडेट करना होगा, ताकि फ़ाइलों को इनलाइन डेटा के तौर पर शामिल किया जा सके (या वीडियो के लिए YouTube यूआरएल इस्तेमाल करें).

  • अपने कोड में ज़रूरी बदलाव करने के लिए, यहां दी गई सूचियां देखें. इससे, Firebase AI Logic SDK टूल को इस्तेमाल करने में मदद मिलेगी.

Swift

कोई और बदलाव नहीं.

Kotlin

  • Live API

    • enum क्लास ResponseModality के लिए, UNSPECIFIED वैल्यू को हटा दिया गया है. इसके बजाय, null का इस्तेमाल करें.

Java

  • Live API

    • enum क्लास ResponseModality के लिए, UNSPECIFIED वैल्यू को हटा दिया गया है. इसके बजाय, null का इस्तेमाल करें.
  • Java बिल्डर के कई तरीकों में बदलाव किया गया है, ताकि वे अब void के बजाय अपनी क्लास के इंस्टेंस को सही तरीके से दिखाएं.

Web

बदलावों की ज़रूरत सिर्फ़ तब होती है, जब Agent Platform Gemini API (formerly Vertex AI) के बजाय Gemini Developer API का इस्तेमाल शुरू किया जा रहा हो:

  • सुरक्षा सेटिंग

    • SafetySetting.method के इस्तेमाल को हटाया गया, जो अब काम नहीं करता.
  • इनलाइन डेटा

    • InlineDataPart.videoMetadata के इस्तेमाल को हटाया गया, जो अब काम नहीं करता.

Dart

कोई और बदलाव नहीं.

Unity

"Vertex AI in Firebase" से Unity के लिए सहायता उपलब्ध नहीं थी.

Unity के लिए Firebase AI Logic SDK टूल का इस्तेमाल शुरू करने का तरीका जानें.


Firebase AI Logic के साथ अपने अनुभव के बारे में सुझाव/राय देना या शिकायत करना