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


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

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

Firebase AI Logic SDK टूल पर माइग्रेट करने का तरीका

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

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

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

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

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

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

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

  • "Vertex AI in Firebase" SDK टूल के पुराने वर्शन में, सिर्फ़ 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 API उदाहरण के लिए, Gemini Developer API फ़ाइलें उपलब्ध कराने की सुविधा के साथ काम नहीं करता. हालांकि, अगर आपको इसके बिना शुल्क वाले टियर और तय कोटा का फ़ायदा चाहिए, तो यह एक अच्छा विकल्प हो सकता है.Cloud Storage

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

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

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

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

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

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

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

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

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

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

Swift

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

    • पहला विकल्प: सभी पैकेज अपडेट करें: फ़ाइल > पैकेज > पैकेज के सबसे नए वर्शन में अपडेट करें पर जाएं.

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

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

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

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

  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:34.16.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:34.16.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 के लिए SDK टूल इस्तेमाल करने का तरीका जानेंFirebase AI Logic.

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

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

चुनी गई एपीआई की सेवा देने वाली कंपनी के लिए, सेवा को इनिशियलाइज़ करने का तरीका अपडेट करें और GenerativeModel इंस्टेंस बनाएं.

Swift


import FirebaseAILogic

// Initialize the Agent Platform Gemini API backend service (fomerly Vertex AI).
let ai = FirebaseAI.firebaseAI(backend: .agentPlatform())

// Create a `GenerativeModel` instance with a model that supports your use case
let model = ai.generativeModel(modelName: "gemini-3.6-flash")

Kotlin


// Initialize the Vertex AI Gemini API backend service.
// Specify `global` as the location to access the model.
// Create a `GenerativeModel` instance with a model that supports your use case.
val model = Firebase.ai(backend = GenerativeBackend.vertexAI(location = "global"))
                        .generativeModel("gemini-3.6-flash")

Java


// Initialize the Vertex AI Gemini API backend service.
// Specify `global` as the location to access the model.
// Create a `GenerativeModel` instance with a model that supports your use case.
GenerativeModel ai = FirebaseAI.getInstance(GenerativeBackend.vertexAI("global"))
        .generativeModel("gemini-3.6-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, VertexAIBackend } 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 Vertex AI Gemini API backend service.
// Specify `global` as the location to access the model.
const ai = getAI(firebaseApp, { backend: new VertexAIBackend('global') });

// Create a `GenerativeModel` instance with a model that supports your use case
const model = getGenerativeModel(ai, { model: "gemini-3.6-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 Vertex AI Gemini API backend service.
// Specify `global` as the location to access the model.
// Create a `GenerativeModel` instance with a model that supports your use case.
final model =
      FirebaseAI.vertexAI(location: 'global').generativeModel(model: 'gemini-3.6-flash');

Unity

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

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

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

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

इस चरण में, उन बदलावों के बारे में बताया गया है जो इस्तेमाल की जाने वाली सुविधाओं के हिसाब से ज़रूरी हो सकते हैं.

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

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

Swift

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

Kotlin

  • Live API

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

Java

  • Live API

    • एनम क्लास 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 के लिए SDK टूल इस्तेमाल करने का तरीका जानेंFirebase AI Logic.


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