Vertex AI in Firebase SDK-এর পূর্বরূপ সংস্করণ থেকে Firebase AI লজিক SDKগুলিতে স্থানান্তর করুন

সুইফট

1. Xcode-এ, আপনার অ্যাপ প্রজেক্টটি খোলা রেখে, নিম্নলিখিত বিকল্পগুলির মধ্যে যেকোনো একটি ব্যবহার করে আপনার Firebase প্যাকেজটি v11.13.0 বা তার পরবর্তী সংস্করণে আপডেট করুন:

   • বিকল্প ১ : সমস্ত প্যাকেজ আপডেট করুন: ফাইল > প্যাকেজ > সর্বশেষ প্যাকেজ সংস্করণে আপডেট করুন-এ যান।

   • বিকল্প ২ : পৃথকভাবে ফায়ারবেস আপডেট করুন: 'প্যাকেজ ডিপেন্ডেন্সি' নামক বিভাগে ফায়ারবেস প্যাকেজটিতে যান। ফায়ারবেস প্যাকেজটির উপর রাইট-ক্লিক করুন এবং তারপর 'আপডেট প্যাকেজ' নির্বাচন করুন।

2. নিশ্চিত করুন যে Firebase প্যাকেজটিতে এখন v11.13.0 বা তার পরবর্তী সংস্করণ দেখাচ্ছে। যদি তা না দেখায়, তবে যাচাই করুন যে আপনার নির্দিষ্ট করা প্যাকেজ রিকোয়ারমেন্টস (Package Requirements) অনুযায়ী v11.13.0 বা তার পরবর্তী সংস্করণে আপডেট করা যাবে কিনা।

3. প্রজেক্ট এডিটর-এ আপনার অ্যাপের লক্ষ্য নির্বাচন করুন, এবং তারপর ফ্রেমওয়ার্কস, লাইব্রেরিস, এবং এমবেডেড কন্টেন্ট সেকশনে যান।

4. নতুন লাইব্রেরিটি যোগ করুন: + বোতামটি নির্বাচন করুন, এবং তারপরে Firebase প্যাকেজ থেকে FirebaseAI যোগ করুন।

5. আপনার অ্যাপ মাইগ্রেট করা শেষ হলে (এই গাইডের বাকি অংশগুলো দেখুন), পুরোনো লাইব্রেরিটি অবশ্যই মুছে ফেলবেন:
   FirebaseVertexAI-Preview নির্বাচন করুন, এবং তারপর — বোতামটি চাপুন।

Kotlin

