Firebase AI Logic और इसके क्लाइंट SDK को पहले "Vertex AI in Firebase" कहा जाता था. हमने अपनी सेवाओं और सुविधाओं को बेहतर तरीके से दिखाने के लिए, अपनी सेवाओं का नाम बदलकर Firebase AI Logic कर दिया है और उन्हें फिर से पैकेज किया है. उदाहरण के लिए, अब हम Gemini Developer API के साथ काम करते हैं!
अपने मोबाइल या वेब ऐप्लिकेशन से सीधे तौर पर Google के जनरेटिव एआई मॉडल को सुरक्षित तरीके से ऐक्सेस करने के लिए, अब "Gemini API" सेवा देने वाली कंपनी चुनी जा सकती है. इसके लिए, Vertex AI Gemini API या Gemini Developer API में से किसी एक को चुना जा सकता है. Vertex AI Gemini API, लंबे समय से उपलब्ध है. इसका मतलब है कि अब आपके पास Gemini Developer API का इस्तेमाल करने का विकल्प है. इसमें बिना शुल्क वाला टियर उपलब्ध है. इसमें दर की सीमाएं और कोटा सही तरीके से तय किए गए हैं.
Firebase AI Logic SDK पर माइग्रेट करने के तरीके की खास जानकारी
पहला चरण: अपने ऐप्लिकेशन और इस्तेमाल के उदाहरणों के लिए, सबसे अच्छा "Gemini API" उपलब्ध कराने वाली कंपनी चुनें.
दूसरा चरण: अपना Firebase प्रोजेक्ट सेट अप करें, ताकि Gemini Developer API का इस्तेमाल किया जा सके.
यह सिर्फ़ तब लागू होता है, जब Vertex AI Gemini API की जगह Gemini Developer API का इस्तेमाल किया जा रहा हो.तीसरा चरण: अपने ऐप्लिकेशन में इस्तेमाल की गई लाइब्रेरी को अपडेट करें.
चौथा चरण: अपने ऐप्लिकेशन में, शुरू करने की प्रोसेस को अपडेट करें.
पांचवां चरण: इस्तेमाल की जा रही सुविधाओं के हिसाब से, अपने कोड को अपडेट करें.
पहला चरण: अपने ऐप्लिकेशन के लिए, "Gemini API" की सबसे अच्छी सेवा देने वाली कंपनी चुनें
इस माइग्रेशन के बाद, आपके पास "Gemini API" सेवा देने वाली कंपनी चुनने का विकल्प होगा:
पुराने "Vertex AI in Firebase" एसडीके, सिर्फ़ Vertex AI Gemini API का इस्तेमाल कर सकते थे.
नए Firebase AI Logic SDK टूल की मदद से, यह चुना जा सकता है कि आपको अपने मोबाइल या वेब ऐप्लिकेशन से सीधे किस "Gemini API" सेवा देने वाली कंपनी को कॉल करना है. इसके लिए, Gemini Developer API या Vertex AI Gemini API में से किसी एक को चुना जा सकता है.
दोनों Gemini API प्रोवाइडर के इस्तेमाल के बीच के अंतर की समीक्षा करें. खास तौर पर, इन अंतरों को इन बातों के हिसाब से देखें: काम करने वाली सुविधाएं, कीमत, और दर की सीमाएं. उदाहरण के लिए, Gemini Developer API, Cloud Storage यूआरएल का इस्तेमाल करके फ़ाइलें उपलब्ध कराने की सुविधा नहीं देता. हालांकि, अगर आपको बिना किसी शुल्क के इसके टियर और उचित कोटे का फ़ायदा लेना है, तो यह एक अच्छा विकल्प हो सकता है.
अगर आपको Vertex AI Gemini API का इस्तेमाल जारी रखना है, तो:
अगले चरण को छोड़ें और सीधे अपने ऐप्लिकेशन में लाइब्रेरी को अपडेट करने पर जाएं. इसके बाद, इस गाइड के बाकी चरणों को पूरा करें.अगर आपको Gemini Developer API पर स्विच करना है:
उस एपीआई का इस्तेमाल करने के लिए, अपना Firebase प्रोजेक्ट सेट अप करें. इसके बाद, इस गाइड के बाकी निर्देशों का पालन करें.
दूसरा चरण: अपना Firebase प्रोजेक्ट सेट अप करें, ताकि Gemini Developer API का इस्तेमाल किया जा सके
यह चरण सिर्फ़ तब ज़रूरी है, जब आपको Firebase AI Logic क्लाइंट SDK टूल के साथ Gemini Developer API का इस्तेमाल करना हो. हालांकि, अगर आपको Vertex AI Gemini API का इस्तेमाल जारी रखना है, तो अगले चरण पर जाएं.
ध्यान दें कि आपके प्रोजेक्ट में, "Gemini API" के दोनों प्रोवाइडर को एक साथ चालू किया जा सकता है.
Firebase कंसोल में, Firebase AI Logic पेज पर जाएं.
सेटिंग टैब पर जाएं और Gemini Developer API को चुनें.
Gemini Developer API को चालू करें.
कंसोल यह पक्का करेगा कि ज़रूरी एपीआई चालू हों. साथ ही, आपके Firebase प्रोजेक्ट में Gemini एपीआई पासकोड जनरेट करेगा.
इस Gemini एपीआई कुंजी को अपने ऐप्लिकेशन के कोडबेस में न जोड़ें. ज़्यादा जानें.अपने ऐप्लिकेशन में लाइब्रेरी और इनिशियलाइज़ेशन को अपडेट करने के लिए, इस माइग्रेशन गाइड को पढ़ना जारी रखें.
तीसरा चरण: अपने ऐप्लिकेशन में इस्तेमाल की गई लाइब्रेरी को अपडेट करें
Firebase AI Logic लाइब्रेरी का इस्तेमाल करने के लिए, अपने ऐप्लिकेशन के कोडबेस को अपडेट करें.
Swift
Xcode में, अपना ऐप्लिकेशन प्रोजेक्ट खोलें. इसके बाद, Firebase पैकेज को v11.13.0 या इसके बाद के वर्शन पर अपडेट करें. इसके लिए, इनमें से कोई एक विकल्प इस्तेमाल करें:
पहला विकल्प: सभी पैकेज अपडेट करें: फ़ाइल > पैकेज > पैकेज के नए वर्शन पर अपडेट करें पर जाएं.
दूसरा विकल्प: Firebase को अलग-अलग अपडेट करें: पैकेज डिपेंडेंसी सेक्शन में जाकर, Firebase पैकेज पर जाएं. Firebase पैकेज पर राइट क्लिक करें. इसके बाद, पैकेज अपडेट करें को चुनें.
पक्का करें कि Firebase पैकेज में अब v11.13.0 या उसके बाद का वर्शन दिख रहा हो. अगर ऐसा नहीं होता है, तो पुष्टि करें कि आपने पैकेज से जुड़ी ज़रूरी शर्तों में v11.13.0 या उसके बाद के वर्शन पर अपडेट करने की अनुमति दी हो.
प्रोजेक्ट एडिटर में, अपने ऐप्लिकेशन का टारगेट चुनें. इसके बाद, फ़्रेमवर्क, लाइब्रेरी, और एम्बेड किया गया कॉन्टेंट सेक्शन पर जाएं.
नई लाइब्रेरी जोड़ें: + बटन चुनें. इसके बाद, Firebase पैकेज से FirebaseAI जोड़ें.
अपने ऐप्लिकेशन को माइग्रेट करने के बाद (इस गाइड के बाकी सेक्शन देखें), पक्का करें कि आपने पुरानी लाइब्रेरी हटा दी हो:
FirebaseVertexAI को चुनें और फिर — बटन दबाएं.
Kotlin
अपनी मॉड्यूल (ऐप्लिकेशन-लेवल) 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 BoMimplementation("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.0.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") }अपने Android प्रोजेक्ट को Gradle फ़ाइलों के साथ सिंक करें.
ध्यान दें कि अगर आपको Firebase Android BoM का इस्तेमाल नहीं करना है, तो सिर्फ़ firebase-ai
लाइब्रेरी के लिए डिपेंडेंसी जोड़ें. साथ ही, Android Studio की ओर से सुझाए गए नए वर्शन को स्वीकार करें.
Java
अपनी मॉड्यूल (ऐप्लिकेशन-लेवल) 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 BoMimplementation("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.0.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") }अपने Android प्रोजेक्ट को Gradle फ़ाइलों के साथ सिंक करें.
ध्यान दें कि अगर आपको Firebase Android BoM का इस्तेमाल नहीं करना है, तो सिर्फ़ firebase-ai
लाइब्रेरी के लिए डिपेंडेंसी जोड़ें. साथ ही, Android Studio की ओर से सुझाए गए नए वर्शन को स्वीकार करें.
Web
npm का इस्तेमाल करके, वेब के लिए Firebase JS SDK का नया वर्शन पाएं:
npm i firebase@latest
या
yarn add firebase@latest
आपने लाइब्रेरी को जहां भी इंपोर्ट किया है वहां इंपोर्ट स्टेटमेंट को अपडेट करके,
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
अपनी
pubspec.yaml
फ़ाइल मेंfirebase_ai
पैकेज का इस्तेमाल करने के लिए, इसे अपडेट करें. इसके लिए, अपने फ़्लटर प्रोजेक्ट डायरेक्ट्री से यह कमांड चलाएं:flutter pub add firebase_ai
अपने Flutter प्रोजेक्ट को फिर से बनाएं:
flutter run
ऐप्लिकेशन को माइग्रेट करने के बाद (इस गाइड के बाकी सेक्शन देखें), पक्का करें कि आपने पुराना पैकेज मिटा दिया हो:
flutter pub remove firebase_vertexai
Unity
"Vertex AI in Firebase" से Unity के लिए सहायता उपलब्ध नहीं थी.
Unity के लिए Firebase AI Logic SDK टूल का इस्तेमाल शुरू करने का तरीका जानें.
चौथा चरण: अपने ऐप्लिकेशन में, SDK को शुरू करने की प्रोसेस अपडेट करना
इस पेज पर, Gemini API उपलब्ध कराने वाली कंपनी के हिसाब से कॉन्टेंट और कोड देखने के लिए, उस कंपनी पर क्लिक करें. |
चुने गए एपीआई उपलब्ध कराने वाली कंपनी के लिए, सेवा को शुरू करने के तरीके को अपडेट करें. साथ ही, GenerativeModel
इंस्टेंस बनाएं.
Swift
import FirebaseAI
// 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-2.5-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-2.5-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-2.5-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-2.5-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-2.5-flash');
Unity
"Vertex AI in Firebase" से Unity के लिए सहायता उपलब्ध नहीं थी.
Unity के लिए Firebase AI Logic SDK टूल का इस्तेमाल शुरू करने का तरीका जानें.
ध्यान दें कि इस्तेमाल की जा रही सुविधा के आधार पर, ऐसा हो सकता है कि आपको हमेशा GenerativeModel
इंस्टेंस बनाने की ज़रूरत न पड़े.
- Imagen मॉडल को ऐक्सेस करने के लिए,
ImagenModel
इंस्टेंस बनाएं.
पांचवां चरण: इस्तेमाल की जाने वाली सुविधाओं के हिसाब से कोड अपडेट करना
इस चरण में, उन बदलावों के बारे में बताया गया है जो आपकी ओर से इस्तेमाल की जाने वाली सुविधाओं के आधार पर ज़रूरी हो सकते हैं.
अगर आपने Cloud Storage यूआरएल का इस्तेमाल किया है और इस माइग्रेशन में Gemini Developer API का इस्तेमाल करने के लिए स्विच किया है, तो आपको अपने मल्टीमॉडल अनुरोधों को अपडेट करना होगा, ताकि फ़ाइलों को इनलाइन डेटा के तौर पर शामिल किया जा सके. इसके अलावा, वीडियो के लिए YouTube यूआरएल का इस्तेमाल किया जा सकता है.
Firebase AI Logic SDK टूल को शामिल करने के लिए, अपने कोड में किए जाने वाले बदलावों के बारे में जानने के लिए, यहां दी गई सूचियां देखें.
Swift
कोई अन्य बदलाव नहीं किया गया है.
Kotlin
Live API
- एनम क्लास
ResponseModality
के लिए,UNSPECIFIED
वैल्यू हटाई गई. इसके बजाय,null
का इस्तेमाल करें.
- एनम क्लास
Java
Live API
- एनम क्लास
ResponseModality
के लिए,UNSPECIFIED
वैल्यू हटाई गई. इसके बजाय,null
का इस्तेमाल करें.
- एनम क्लास
Java बिल्डर के अलग-अलग तरीकों में बदलाव किया गया है. अब ये तरीके, शून्य के बजाय अपनी क्लास का इंस्टेंस सही तरीके से दिखाते हैं.
Web
सिर्फ़ तब बदलाव करने होंगे, जब Vertex AI Gemini API के बजाय Gemini Developer API का इस्तेमाल किया जा रहा हो:
सुरक्षा सेटिंग
SafetySetting.method
के ऐसे इस्तेमाल को हटाया गया है जो काम नहीं करता.
इनलाइन डेटा
InlineDataPart.videoMetadata
के ऐसे इस्तेमाल को हटाया गया है जो काम नहीं करता.
Dart
कोई अन्य बदलाव नहीं किया गया है.
Unity
"Vertex AI in Firebase" से Unity के लिए सहायता उपलब्ध नहीं थी.
Unity के लिए Firebase AI Logic SDK टूल का इस्तेमाल शुरू करने का तरीका जानें.
Firebase AI Logic के साथ अपने अनुभव के बारे में सुझाव/राय दें या शिकायत करें