Firebase AI Logic और इसके क्लाइंट SDK टूल को पहले "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 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 यूआरएल का इस्तेमाल करके, हालांकि, अगर आपको इसके बिना शुल्क वाले टियर और तय कोटा का फ़ायदा लेना है, तो यह एक अच्छा विकल्प हो सकता है.
अगर आपको Agent Platform Gemini API (formerly Vertex AI) का इस्तेमाल जारी रखना है
तो अगले चरण को छोड़ें और सीधे अपने ऐप्लिकेशन में लाइब्रेरी अपडेट करें. इसके बाद, इस गाइड में दिए गए बाकी चरण पूरे करें.अगर आपको Gemini Developer APIपर स्विच करना है:
अगले चरण पर जाएं और Firebase प्रोजेक्ट को सेट अप करें, ताकि उस एपीआई का इस्तेमाल किया जा सके, इसके बाद, इस गाइड में दिए गए बाकी चरण पूरे करें.
दूसरा चरण: अपना Firebase प्रोजेक्ट सेट अप करें, ताकि Gemini Developer API का इस्तेमाल किया जा सके
यह चरण सिर्फ़ तब ज़रूरी है, जब Gemini Developer API के साथ Firebase AI Logic क्लाइंट SDK टूल का इस्तेमाल करना हो. _हालांकि, अगर आपको Agent Platform Gemini API (formerly Vertex AI)का इस्तेमाल जारी रखना है, तो अगले चरण पर जाएं._
ध्यान दें कि आपके प्रोजेक्ट में "Gemini API" की सेवा देने वाली दोनों कंपनियों को एक साथ चालू किया जा सकता है.
Firebase console में, एआई सेवाएं > एआई लॉजिक पर जाएं.
सेटिंग टैब पर जाएं और Gemini Developer API चुनें.
Gemini Developer API चालू करें.
कंसोल यह पक्का करेगा कि ज़रूरी एपीआई चालू हों और आपके Firebase प्रोजेक्ट में a Gemini API कुंजी जनरेट करेगा.
इस Gemini API कुंजी को अपने ऐप्लिकेशन के कोडबेस में शामिल न करें. ज़्यादा जानें.लाइब्रेरी और अपने ऐप्लिकेशन में इनिशियलाइज़ेशन अपडेट करने के लिए, माइग्रेशन से जुड़ी इस गाइड में आगे बढ़ें.
तीसरा चरण: अपने ऐप्लिकेशन में इस्तेमाल की गई लाइब्रेरी अपडेट करें
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.17.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.17.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
अपने Flutter प्रोजेक्ट की डायरेक्ट्री से यह कमांड चलाकर, अपनी
pubspec.yamlफ़ाइल मेंfirebase_aiपैकेज का इस्तेमाल करने के लिए अपडेट करें:flutter pub add firebase_ai
अपना Flutter प्रोजेक्ट फिर से बनाएं:
flutter run
अपने ऐप्लिकेशन को माइग्रेट करने के बाद (इस गाइड के बाकी सेक्शन देखें), पक्का करें कि पुराना पैकेज मिटा दिया गया हो:
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 Agent Platform Gemini API backend service (formerly Vertex AI).
// Create a `GenerativeModel` instance with a model that supports your use case.
val model = Firebase.ai(backend = GenerativeBackend.agentPlatform())
.generativeModel("gemini-3.6-flash")
Java
// Initialize the Agent Platform Gemini API backend service (formerly Vertex AI).
// Create a `GenerativeModel` instance with a model that supports your use case.
GenerativeModel ai = FirebaseAI.getInstance(GenerativeBackend.agentPlatform())
.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, AgentPlatformBackend } 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 Agent Platform Gemini API backend service (formerly Vertex AI).
const ai = getAI(firebaseApp, { backend: new AgentPlatformBackend() });
// 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 Agent Platform Gemini API backend service (formerly Vertex AI).
// Create a `GenerativeModel` instance with a model that supports your use case.
final model =
FirebaseAI.agentPlatform().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
सिर्फ़ तब बदलाव करने की ज़रूरत है, जब के बजाय, Gemini Developer API Agent Platform Gemini API (formerly Vertex AI) का इस्तेमाल किया जा रहा हो:
सुरक्षा सेटिंग
- अब काम न करने वाले
SafetySetting.methodके इस्तेमाल हटा दिए गए हैं.
- अब काम न करने वाले
इनलाइन डेटा
- अब काम न करने वाले
InlineDataPart.videoMetadataके इस्तेमाल हटा दिए गए हैं.
- अब काम न करने वाले
Dart
कोई और बदलाव नहीं करना है.
Unity
"Vertex AI in Firebase" से Unity के लिए सहायता उपलब्ध नहीं थी.
Unity के लिए SDK टूल इस्तेमाल करने का तरीका जानेंFirebase AI Logic.
सुझाव/राय देना या शिकायत करना के बारे में अपने अनुभव के साथ Firebase AI Logic