1. আপনার মডিউল (অ্যাপ-লেভেল) গ্রেডল ফাইলে (সাধারণত <project>/<app-module>/build.gradle.kts অথবা <project>/<app-module>/build.gradle ), পুরোনো ডিপেন্ডেন্সিগুলো (প্রযোজ্য ক্ষেত্রে) নিম্নলিখিতগুলো দিয়ে প্রতিস্থাপন করুন।

   মনে রাখবেন যে, পুরোনো ডিপেন্ডেন্সিটি ডিলিট করার আগে আপনার অ্যাপের কোডবেস মাইগ্রেট করা আরও সহজ হতে পারে (এই গাইডের বাকি অংশগুলো দেখুন)।

   // BEFORE
   dependencies {
     implementation("com.google.firebase:firebase-vertexai:16.0.0-betaXX")
   }
   
   
   // AFTER
   dependencies {
     // Import the BoM for the Firebase platform
     implementation(platform("com.google.firebase:firebase-bom:34.18.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. আপনার অ্যান্ড্রয়েড প্রজেক্টকে গ্রেডল ফাইলের সাথে সিঙ্ক করুন।

মনে রাখবেন, যদি আপনি Firebase Android BoM ব্যবহার না করার সিদ্ধান্ত নেন, তাহলে শুধু firebase-ai লাইব্রেরির ডিপেন্ডেন্সিটি যোগ করুন এবং Android Studio দ্বারা প্রস্তাবিত সর্বশেষ সংস্করণটি গ্রহণ করুন।

Java

1. আপনার মডিউল (অ্যাপ-লেভেল) গ্রেডল ফাইলে (সাধারণত <project>/<app-module>/build.gradle.kts অথবা <project>/<app-module>/build.gradle ), পুরোনো ডিপেন্ডেন্সিগুলো (প্রযোজ্য ক্ষেত্রে) নিম্নলিখিতগুলো দিয়ে প্রতিস্থাপন করুন।

   মনে রাখবেন যে, পুরোনো ডিপেন্ডেন্সিটি ডিলিট করার আগে আপনার অ্যাপের কোডবেস মাইগ্রেট করা আরও সহজ হতে পারে (এই গাইডের বাকি অংশগুলো দেখুন)।

   // BEFORE
   dependencies {
     implementation("com.google.firebase:firebase-vertexai:16.0.0-betaXX")
   }
   
   
   // AFTER
   dependencies {
     // Import the BoM for the Firebase platform
     implementation(platform("com.google.firebase:firebase-bom:34.18.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. আপনার অ্যান্ড্রয়েড প্রজেক্টকে গ্রেডল ফাইলের সাথে সিঙ্ক করুন।

মনে রাখবেন, যদি আপনি 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-preview";
   
   
   // AFTER
   import { initializeApp } from "firebase/app";
   import { getAI, getGenerativeModel } from "firebase/ai";

Dart

1. আপনার ফ্লাটার প্রজেক্ট ডিরেক্টরি থেকে নিম্নলিখিত কমান্ডটি চালিয়ে আপনার pubspec.yaml ফাইলে firebase_ai প্যাকেজটি ব্যবহার করার জন্য ফাইলটি আপডেট করুন:

   flutter pub add firebase_ai

2. আপনার ফ্লাটার প্রজেক্টটি পুনর্গঠন করুন:

   flutter run

3. আপনার অ্যাপ মাইগ্রেট করা শেষ হলে (এই গাইডের বাকি অংশগুলো দেখুন), পুরোনো প্যাকেজটি ডিলিট করে দিতে ভুলবেন না:

   flutter pub remove firebase_vertexai

ঐক্য

" ফায়ারবেসে ভার্টেক্স এআই " থেকে ইউনিটির জন্য সমর্থন পাওয়া যাচ্ছিল না।

ইউনিটির জন্য ফায়ারবেস এআই লজিক এসডিকে (Firebase AI Logic SDK for Unity) দিয়ে কীভাবে কাজ শুরু করবেন তা জেনে নিন।

সুইফট

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.7-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.7-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.7-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.7-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.7-flash');

ঐক্য

" ফায়ারবেসে ভার্টেক্স এআই " থেকে ইউনিটির জন্য সমর্থন পাওয়া যাচ্ছিল না।

ইউনিটির জন্য ফায়ারবেস এআই লজিক এসডিকে (Firebase AI Logic SDK for Unity) দিয়ে কীভাবে কাজ শুরু করবেন তা জেনে নিন।

সুইফট

• গণনা

  • বেশিরভাগ enum টাইপকে স্ট্যাটিক ভেরিয়েবল সহ struct দিয়ে প্রতিস্থাপন করা হয়েছে। এই পরিবর্তনটি API-কে ব্যাকওয়ার্ড-কম্প্যাটিবল উপায়ে উন্নত করার জন্য আরও বেশি নমনীয়তা প্রদান করে। switch স্টেটমেন্ট ব্যবহার করার সময়, অজানা বা আনহ্যান্ডেলড ভ্যালুগুলো কভার করার জন্য আপনাকে এখন অবশ্যই একটি default: case অন্তর্ভুক্ত করতে হবে, যার মধ্যে ভবিষ্যতে SDK-তে যুক্ত হওয়া নতুন ভ্যালুগুলোও অন্তর্ভুক্ত থাকবে।

  • BlockThreshold এনুমারেশনটির নাম পরিবর্তন করে HarmBlockThreshold রাখা হয়েছে; এই টাইপটি এখন একটি struct ।

  • নিম্নলিখিত এনুমারেশনগুলি (এখন struct s) থেকে unknown এবং unspecified কেসগুলি সরানো হয়েছে: HarmCategory , HarmBlockThreshold , HarmProbability , BlockReason , এবং FinishReason ।

  • পূর্ববর্তী সংস্করণের সাথে সামঞ্জস্যপূর্ণভাবে নতুন টাইপ যুক্ত করার সুযোগ দিতে, ModelContent.Part এনুমারেশনটিকে Part নামক একটি প্রোটোকল দ্বারা প্রতিস্থাপন করা হয়েছে। এই পরিবর্তনটি Content parts বিভাগে আরও বিস্তারিতভাবে বর্ণনা করা হয়েছে।

• বিষয়বস্তুর অংশ

  • মাঝেমধ্যে ঘটা কম্পাইলার ত্রুটি এড়ানোর জন্য ThrowingPartsRepresentable প্রোটোকলটি সরিয়ে দেওয়া হয়েছে এবং ModelContent এর ইনিশিয়ালাইজারগুলোকে সরল করা হয়েছে। যেসব ইমেজ সঠিকভাবে এনকোড হয় না, সেগুলো generateContent এ ব্যবহার করার সময় এখনও ত্রুটি দেখাবে।

  • Part প্রোটোকল মেনে ModelContent.Part কেসগুলোকে নিম্নলিখিত struct টাইপগুলো দ্বারা প্রতিস্থাপন করা হয়েছে:

    • .text to TextPart
    • .data to InlineDataPart
    • .fileData থেকে FileDataPart
    • .functionCall থেকে FunctionCallPart
    • .functionResponse to FunctionResponsePart

• ক্ষতির বিভাগ

  • HarmCategory এখন আর SafetySetting টাইপের মধ্যে নেস্টেড রাখা হবে না। আপনি যদি এটিকে SafetySetting.HarmCategory হিসেবে উল্লেখ করে থাকেন, তবে সেটিকে HarmCategory দিয়ে প্রতিস্থাপন করা যাবে।

• নিরাপত্তা প্রতিক্রিয়া

  • SafetyFeedback টাইপটি সরিয়ে দেওয়া হয়েছে, কারণ এটি কোনো প্রতিক্রিয়ায় ব্যবহৃত হয়নি।

• উদ্ধৃতি মেটাডেটা

  • CitationMetadata তে citationSources প্রপার্টির নাম পরিবর্তন করে citations রাখা হয়েছে।

• মোট বিলযোগ্য অক্ষর

  • CountTokensResponse এর totalBillableCharacters প্রপার্টিটিকে ঐচ্ছিক করা হয়েছে, যাতে কোনো ক্যারেক্টার পাঠানো না হলে সেই পরিস্থিতিও প্রতিফলিত হয়।

• প্রার্থীর প্রতিক্রিয়া

  • অন্যান্য প্ল্যাটফর্মের সাথে সামঞ্জস্য রাখতে CandidateResponse নাম পরিবর্তন করে Candidate রাখা হয়েছে।

• প্রজন্মের কনফিগারেশন

  • GenerationConfig এর পাবলিক প্রপার্টিগুলোকে internal এ পরিবর্তন করা হয়েছে। ইনিশিয়ালাইজারে এগুলো সবই কনফিগারযোগ্য থাকবে।

Kotlin

• গণনা

  • enum ক্লাস এবং sealed ক্লাসগুলোকে সাধারণ ক্লাস দিয়ে প্রতিস্থাপন করা হয়েছে। এই পরিবর্তনটি API-কে পশ্চাৎ সামঞ্জস্যপূর্ণ (backward compatible) উপায়ে বিকশিত করার জন্য আরও বেশি নমনীয়তা প্রদান করে।

  • BlockThreshold এনুমারেশনটির নাম পরিবর্তন করে HarmBlockThreshold রাখা হয়েছে।

  • নিম্নলিখিত এনুমারেশনগুলো থেকে মানগুলো মুছে ফেলা হয়েছে: HarmBlockThreshold , HarmProbability , HarmSeverity , BlockReason , এবং FinishReason ।

• ব্লব পদ্ধতি

  • যেসব মেথডের নামের অংশ হিসেবে Blob অন্তর্ভুক্ত ছিল, সেগুলোর নাম পরিবর্তন করে InlineData ব্যবহার করা হয়েছে।

• নিরাপত্তা সেটিংস

  • ফিল্ড method নালযোগ্য করা হয়েছে।

• সময়কাল শ্রেণী

  • কোটলিনের Duration ক্লাসের সমস্ত ব্যবহার সরিয়ে দিয়ে এর পরিবর্তে long ব্যবহার করা হয়েছে। এই পরিবর্তনটি জাভার সাথে উন্নততর আন্তঃকার্যক্ষমতা প্রদান করে।

• উদ্ধৃতি মেটাডেটা

  • পূর্বে CitationMetadata তে ঘোষিত সমস্ত ফিল্ডকে Citation নামক একটি নতুন ক্লাসের অধীনে আনা হয়েছে। CitationMetadata এর citations নামক তালিকায় সাইটেশনগুলো পাওয়া যাবে। এই পরিবর্তনটি বিভিন্ন প্ল্যাটফর্মে টাইপগুলোর আরও ভালো সামঞ্জস্য বিধান করে।

• টোকেন গণনা করুন

  • totalBillableCharacters ফিল্ডটিকে নাল (null) করা হয়েছে।

• মোট বিলযোগ্য অক্ষর

  • CountTokensResponse এর totalBillableCharacters প্রপার্টিটিকে ঐচ্ছিক করা হয়েছে, যাতে কোনো ক্যারেক্টার পাঠানো না হলে সেই পরিস্থিতিও প্রতিফলিত হয়।

• একটি মডেল ইনস্ট্যানশিয়েট করা

  • অন্যান্য প্ল্যাটফর্মের সাথে সামঞ্জস্য রাখতে requestOptions প্যারামিটারটিকে প্যারামিটার তালিকার শেষে সরানো হয়েছে।

• Live API

  • ResponseModality enum ক্লাসের জন্য UNSPECIFIED ভ্যালুটি সরিয়ে ফেলা হয়েছে। এর পরিবর্তে null ব্যবহার করুন।

  • LiveGenerationConfig.setResponseModalities নাম পরিবর্তন করে LiveGenerationConfig.setResponseModality রাখা হয়েছে।

  • LiveContentResponse.Status ক্লাসটি সরিয়ে দেওয়া হয়েছে এবং এর পরিবর্তে স্ট্যাটাস ফিল্ডগুলোকে LiveContentResponse এর প্রপার্টি হিসেবে নেস্ট করা হয়েছে।

  • LiveContentResponse ক্লাসটি সরিয়ে দেওয়া হয়েছে এবং এর পরিবর্তে LiveServerMessage এর সাবক্লাস দেওয়া হয়েছে যা মডেলের রেসপন্সগুলোর সাথে মেলে।

  • LiveModelFutures.connect কে ListenableFuture<LiveSessionFutures> ListenableFuture<LiveSession> এর পরিবর্তে ListenableFuture<LiveSessionFutures> রিটার্ন করার জন্য পরিবর্তন করা হয়েছে।

Java

• গণনা

  • enum ক্লাস এবং sealed ক্লাসগুলোকে সাধারণ ক্লাস দিয়ে প্রতিস্থাপন করা হয়েছে। এই পরিবর্তনটি API-কে পশ্চাৎ সামঞ্জস্যপূর্ণ (backward compatible) উপায়ে বিকশিত করার জন্য আরও বেশি নমনীয়তা প্রদান করে।

  • BlockThreshold এনুমারেশনটির নাম পরিবর্তন করে HarmBlockThreshold রাখা হয়েছে।

  • নিম্নলিখিত এনুমারেশনগুলো থেকে মানগুলো মুছে ফেলা হয়েছে: HarmBlockThreshold , HarmProbability , HarmSeverity , BlockReason , এবং FinishReason ।

• ব্লব পদ্ধতি

  • যেসব মেথডের নামের অংশ হিসেবে Blob অন্তর্ভুক্ত ছিল, সেগুলোর নাম পরিবর্তন করে InlineData ব্যবহার করা হয়েছে।

• নিরাপত্তা সেটিংস

  • ফিল্ড method নালযোগ্য করা হয়েছে।

• সময়কাল শ্রেণী

  • কোটলিনের Duration ক্লাসের সমস্ত ব্যবহার সরিয়ে দিয়ে এর পরিবর্তে long ব্যবহার করা হয়েছে। এই পরিবর্তনটি জাভার সাথে উন্নততর আন্তঃকার্যক্ষমতা প্রদান করে।

• উদ্ধৃতি মেটাডেটা

  • পূর্বে CitationMetadata তে ঘোষিত সমস্ত ফিল্ডকে Citation নামক একটি নতুন ক্লাসের অধীনে আনা হয়েছে। CitationMetadata এর citations নামক তালিকায় সাইটেশনগুলো পাওয়া যাবে। এই পরিবর্তনটি বিভিন্ন প্ল্যাটফর্মে টাইপগুলোর আরও ভালো সামঞ্জস্য বিধান করে।

• টোকেন গণনা করুন

  • totalBillableCharacters ফিল্ডটিকে নাল (null) করা হয়েছে।

• মোট বিলযোগ্য অক্ষর

  • CountTokensResponse এর totalBillableCharacters প্রপার্টিটিকে ঐচ্ছিক করা হয়েছে, যাতে কোনো ক্যারেক্টার পাঠানো না হলে সেই পরিস্থিতিও প্রতিফলিত হয়।

• একটি মডেল ইনস্ট্যানশিয়েট করা

  • অন্যান্য প্ল্যাটফর্মের সাথে সামঞ্জস্য রাখতে requestOptions প্যারামিটারটিকে প্যারামিটার তালিকার শেষে সরানো হয়েছে।

• Live API

  • ResponseModality enum ক্লাসের জন্য UNSPECIFIED ভ্যালুটি সরিয়ে ফেলা হয়েছে। এর পরিবর্তে null ব্যবহার করুন।

  • LiveGenerationConfig.setResponseModalities নাম পরিবর্তন করে LiveGenerationConfig.setResponseModality রাখা হয়েছে।

  • LiveContentResponse.Status ক্লাসটি সরিয়ে দেওয়া হয়েছে এবং এর পরিবর্তে স্ট্যাটাস ফিল্ডগুলোকে LiveContentResponse এর প্রপার্টি হিসেবে নেস্ট করা হয়েছে।

  • LiveContentResponse ক্লাসটি সরিয়ে দেওয়া হয়েছে এবং এর পরিবর্তে LiveServerMessage এর সাবক্লাস দেওয়া হয়েছে যা মডেলের রেসপন্সগুলোর সাথে মেলে।

  • LiveModelFutures.connect কে ListenableFuture<LiveSessionFutures> ListenableFuture<LiveSession> এর পরিবর্তে ListenableFuture<LiveSessionFutures> রিটার্ন করার জন্য পরিবর্তন করা হয়েছে।

• বিভিন্ন জাভা বিল্ডার মেথড পরিবর্তন করা হয়েছে, যাতে এখন থেকে এগুলো void এর পরিবর্তে সঠিকভাবে তাদের ক্লাসের ইনস্ট্যান্স রিটার্ন করে।

Web

• গণনা

  • নিম্নলিখিত এনুমারেশনগুলো থেকে মানগুলো মুছে ফেলা হয়েছে: HarmCategory , BlockThreshold , HarmProbability , HarmSeverity , BlockReason , এবং FinishReason ।

• ব্লক কারণ

  • PromptFeedback এর blockReason ঐচ্ছিক করা হয়েছে।

শুধুমাত্র তখনই পরিবর্তনগুলি প্রয়োজন হবে, যদি আপনি Agent Platform Gemini API (পূর্বের Vertex AI) -এর পরিবর্তে Gemini Developer API ব্যবহার করা শুরু করেন:

• নিরাপত্তা সেটিংস

  • অসমর্থিত SafetySetting.method এর ব্যবহারগুলো সরিয়ে ফেলা হয়েছে।

• ইনলাইন ডেটা

  • অসমর্থিত InlineDataPart.videoMetadata এর ব্যবহারগুলো সরিয়ে ফেলা হয়েছে।

Dart

• গণনা

  • নিম্নলিখিত এনুমারেশনগুলো থেকে মানগুলো মুছে ফেলা হয়েছে: HarmCategory , HarmProbability , BlockReason , এবং FinishReason ।

• ডেটা অংশ

  • অন্যান্য প্ল্যাটফর্মের সাথে সামঞ্জস্য রাখতে DataPart নাম পরিবর্তন করে InlineDataPart রাখা হয়েছে এবং static data ফাংশনের নাম পরিবর্তন করে inlineData রাখা হয়েছে।

• অনুরোধের বিকল্পগুলি

  • timeout কার্যকর না থাকায় RequestOptions সরিয়ে ফেলা হয়েছে। এটি শীঘ্রই পুনরায় যোগ করা হবে এবং অন্যান্য প্ল্যাটফর্মের সাথে সামঞ্জস্য রাখতে এটিকে GenerativeModel টাইপে স্থানান্তর করা হবে।

• স্টপ সিকোয়েন্স

  • GenerationConfig এর stopSequences প্যারামিটারটিকে ঐচ্ছিক করা হয়েছে এবং এর ডিফল্ট মান একটি খালি অ্যারের পরিবর্তে null রাখা হয়েছে।

• উদ্ধৃতি

  • CitationMetadata তে citationSources প্রপার্টির নাম পরিবর্তন করে citations রাখা হয়েছে। অন্যান্য প্ল্যাটফর্মের সাথে সামঞ্জস্য রাখতে CitationSource টাইপের নাম পরিবর্তন করে Citation রাখা হয়েছে।

• অপ্রয়োজনীয় পাবলিক টাইপ, মেথড এবং প্রোপার্টি

  • অনিচ্ছাকৃতভাবে উন্মুক্ত হয়ে যাওয়া নিম্নলিখিত টাইপ, মেথড এবং প্রোপার্টিগুলো সরিয়ে ফেলা হয়েছে: defaultTimeout , CountTokensResponseFields , parseCountTokensResponse , parseEmbedContentResponse , parseGenerateContentResponse , parseContent , BatchEmbedContentsResponse , ContentEmbedding , EmbedContentRequest , এবং EmbedContentResponse ।

• টোকেন গণনা করুন

  • countTokens ফাংশন থেকে অপ্রয়োজনীয় অতিরিক্ত ফিল্ডগুলো সরিয়ে দেওয়া হয়েছে। এখন শুধু contents ই প্রয়োজন।

• একটি মডেল ইনস্ট্যানশিয়েট করা

  • অন্যান্য প্ল্যাটফর্মের সাথে সামঞ্জস্য রাখতে systemInstruction প্যারামিটারটিকে প্যারামিটার তালিকার শেষে সরানো হয়েছে।

• এমবেডিং কার্যকারিতা

  • মডেল থেকে অসমর্থিত এমবেডিং কার্যকারিতা ( embedContent এবং batchEmbedContents ) সরিয়ে ফেলা হয়েছে।

ঐক্য

" ফায়ারবেসে ভার্টেক্স এআই " থেকে ইউনিটির জন্য সমর্থন পাওয়া যাচ্ছিল না।

ইউনিটির জন্য ফায়ারবেস এআই লজিক এসডিকে (Firebase AI Logic SDK for Unity) দিয়ে কীভাবে কাজ শুরু করবেন তা জেনে নিন।

সুইফট

1. Xcode-এ, আপনার অ্যাপ প্রজেক্টটি খোলা রেখে, নিম্নলিখিত বিকল্পগুলির মধ্যে যেকোনো একটি ব্যবহার করে আপনার Firebase প্যাকেজটি v11.13.0 বা তার পরবর্তী সংস্করণে আপডেট করুন:

   • বিকল্প ১ : সমস্ত প্যাকেজ আপডেট করুন: ফাইল > প্যাকেজ > সর্বশেষ প্যাকেজ সংস্করণে আপডেট করুন-এ যান।

   • বিকল্প ২ : পৃথকভাবে ফায়ারবেস আপডেট করুন: 'প্যাকেজ ডিপেন্ডেন্সি' নামক বিভাগে ফায়ারবেস প্যাকেজটিতে যান। ফায়ারবেস প্যাকেজটির উপর রাইট-ক্লিক করুন এবং তারপর 'আপডেট প্যাকেজ' নির্বাচন করুন।

2. নিশ্চিত করুন যে Firebase প্যাকেজটিতে এখন v11.13.0 বা তার পরবর্তী সংস্করণ দেখাচ্ছে। যদি তা না দেখায়, তবে যাচাই করুন যে আপনার নির্দিষ্ট করা প্যাকেজ রিকোয়ারমেন্টস (Package Requirements) অনুযায়ী v11.13.0 বা তার পরবর্তী সংস্করণে আপডেট করা যাবে কিনা।

3. প্রজেক্ট এডিটর-এ আপনার অ্যাপের লক্ষ্য নির্বাচন করুন, এবং তারপর ফ্রেমওয়ার্কস, লাইব্রেরিস, এবং এমবেডেড কন্টেন্ট সেকশনে যান।

4. নতুন লাইব্রেরিটি যোগ করুন: + বোতামটি নির্বাচন করুন, এবং তারপরে Firebase প্যাকেজ থেকে FirebaseAI যোগ করুন।

5. আপনার অ্যাপ মাইগ্রেট করা শেষ হলে (এই গাইডের বাকি অংশগুলো দেখুন), পুরোনো লাইব্রেরিটি অবশ্যই মুছে ফেলবেন:
   FirebaseVertexAI-Preview নির্বাচন করুন, এবং তারপর — বোতামটি চাপুন।

Kotlin

1. আপনার মডিউল (অ্যাপ-লেভেল) গ্রেডল ফাইলে (সাধারণত <project>/<app-module>/build.gradle.kts অথবা <project>/<app-module>/build.gradle ), পুরোনো ডিপেন্ডেন্সিগুলো (প্রযোজ্য ক্ষেত্রে) নিম্নলিখিতগুলো দিয়ে প্রতিস্থাপন করুন।

   মনে রাখবেন যে, পুরোনো ডিপেন্ডেন্সিটি ডিলিট করার আগে আপনার অ্যাপের কোডবেস মাইগ্রেট করা আরও সহজ হতে পারে (এই গাইডের বাকি অংশগুলো দেখুন)।

   // BEFORE
   dependencies {
     implementation("com.google.firebase:firebase-vertexai:16.0.0-betaXX")
   }
   
   
   // AFTER
   dependencies {
     // Import the BoM for the Firebase platform
     implementation(platform("com.google.firebase:firebase-bom:34.18.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. আপনার অ্যান্ড্রয়েড প্রজেক্টকে গ্রেডল ফাইলের সাথে সিঙ্ক করুন।

মনে রাখবেন, যদি আপনি Firebase Android BoM ব্যবহার না করার সিদ্ধান্ত নেন, তাহলে শুধু firebase-ai লাইব্রেরির ডিপেন্ডেন্সিটি যোগ করুন এবং Android Studio দ্বারা প্রস্তাবিত সর্বশেষ সংস্করণটি গ্রহণ করুন।

Java

1. আপনার মডিউল (অ্যাপ-লেভেল) গ্রেডল ফাইলে (সাধারণত <project>/<app-module>/build.gradle.kts অথবা <project>/<app-module>/build.gradle ), পুরোনো ডিপেন্ডেন্সিগুলো (প্রযোজ্য ক্ষেত্রে) নিম্নলিখিতগুলো দিয়ে প্রতিস্থাপন করুন।

   মনে রাখবেন যে, পুরোনো ডিপেন্ডেন্সিটি ডিলিট করার আগে আপনার অ্যাপের কোডবেস মাইগ্রেট করা আরও সহজ হতে পারে (এই গাইডের বাকি অংশগুলো দেখুন)।

   // BEFORE
   dependencies {
     implementation("com.google.firebase:firebase-vertexai:16.0.0-betaXX")
   }
   
   
   // AFTER
   dependencies {
     // Import the BoM for the Firebase platform
     implementation(platform("com.google.firebase:firebase-bom:34.18.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. আপনার অ্যান্ড্রয়েড প্রজেক্টকে গ্রেডল ফাইলের সাথে সিঙ্ক করুন।

মনে রাখবেন, যদি আপনি 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-preview";
   
   
   // AFTER
   import { initializeApp } from "firebase/app";
   import { getAI, getGenerativeModel } from "firebase/ai";

Dart

1. আপনার ফ্লাটার প্রজেক্ট ডিরেক্টরি থেকে নিম্নলিখিত কমান্ডটি চালিয়ে আপনার pubspec.yaml ফাইলে firebase_ai প্যাকেজটি ব্যবহার করার জন্য ফাইলটি আপডেট করুন:

   flutter pub add firebase_ai

2. আপনার ফ্লাটার প্রজেক্টটি পুনর্গঠন করুন:

   flutter run

3. আপনার অ্যাপ মাইগ্রেট করা শেষ হলে (এই গাইডের বাকি অংশগুলো দেখুন), পুরোনো প্যাকেজটি ডিলিট করে দিতে ভুলবেন না:

   flutter pub remove firebase_vertexai

ঐক্য

" ফায়ারবেসে ভার্টেক্স এআই " থেকে ইউনিটির জন্য সমর্থন পাওয়া যাচ্ছিল না।

ইউনিটির জন্য ফায়ারবেস এআই লজিক এসডিকে (Firebase AI Logic SDK for Unity) দিয়ে কীভাবে কাজ শুরু করবেন তা জেনে নিন।

সুইফট

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.7-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.7-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.7-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.7-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.7-flash');

ঐক্য

" ফায়ারবেসে ভার্টেক্স এআই " থেকে ইউনিটির জন্য সমর্থন পাওয়া যাচ্ছিল না।

ইউনিটির জন্য ফায়ারবেস এআই লজিক এসডিকে (Firebase AI Logic SDK for Unity) দিয়ে কীভাবে কাজ শুরু করবেন তা জেনে নিন।

সুইফট

• গণনা

  • বেশিরভাগ enum টাইপকে স্ট্যাটিক ভেরিয়েবল সহ struct দিয়ে প্রতিস্থাপন করা হয়েছে। এই পরিবর্তনটি API-কে ব্যাকওয়ার্ড-কম্প্যাটিবল উপায়ে উন্নত করার জন্য আরও বেশি নমনীয়তা প্রদান করে। switch স্টেটমেন্ট ব্যবহার করার সময়, অজানা বা আনহ্যান্ডেলড ভ্যালুগুলো কভার করার জন্য আপনাকে এখন অবশ্যই একটি default: case অন্তর্ভুক্ত করতে হবে, যার মধ্যে ভবিষ্যতে SDK-তে যুক্ত হওয়া নতুন ভ্যালুগুলোও অন্তর্ভুক্ত থাকবে।

  • BlockThreshold এনুমারেশনটির নাম পরিবর্তন করে HarmBlockThreshold রাখা হয়েছে; এই টাইপটি এখন একটি struct ।

  • নিম্নলিখিত এনুমারেশনগুলি (এখন struct s) থেকে unknown এবং unspecified কেসগুলি সরানো হয়েছে: HarmCategory , HarmBlockThreshold , HarmProbability , BlockReason , এবং FinishReason ।

  • পূর্ববর্তী সংস্করণের সাথে সামঞ্জস্যপূর্ণভাবে নতুন টাইপ যুক্ত করার সুযোগ দিতে, ModelContent.Part এনুমারেশনটিকে Part নামক একটি প্রোটোকল দ্বারা প্রতিস্থাপন করা হয়েছে। এই পরিবর্তনটি Content parts বিভাগে আরও বিস্তারিতভাবে বর্ণনা করা হয়েছে।

• বিষয়বস্তুর অংশ

  • মাঝেমধ্যে ঘটা কম্পাইলার ত্রুটি এড়ানোর জন্য ThrowingPartsRepresentable প্রোটোকলটি সরিয়ে দেওয়া হয়েছে এবং ModelContent এর ইনিশিয়ালাইজারগুলোকে সরল করা হয়েছে। যেসব ইমেজ সঠিকভাবে এনকোড হয় না, সেগুলো generateContent এ ব্যবহার করার সময় এখনও ত্রুটি দেখাবে।

  • Part প্রোটোকল মেনে ModelContent.Part কেসগুলোকে নিম্নলিখিত struct টাইপগুলো দ্বারা প্রতিস্থাপন করা হয়েছে:

    • .text to TextPart
    • .data to InlineDataPart
    • .fileData থেকে FileDataPart
    • .functionCall থেকে FunctionCallPart
    • .functionResponse to FunctionResponsePart

• ক্ষতির বিভাগ

  • HarmCategory এখন আর SafetySetting টাইপের মধ্যে নেস্টেড রাখা হবে না। আপনি যদি এটিকে SafetySetting.HarmCategory হিসেবে উল্লেখ করে থাকেন, তবে সেটিকে HarmCategory দিয়ে প্রতিস্থাপন করা যাবে।

• নিরাপত্তা প্রতিক্রিয়া

  • SafetyFeedback টাইপটি সরিয়ে দেওয়া হয়েছে, কারণ এটি কোনো প্রতিক্রিয়ায় ব্যবহৃত হয়নি।

• উদ্ধৃতি মেটাডেটা

  • CitationMetadata তে citationSources প্রপার্টির নাম পরিবর্তন করে citations রাখা হয়েছে।

• মোট বিলযোগ্য অক্ষর

  • CountTokensResponse এর totalBillableCharacters প্রপার্টিটিকে ঐচ্ছিক করা হয়েছে, যাতে কোনো ক্যারেক্টার পাঠানো না হলে সেই পরিস্থিতিও প্রতিফলিত হয়।

• প্রার্থীর প্রতিক্রিয়া

  • অন্যান্য প্ল্যাটফর্মের সাথে সামঞ্জস্য রাখতে CandidateResponse নাম পরিবর্তন করে Candidate রাখা হয়েছে।

• প্রজন্মের কনফিগারেশন

  • GenerationConfig এর পাবলিক প্রপার্টিগুলোকে internal এ পরিবর্তন করা হয়েছে। ইনিশিয়ালাইজারে এগুলো সবই কনফিগারযোগ্য থাকবে।

Kotlin

• গণনা

  • enum ক্লাস এবং sealed ক্লাসগুলোকে সাধারণ ক্লাস দিয়ে প্রতিস্থাপন করা হয়েছে। এই পরিবর্তনটি API-কে পশ্চাৎ সামঞ্জস্যপূর্ণ (backward compatible) উপায়ে বিকশিত করার জন্য আরও বেশি নমনীয়তা প্রদান করে।

  • BlockThreshold এনুমারেশনটির নাম পরিবর্তন করে HarmBlockThreshold রাখা হয়েছে।

  • নিম্নলিখিত এনুমারেশনগুলো থেকে মানগুলো মুছে ফেলা হয়েছে: HarmBlockThreshold , HarmProbability , HarmSeverity , BlockReason , এবং FinishReason ।

• ব্লব পদ্ধতি

  • যেসব মেথডের নামের অংশ হিসেবে Blob অন্তর্ভুক্ত ছিল, সেগুলোর নাম পরিবর্তন করে InlineData ব্যবহার করা হয়েছে।

• নিরাপত্তা সেটিংস

  • ফিল্ড method নালযোগ্য করা হয়েছে।

• সময়কাল শ্রেণী

  • কোটলিনের Duration ক্লাসের সমস্ত ব্যবহার সরিয়ে দিয়ে এর পরিবর্তে long ব্যবহার করা হয়েছে। এই পরিবর্তনটি জাভার সাথে উন্নততর আন্তঃকার্যক্ষমতা প্রদান করে।

• উদ্ধৃতি মেটাডেটা

  • পূর্বে CitationMetadata তে ঘোষিত সমস্ত ফিল্ডকে Citation নামক একটি নতুন ক্লাসের অধীনে আনা হয়েছে। CitationMetadata এর citations নামক তালিকায় সাইটেশনগুলো পাওয়া যাবে। এই পরিবর্তনটি বিভিন্ন প্ল্যাটফর্মে টাইপগুলোর আরও ভালো সামঞ্জস্য বিধান করে।

• টোকেন গণনা করুন

  • totalBillableCharacters ফিল্ডটিকে নাল (null) করা হয়েছে।

• মোট বিলযোগ্য অক্ষর

  • CountTokensResponse এর totalBillableCharacters প্রপার্টিটিকে ঐচ্ছিক করা হয়েছে, যাতে কোনো ক্যারেক্টার পাঠানো না হলে সেই পরিস্থিতিও প্রতিফলিত হয়।

• একটি মডেল ইনস্ট্যানশিয়েট করা

  • অন্যান্য প্ল্যাটফর্মের সাথে সামঞ্জস্য রাখতে requestOptions প্যারামিটারটিকে প্যারামিটার তালিকার শেষে সরানো হয়েছে।

• Live API

  • ResponseModality enum ক্লাসের জন্য UNSPECIFIED ভ্যালুটি সরিয়ে ফেলা হয়েছে। এর পরিবর্তে null ব্যবহার করুন।

  • Renamed LiveGenerationConfig.setResponseModalities to LiveGenerationConfig.setResponseModality .

  • Removed the LiveContentResponse.Status class, and instead have nested the status fields as properties of LiveContentResponse .

  • Removed the LiveContentResponse class, and instead have provided subclasses of LiveServerMessage that match the responses from the model.

  • Changed LiveModelFutures.connect to return ListenableFuture<LiveSessionFutures> instead of ListenableFuture<LiveSession> .

Java

• Enumerations

  • Replaced enum classes and sealed classes with regular classes. This change allows more flexibility for evolving the API in a backward compatible way.

  • Renamed the BlockThreshold enumeration to HarmBlockThreshold .

  • Removed values from the following enumerations: HarmBlockThreshold , HarmProbability , HarmSeverity , BlockReason , and FinishReason .

• Blob methods

  • Renamed all methods that included Blob as part of their name to use InlineData instead.

• Safety settings

  • Changed the field method to be nullable.

• Duration class

  • Removed all usages of Kotlin's Duration class, and replaced it with long . This change provides better interoperability with Java.

• Citation metadata

  • Wrapped all the fields previously declared in CitationMetadata into a new class called Citation . Citations can be found in the list called citations in CitationMetadata . This change allows better alignment of types across platforms.

• Count tokens

  • Changed the field totalBillableCharacters to be nullable.

• Total billable characters

  • Changed the totalBillableCharacters property in CountTokensResponse to be optional to reflect situations where no characters are sent.

• Instantiating a model

  • Moved the requestOptions parameter to the end of the parameter list to align with other platforms.

• Live API

  • Removed UNSPECIFIED value for enum class ResponseModality . Instead use null .

  • Renamed LiveGenerationConfig.setResponseModalities to LiveGenerationConfig.setResponseModality .

  • Removed the LiveContentResponse.Status class, and instead have nested the status fields as properties of LiveContentResponse .

  • Removed the LiveContentResponse class, and instead have provided subclasses of LiveServerMessage that match the responses from the model.

  • Changed LiveModelFutures.connect to return ListenableFuture<LiveSessionFutures> instead of ListenableFuture<LiveSession> .

• Changed various Java builder methods to now correctly return the instance of their class, instead of void .

Web

• Enumerations

  • Removed values from the following enumerations: HarmCategory , BlockThreshold , HarmProbability , HarmSeverity , BlockReason , and FinishReason .

• Block reason

  • Changed blockReason in PromptFeedback to be optional.

Changes required only if you're starting to use the Gemini Developer API (instead of the Agent Platform Gemini API (formerly Vertex AI) ):

• Safety settings

  • Removed usages of the unsupported SafetySetting.method .

• Inline data

  • Removed usages of the unsupported InlineDataPart.videoMetadata .

Dart

• Enumerations

  • Removed values from the following enumerations: HarmCategory , HarmProbability , BlockReason , and FinishReason .

• Data part

  • Renamed DataPart to InlineDataPart , and the static data function to inlineData to align with other platforms.

• Request options

  • Removed RequestOptions since timeout wasn't functional. It will be re-added in the near future, but it will be moved to the GenerativeModel type to match other platforms.

• Stop sequences

  • Changed the stopSequences parameter in GenerationConfig to be optional and to default to null instead of an empty array.

• উদ্ধৃতি

  • Renamed the citationSources property to citations in CitationMetadata . The CitationSource type was renamed to Citation to match other platforms.

• Unnecessary public types, methods, and properties

  • Removed the following types, methods, and properties which were unintentionally exposed: defaultTimeout , CountTokensResponseFields , parseCountTokensResponse , parseEmbedContentResponse , parseGenerateContentResponse , parseContent , BatchEmbedContentsResponse , ContentEmbedding , EmbedContentRequest , and EmbedContentResponse .

• Count tokens

  • Removed extra fields from the countTokens function that are no longer necessary. Only contents is needed.

• Instantiating a model

  • Moved the systemInstruction parameter to the end of the parameter list to align with other platforms.

• Embedding functionality

  • Removed unsupported embedding functionality ( embedContent and batchEmbedContents ) from the model.

ঐক্য

Support for Unity wasn't available from " Vertex AI in Firebase ".

Learn how to get started with the Firebase AI Logic SDK for Unity .

সুইফট

1. In Xcode, with your app project open, update your Firebase package to v11.13.0 or later using one of the following options:

   • Option 1 : Update all packages: Navigate to File > Packages > Update to Latest Package Versions .

   • Option 2 : Update Firebase individually: Navigate to the Firebase package in the section called Package Dependencies . Right-click on the Firebase package, and then select Update Package .

2. Make sure that the Firebase package now shows v11.13.0 or later. If it doesn't, verify that your specified Package Requirements allow updating to v11.13.0 or later.

3. Select your app's target in the Project Editor, and then navigate to the Frameworks, Libraries, and Embedded Content section.

4. Add the new library: Select the + button, and then add FirebaseAI from the Firebase package.

5. After you've finished migrating your app (see the remaining sections in this guide), make sure to remove the old library:
   Select FirebaseVertexAI-Preview , and then press the — button.

Kotlin

1. In your module (app-level) Gradle file (usually <project>/<app-module>/build.gradle.kts or <project>/<app-module>/build.gradle ), replace old dependencies (as applicable) with the following.

   Note that it might be easier to migrate your app's codebase (see the remaining sections in this guide) before deleting the old dependency.

   // BEFORE
   dependencies {
     implementation("com.google.firebase:firebase-vertexai:16.0.0-betaXX")
   }
   
   
   // AFTER
   dependencies {
     // Import the BoM for the Firebase platform
     implementation(platform("com.google.firebase:firebase-bom:34.18.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. Sync your Android project with Gradle files.

Note that if you choose to not use the Firebase Android BoM , then just add the dependency for the firebase-ai library and accept the latest version that's suggested by Android Studio.

Java

1. In your module (app-level) Gradle file (usually <project>/<app-module>/build.gradle.kts or <project>/<app-module>/build.gradle ), replace old dependencies (as applicable) with the following.

   Note that it might be easier to migrate your app's codebase (see the remaining sections in this guide) before deleting the old dependency.

   // BEFORE
   dependencies {
     implementation("com.google.firebase:firebase-vertexai:16.0.0-betaXX")
   }
   
   
   // AFTER
   dependencies {
     // Import the BoM for the Firebase platform
     implementation(platform("com.google.firebase:firebase-bom:34.18.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. Sync your Android project with Gradle files.

Note that if you choose to not use the Firebase Android BoM , then just add the dependency for the firebase-ai library and accept the latest version that's suggested by Android Studio.

Web

1. Get the latest version of the Firebase JS SDK for Web using npm:

   npm i firebase@latest

   অথবা

   yarn add firebase@latest

2. Wherever you've imported the library, update your import statements to use firebase/ai instead.

   Note that it might be easier to migrate your app's codebase (see the remaining sections in this guide) before deleting the old imports.

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

Dart

1. Update to the use the firebase_ai package in your pubspec.yaml file by running the following command from your Flutter project directory:

   flutter pub add firebase_ai

2. Rebuild your Flutter project:

   flutter run

3. After you've finished migrating your app (see the remaining sections in this guide), make sure to delete the old package:

   flutter pub remove firebase_vertexai

ঐক্য

Support for Unity wasn't available from " Vertex AI in Firebase ".

Learn how to get started with the Firebase AI Logic SDK for Unity .

সুইফট

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.7-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.7-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.7-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.7-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.7-flash');

ঐক্য

Support for Unity wasn't available from " Vertex AI in Firebase ".

Learn how to get started with the Firebase AI Logic SDK for Unity .

সুইফট

• Enumerations

  • Replaced most enum types with struct s with static variables. This change allows more flexibility for evolving the API in a backward-compatible way. When using switch statements, you must now include a default: case to cover unknown or unhandled values, including new values that are added to the SDK in the future.

  • Renamed the BlockThreshold enumeration to HarmBlockThreshold ; this type is now a struct .

  • Removed unknown and unspecified cases from the following enumerations (now struct s): HarmCategory , HarmBlockThreshold , HarmProbability , BlockReason , and FinishReason .

  • Replaced the enumeration ModelContent.Part with a protocol named Part to allow new types to be added in a backward-compatible way. This change is described in greater detail in the Content parts section.

• Content parts

  • Removed the ThrowingPartsRepresentable protocol, and simplified the initializers for ModelContent to avoid occasional compiler errors. Images that don't encode properly will still throw errors when being used in generateContent .

  • Replaced the ModelContent.Part cases with the following struct types conforming to the Part protocol:

    • .text to TextPart
    • .data to InlineDataPart
    • .fileData to FileDataPart
    • .functionCall to FunctionCallPart
    • .functionResponse to FunctionResponsePart

• Harm category

  • Changed the HarmCategory to no longer be nested in the SafetySetting type. If you're referring to it as SafetySetting.HarmCategory , that can be replaced with HarmCategory .

• Safety feedback

  • Removed the SafetyFeedback type, since it wasn't used in any of the responses.

• Citation metadata

  • Renamed the citationSources property to citations in CitationMetadata .

• Total billable characters

  • Changed the totalBillableCharacters property in CountTokensResponse to be optional to reflect situations where no characters are sent.

• Candidate response

  • Renamed CandidateResponse to Candidate to match other platforms.

• Generation configuration

  • Changed the public properties of GenerationConfig to internal . They all remain configurable in the initializer.

Kotlin

• Enumerations

  • Replaced enum classes and sealed classes with regular classes. This change allows more flexibility for evolving the API in a backward compatible way.

  • Renamed the BlockThreshold enumeration to HarmBlockThreshold .

  • Removed values from the following enumerations: HarmBlockThreshold , HarmProbability , HarmSeverity , BlockReason , and FinishReason .

• Blob methods

  • Renamed all methods that included Blob as part of their name to use InlineData instead.

• Safety settings

  • Changed the field method to be nullable.

• Duration class

  • Removed all usages of Kotlin's Duration class, and replaced it with long . This change provides better interoperability with Java.

• Citation metadata

  • Wrapped all the fields previously declared in CitationMetadata into a new class called Citation . Citations can be found in the list called citations in CitationMetadata . This change allows better alignment of types across platforms.

• Count tokens

  • Changed the field totalBillableCharacters to be nullable.

• Total billable characters

  • Changed the totalBillableCharacters property in CountTokensResponse to be optional to reflect situations where no characters are sent.

• Instantiating a model

  • Moved the requestOptions parameter to the end of the parameter list to align with other platforms.

• Live API

  • Removed UNSPECIFIED value for enum class ResponseModality . Instead use null .

  • Renamed LiveGenerationConfig.setResponseModalities to LiveGenerationConfig.setResponseModality .

  • Removed the LiveContentResponse.Status class, and instead have nested the status fields as properties of LiveContentResponse .

  • Removed the LiveContentResponse class, and instead have provided subclasses of LiveServerMessage that match the responses from the model.

  • Changed LiveModelFutures.connect to return ListenableFuture<LiveSessionFutures> instead of ListenableFuture<LiveSession> .

Java

• Enumerations

  • Replaced enum classes and sealed classes with regular classes. This change allows more flexibility for evolving the API in a backward compatible way.

  • Renamed the BlockThreshold enumeration to HarmBlockThreshold .

  • Removed values from the following enumerations: HarmBlockThreshold , HarmProbability , HarmSeverity , BlockReason , and FinishReason .

• Blob methods

  • Renamed all methods that included Blob as part of their name to use InlineData instead.

• Safety settings

  • Changed the field method to be nullable.

• Duration class

  • Removed all usages of Kotlin's Duration class, and replaced it with long . This change provides better interoperability with Java.

• Citation metadata

  • Wrapped all the fields previously declared in CitationMetadata into a new class called Citation . Citations can be found in the list called citations in CitationMetadata . This change allows better alignment of types across platforms.

• Count tokens

  • Changed the field totalBillableCharacters to be nullable.

• Total billable characters

  • Changed the totalBillableCharacters property in CountTokensResponse to be optional to reflect situations where no characters are sent.

• Instantiating a model

  • Moved the requestOptions parameter to the end of the parameter list to align with other platforms.

• Live API

  • Removed UNSPECIFIED value for enum class ResponseModality . Instead use null .

  • Renamed LiveGenerationConfig.setResponseModalities to LiveGenerationConfig.setResponseModality .

  • Removed the LiveContentResponse.Status class, and instead have nested the status fields as properties of LiveContentResponse .

  • Removed the LiveContentResponse class, and instead have provided subclasses of LiveServerMessage that match the responses from the model.

  • Changed LiveModelFutures.connect to return ListenableFuture<LiveSessionFutures> instead of ListenableFuture<LiveSession> .

• Changed various Java builder methods to now correctly return the instance of their class, instead of void .

Web

• Enumerations

  • Removed values from the following enumerations: HarmCategory , BlockThreshold , HarmProbability , HarmSeverity , BlockReason , and FinishReason .

• Block reason

  • Changed blockReason in PromptFeedback to be optional.

Changes required only if you're starting to use the Gemini Developer API (instead of the Agent Platform Gemini API (formerly Vertex AI) ):

• Safety settings

  • Removed usages of the unsupported SafetySetting.method .

• Inline data

  • Removed usages of the unsupported InlineDataPart.videoMetadata .

Dart

• Enumerations

  • Removed values from the following enumerations: HarmCategory , HarmProbability , BlockReason , and FinishReason .

• Data part

  • Renamed DataPart to InlineDataPart , and the static data function to inlineData to align with other platforms.

• Request options

  • Removed RequestOptions since timeout wasn't functional. It will be re-added in the near future, but it will be moved to the GenerativeModel type to match other platforms.

• Stop sequences

  • Changed the stopSequences parameter in GenerationConfig to be optional and to default to null instead of an empty array.

• উদ্ধৃতি

  • Renamed the citationSources property to citations in CitationMetadata . The CitationSource type was renamed to Citation to match other platforms.

• Unnecessary public types, methods, and properties

  • Removed the following types, methods, and properties which were unintentionally exposed: defaultTimeout , CountTokensResponseFields , parseCountTokensResponse , parseEmbedContentResponse , parseGenerateContentResponse , parseContent , BatchEmbedContentsResponse , ContentEmbedding , EmbedContentRequest , and EmbedContentResponse .

• Count tokens

  • Removed extra fields from the countTokens function that are no longer necessary. Only contents is needed.

• Instantiating a model

  • Moved the systemInstruction parameter to the end of the parameter list to align with other platforms.

• Embedding functionality

  • Removed unsupported embedding functionality ( embedContent and batchEmbedContents ) from the model.

ঐক্য

Support for Unity wasn't available from " Vertex AI in Firebase ".

Learn how to get started with the Firebase AI Logic SDK for Unity .

সুইফট

1. In Xcode, with your app project open, update your Firebase package to v11.13.0 or later using one of the following options:

   • Option 1 : Update all packages: Navigate to File > Packages > Update to Latest Package Versions .

   • Option 2 : Update Firebase individually: Navigate to the Firebase package in the section called Package Dependencies . Right-click on the Firebase package, and then select Update Package .

2. Make sure that the Firebase package now shows v11.13.0 or later. If it doesn't, verify that your specified Package Requirements allow updating to v11.13.0 or later.

3. Select your app's target in the Project Editor, and then navigate to the Frameworks, Libraries, and Embedded Content section.

4. Add the new library: Select the + button, and then add FirebaseAI from the Firebase package.

5. After you've finished migrating your app (see the remaining sections in this guide), make sure to remove the old library:
   Select FirebaseVertexAI-Preview , and then press the — button.

Kotlin

1. In your module (app-level) Gradle file (usually <project>/<app-module>/build.gradle.kts or <project>/<app-module>/build.gradle ), replace old dependencies (as applicable) with the following.

   Note that it might be easier to migrate your app's codebase (see the remaining sections in this guide) before deleting the old dependency.

   // BEFORE
   dependencies {
     implementation("com.google.firebase:firebase-vertexai:16.0.0-betaXX")
   }
   
   
   // AFTER
   dependencies {
     // Import the BoM for the Firebase platform
     implementation(platform("com.google.firebase:firebase-bom:34.18.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. Sync your Android project with Gradle files.

Note that if you choose to not use the Firebase Android BoM , then just add the dependency for the firebase-ai library and accept the latest version that's suggested by Android Studio.

Java

1. In your module (app-level) Gradle file (usually <project>/<app-module>/build.gradle.kts or <project>/<app-module>/build.gradle ), replace old dependencies (as applicable) with the following.

   Note that it might be easier to migrate your app's codebase (see the remaining sections in this guide) before deleting the old dependency.

   // BEFORE
   dependencies {
     implementation("com.google.firebase:firebase-vertexai:16.0.0-betaXX")
   }
   
   
   // AFTER
   dependencies {
     // Import the BoM for the Firebase platform
     implementation(platform("com.google.firebase:firebase-bom:34.18.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. Sync your Android project with Gradle files.

Note that if you choose to not use the Firebase Android BoM , then just add the dependency for the firebase-ai library and accept the latest version that's suggested by Android Studio.

Web

1. Get the latest version of the Firebase JS SDK for Web using npm:

   npm i firebase@latest

   অথবা

   yarn add firebase@latest

2. Wherever you've imported the library, update your import statements to use firebase/ai instead.

   Note that it might be easier to migrate your app's codebase (see the remaining sections in this guide) before deleting the old imports.

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

Dart

1. Update to the use the firebase_ai package in your pubspec.yaml file by running the following command from your Flutter project directory:

   flutter pub add firebase_ai

2. Rebuild your Flutter project:

   flutter run

3. After you've finished migrating your app (see the remaining sections in this guide), make sure to delete the old package:

   flutter pub remove firebase_vertexai

ঐক্য

Support for Unity wasn't available from " Vertex AI in Firebase ".

Learn how to get started with the Firebase AI Logic SDK for Unity .

সুইফট

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.7-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.7-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.7-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.7-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.7-flash');

ঐক্য

Support for Unity wasn't available from " Vertex AI in Firebase ".

Learn how to get started with the Firebase AI Logic SDK for Unity .

সুইফট

• Enumerations

  • Replaced most enum types with struct s with static variables. This change allows more flexibility for evolving the API in a backward-compatible way. When using switch statements, you must now include a default: case to cover unknown or unhandled values, including new values that are added to the SDK in the future.

  • Renamed the BlockThreshold enumeration to HarmBlockThreshold ; this type is now a struct .

  • Removed unknown and unspecified cases from the following enumerations (now struct s): HarmCategory , HarmBlockThreshold , HarmProbability , BlockReason , and FinishReason .

  • Replaced the enumeration ModelContent.Part with a protocol named Part to allow new types to be added in a backward-compatible way. This change is described in greater detail in the Content parts section.

• Content parts

  • Removed the ThrowingPartsRepresentable protocol, and simplified the initializers for ModelContent to avoid occasional compiler errors. Images that don't encode properly will still throw errors when being used in generateContent .

  • Replaced the ModelContent.Part cases with the following struct types conforming to the Part protocol:

    • .text to TextPart
    • .data to InlineDataPart
    • .fileData to FileDataPart
    • .functionCall to FunctionCallPart
    • .functionResponse to FunctionResponsePart

• Harm category

  • Changed the HarmCategory to no longer be nested in the SafetySetting type. If you're referring to it as SafetySetting.HarmCategory , that can be replaced with HarmCategory .

• Safety feedback

  • Removed the SafetyFeedback type, since it wasn't used in any of the responses.

• Citation metadata

  • Renamed the citationSources property to citations in CitationMetadata .

• Total billable characters

  • Changed the totalBillableCharacters property in CountTokensResponse to be optional to reflect situations where no characters are sent.

• Candidate response

  • Renamed CandidateResponse to Candidate to match other platforms.

• Generation configuration

  • Changed the public properties of GenerationConfig to internal . They all remain configurable in the initializer.

Kotlin

• Enumerations

  • Replaced enum classes and sealed classes with regular classes. This change allows more flexibility for evolving the API in a backward compatible way.

  • Renamed the BlockThreshold enumeration to HarmBlockThreshold .

  • Removed values from the following enumerations: HarmBlockThreshold , HarmProbability , HarmSeverity , BlockReason , and FinishReason .

• Blob methods

  • Renamed all methods that included Blob as part of their name to use InlineData instead.

• Safety settings

  • Changed the field method to be nullable.

• Duration class

  • Removed all usages of Kotlin's Duration class, and replaced it with long . This change provides better interoperability with Java.

• Citation metadata

  • Wrapped all the fields previously declared in CitationMetadata into a new class called Citation . Citations can be found in the list called citations in CitationMetadata . This change allows better alignment of types across platforms.

• Count tokens

  • Changed the field totalBillableCharacters to be nullable.

• Total billable characters

  • Changed the totalBillableCharacters property in CountTokensResponse to be optional to reflect situations where no characters are sent.

• Instantiating a model

  • Moved the requestOptions parameter to the end of the parameter list to align with other platforms.

• Live API

  • Removed UNSPECIFIED value for enum class ResponseModality . Instead use null .

  • Renamed LiveGenerationConfig.setResponseModalities to LiveGenerationConfig.setResponseModality .

  • Removed the LiveContentResponse.Status class, and instead have nested the status fields as properties of LiveContentResponse .

  • Removed the LiveContentResponse class, and instead have provided subclasses of LiveServerMessage that match the responses from the model.

  • Changed LiveModelFutures.connect to return ListenableFuture<LiveSessionFutures> instead of ListenableFuture<LiveSession> .

Java

• Enumerations

  • Replaced enum classes and sealed classes with regular classes. This change allows more flexibility for evolving the API in a backward compatible way.

  • Renamed the BlockThreshold enumeration to HarmBlockThreshold .

  • Removed values from the following enumerations: HarmBlockThreshold , HarmProbability , HarmSeverity , BlockReason , and FinishReason .

• Blob methods

  • Renamed all methods that included Blob as part of their name to use InlineData instead.

• Safety settings

  • Changed the field method to be nullable.

• Duration class

  • Removed all usages of Kotlin's Duration class, and replaced it with long . This change provides better interoperability with Java.

• Citation metadata

  • Wrapped all the fields previously declared in CitationMetadata into a new class called Citation . Citations can be found in the list called citations in CitationMetadata . This change allows better alignment of types across platforms.

• Count tokens

  • Changed the field totalBillableCharacters to be nullable.

• Total billable characters

  • Changed the totalBillableCharacters property in CountTokensResponse to be optional to reflect situations where no characters are sent.

• Instantiating a model

  • Moved the requestOptions parameter to the end of the parameter list to align with other platforms.

• Live API

  • Removed UNSPECIFIED value for enum class ResponseModality . Instead use null .

  • Renamed LiveGenerationConfig.setResponseModalities to LiveGenerationConfig.setResponseModality .

  • Removed the LiveContentResponse.Status class, and instead have nested the status fields as properties of LiveContentResponse .

  • Removed the LiveContentResponse class, and instead have provided subclasses of LiveServerMessage that match the responses from the model.

  • Changed LiveModelFutures.connect to return ListenableFuture<LiveSessionFutures> instead of ListenableFuture<LiveSession> .

• Changed various Java builder methods to now correctly return the instance of their class, instead of void .

Web

• Enumerations

  • Removed values from the following enumerations: HarmCategory , BlockThreshold , HarmProbability , HarmSeverity , BlockReason , and FinishReason .

• Block reason

  • Changed blockReason in PromptFeedback to be optional.

Changes required only if you're starting to use the Gemini Developer API (instead of the Agent Platform Gemini API (formerly Vertex AI) ):

• Safety settings

  • Removed usages of the unsupported SafetySetting.method .

• Inline data

  • Removed usages of the unsupported InlineDataPart.videoMetadata .

Dart

• Enumerations

  • Removed values from the following enumerations: HarmCategory , HarmProbability , BlockReason , and FinishReason .

• Data part

  • Renamed DataPart to InlineDataPart , and the static data function to inlineData to align with other platforms.

• Request options

  • Removed RequestOptions since timeout wasn't functional. It will be re-added in the near future, but it will be moved to the GenerativeModel type to match other platforms.

• Stop sequences

  • Changed the stopSequences parameter in GenerationConfig to be optional and to default to null instead of an empty array.

• উদ্ধৃতি

  • Renamed the citationSources property to citations in CitationMetadata . The CitationSource type was renamed to Citation to match other platforms.

• Unnecessary public types, methods, and properties

  • Removed the following types, methods, and properties which were unintentionally exposed: defaultTimeout , CountTokensResponseFields , parseCountTokensResponse , parseEmbedContentResponse , parseGenerateContentResponse , parseContent , BatchEmbedContentsResponse , ContentEmbedding , EmbedContentRequest , and EmbedContentResponse .

• Count tokens

  • Removed extra fields from the countTokens function that are no longer necessary. Only contents is needed.

• Instantiating a model

  • Moved the systemInstruction parameter to the end of the parameter list to align with other platforms.

• Embedding functionality

  • Removed unsupported embedding functionality ( embedContent and batchEmbedContents ) from the model.

ঐক্য

Support for Unity wasn't available from " Vertex AI in Firebase ".

Learn how to get started with the Firebase AI Logic SDK for Unity .