FAQ এবং সমস্যা সমাধান

Gemini Developer API এবং Vertex AI Gemini API ব্যবহারের মধ্যে পার্থক্যগুলো কী কী?

নিম্নলিখিত সারণিতে , আপনি কীভাবে সেগুলিতে অ্যাক্সেস করেন তা নির্বিশেষে, সাধারণভাবে দুটি " জেমিনি এপিআই " প্রদানকারীর মধ্যেকার গুরুত্বপূর্ণ পার্থক্যগুলি তালিকাভুক্ত করা হয়েছে:

^দুটি এপিআই প্রদানকারীর পে-অ্যাজ-ইউ-গো মূল্য নির্ধারণ পদ্ধতি ভিন্ন (তাদের নিজ নিজ ডকুমেন্টেশনে আরও জানুন)।

^২ জেমিনি ডেভেলপার এপিআই- এর ফাইলস এপিআই, ফায়ারবেস এআই লজিক এসডিকে-গুলোর মাধ্যমে সমর্থিত নয়।

নিম্নলিখিত সারণিতে দুটি " জেমিনি এপিআই " প্রোভাইডারের জন্য সচরাচর জিজ্ঞাসিত ফিচারগুলোর প্রাপ্যতা তালিকাভুক্ত করা হয়েছে। এই সারণিটি বিশেষভাবে ফায়ারবেস এআই লজিক ক্লায়েন্ট এসডিকে ব্যবহার করার ক্ষেত্রে প্রযোজ্য।

আমি কি জেমিনি ডেভেলপার এপিআই এবং ভার্টেক্স এআই জেমিনি এপিআই উভয়ই ব্যবহার করতে পারি?

হ্যাঁ, আপনি আপনার Firebase প্রজেক্টে উভয় ' Gemini API ' প্রোভাইডারই সক্রিয় রাখতে পারেন এবং আপনার অ্যাপের মধ্যেই উভয় API ব্যবহার করতে পারেন।

আপনার কোডে এপিআই প্রোভাইডার পরিবর্তন করতে, শুধু নিশ্চিত করুন যে আপনি আপনার কোডে ব্যাকএন্ড সার্ভিসটি যথাযথভাবে সেট করেছেন ।

প্রয়োজনীয় এপিআইগুলো কী কী? এবং সেগুলো কীভাবে সক্রিয় করতে হবে?

Vertex AI Gemini API-এর সাথে Firebase AI Logic SDK ব্যবহার করতে হলে, আপনার প্রজেক্টে নিম্নলিখিত দুটি API সক্রিয় থাকতে হবে:

• ভার্টেক্স এআই এপিআই ( aiplatform.googleapis.com )
• ফায়ারবেস এআই লজিক এপিআই ( firebasevertexai.googleapis.com )

আপনি নিম্নলিখিত বিকল্পগুলির যেকোনো একটি ব্যবহার করে এই API গুলি সক্রিয় করতে পারেন:

• বিকল্প ১ (প্রস্তাবিত) : Firebase কনসোলে কয়েকটি ক্লিকের মাধ্যমে এপিআইগুলো সক্রিয় করুন:

  1. Firebase কনসোলে, AI Services > Firebase AI Logic পেজে যান।

  2. শুরু করতে ক্লিক করুন।

  3. Vertex AI Gemini API দিয়ে কাজ শুরু করতে নির্বাচন করুন।

     এটি একটি নির্দেশিত ওয়ার্কফ্লো চালু করে যা আপনার জন্য দুটি এপিআই সক্রিয় করে। কনসোলটি আপনার ফায়ারবেস এপিআই কী-এর অনুমোদিত তালিকায় ফায়ারবেস এআই লজিক এপিআই-কেও যুক্ত করবে।

• বিকল্প ২ (ম্যানুয়াল; সুপারিশ করা হয় না) : Google Cloud কনসোলে API গুলো সক্রিয় করুন:

  1. এই FAQ এন্ট্রির শীর্ষে থাকা প্রতিটি API লিঙ্কে ক্লিক করুন এবং তারপরে প্রতিটি API-এর পৃষ্ঠায় 'Enable'- এ ক্লিক করুন।

  2. আপনার Firebase API কী-এর allowlist-এ Firebase AI Logic API যোগ করুন।

ফায়ারবেস প্রজেক্টে এপিআই (API) কীভাবে নিষ্ক্রিয় করা যায়?

Firebase AI Logic- এর জন্য, আমরা আপনার নির্বাচিত Gemini API প্রোভাইডার ব্যবহার করার উদ্দেশ্যে আপনার Firebase প্রোজেক্টের সেটআপ যতটা সম্ভব সহজ করার চেষ্টা করি। এর মধ্যে রয়েছে Firebase কনসোলের গাইডেড ওয়ার্কফ্লো-এর মতো নির্দিষ্ট কিছু ধাপে আপনার Firebase প্রোজেক্টে প্রয়োজনীয় API-গুলো সক্রিয় করা।

তবে, যদি আপনি Firebase AI Logic বা Gemini API প্রোভাইডারগুলোর কোনো একটি ব্যবহার না করার সিদ্ধান্ত নেন, তাহলে আপনি আপনার Firebase প্রজেক্টে সংশ্লিষ্ট API-গুলো নিষ্ক্রিয় করে দিতে পারেন।

Firebase AI Logic ব্যবহার করার জন্য কোন কোন অনুমতির প্রয়োজন হতে পারে?

Firebase AI Logic ব্যবহার করার সময় কোন মডেলগুলো সমর্থিত?

সমর্থিত মডেলগুলির তালিকা দেখুন। আমরা প্রায়শই SDK-গুলিতে নতুন বৈশিষ্ট্য যোগ করি, তাই আপডেটের জন্য এই FAQ-টি (পাশাপাশি রিলিজ নোট, ব্লগ এবং সোশ্যাল পোস্টেও) দেখতে থাকুন।

• ফায়ারবেস এআই লজিক নিম্নলিখিত মডেলগুলিকে সমর্থন করে:

  • জেমিনি ডেভেলপার এপিআই

    • জেমিনি এবং ইমাজেন ফাউন্ডেশনের বেশিরভাগ মডেল

    উল্লেখ্য যে, জেমিনি ডেভেলপার এপিআই (এটি যেভাবেই অ্যাক্সেস করা হোক না কেন) শুধুমাত্র নির্দিষ্ট কিছু স্থিতিশীল ইমাজেন মডেল সমর্থন করে।

  • ভার্টেক্স এআই জেমিনি এপিআই

    • জেমিনি এবং ইমাজেন ফাউন্ডেশনের বেশিরভাগ মডেল

• আপনার নির্বাচিত জেমিনি এপিআই প্রোভাইডার নির্বিশেষে, ফায়ারবেস এআই লজিক নিম্নলিখিত মডেলগুলো সমর্থন করে না :

  • সূক্ষ্মভাবে টিউন করা মডেল

  • এমবেডিং মডেল, ভিও মডেল, লাইরিয়া মডেল, রোবোটিক্স মডেল, কম্পিউটার ব্যবহার মডেল, জেমিনি অমনি মডেল, অথবা জেমিনি ফ্ল্যাশ সাইবার মডেল

  • পুরোনো Imagen মডেল বা imagen-3.0-capability-001

মডেলগুলি বন্ধ (অবসরপ্রাপ্ত) হয়ে গেলে কী করতে হবে?

যখন আমরা কোনো স্থিতিশীল মডেল সংস্করণ প্রকাশ করি, তখন আমরা চেষ্টা করি যেন মডেলটি বন্ধ করার আগে সেটি ন্যূনতম এক বছরের জন্য উপলব্ধ থাকে।

একটি মডেলের উৎপাদন বন্ধের তারিখ কোথায় পাওয়া যাবে?

একটি মডেলের উৎপাদন বন্ধের তারিখ খুঁজে বের করার কয়েকটি উপায় নিচে দেওয়া হলো:

• প্রকাশের সময় : আমরা জেমিনি এপিআই প্রোভাইডার ডকুমেন্টেশনে এবং ফায়ারবেস ডকুমেন্টেশনে বিভিন্ন স্থানে প্রতিটি মডেলের প্রত্যাশিত বন্ধের তারিখ উল্লেখ করি ( সমর্থিত মডেল পৃষ্ঠাটি দেখুন)।

• শাটডাউনের তারিখ ঘনিয়ে এলে : গুগল সংশ্লিষ্ট প্রজেক্ট সদস্যদের ইমেল পাঠায়, এবং আমরা রিলিজ নোট ও অন্যান্য চ্যানেলে আসন্ন যেকোনো শাটডাউন সম্পর্কে রিমাইন্ডার পোস্ট করি (উদাহরণস্বরূপ, জেমিনি ১.৫ এবং ১.০ স্টেবল মডেলের শাটডাউন তারিখের রিমাইন্ডার )।

আপনার ব্যবহৃত মডেলটি বন্ধ হয়ে যাওয়ার উপক্রম হলে কী করবেন?

1. একটি উপযুক্ত এবং বর্তমানে সমর্থিত মডেল ও তার মডেলের নাম খুঁজুন।

2. আপনার অ্যাপ বন্ধ হওয়ার তারিখের আগে ব্যবহৃত মডেলের নামটি আপডেট করুন; অন্যথায়, সেই মডেলে করা যেকোনো অনুরোধ 404 ত্রুটির কারণে ব্যর্থ হবে।

   • আপনি যখন একটি GenerativeModel , LiveModel , বা ImagenModel ইনস্ট্যান্স তৈরি করেন , তখন ইনিশিয়ালাইজেশনের সময় মডেলের নাম সেট করেন। Firebase Remote Config ব্যবহার সম্পর্কে নীচের গুরুত্বপূর্ণ সুপারিশটি পর্যালোচনা করতে ভুলবেন না।

   • Firebase AI Logic ব্যবহার করার সময়, সাধারণত মডেলকে কল করে এমন কোনো কোড পরিবর্তন করার প্রয়োজন হয় না।

3. আপনার অ্যাপটি পরীক্ষা করে নিশ্চিত করুন যে প্রতিক্রিয়াগুলো এখনও প্রত্যাশিতই আছে।

ইমাজেন স্থিতিশীল মডেল - বন্ধের তারিখ ও প্রতিস্থাপন

• ২০২৬ সালের ৩০শে জুনের মধ্যেই ইমাজেন-এর সকল মডেল বন্ধ করে দেওয়া হবে।

প্রতিস্থাপন : আপনার অ্যাপগুলিকে জেমিনি ইমেজ মডেল ('ন্যানো ব্যানানা' মডেল) ব্যবহার করার জন্য মাইগ্রেট করুন ।

জেমিনি ২.০ স্থিতিশীল মডেলসমূহ - বন্ধের তারিখ ও প্রতিস্থাপন

• জেমিনি ২.০ ফ্ল্যাশ এবং জেমিনি ২.০ ফ্ল্যাশ-লাইট :

  gemini-2.0-flash-001 (এবং এর স্বয়ংক্রিয়ভাবে আপডেট হওয়া উপনাম gemini-2.0-flash )
  gemini-2.0-flash-lite-001 (এবং এর স্বয়ংক্রিয়ভাবে আপডেট হওয়া উপনাম gemini-2.0-flash-lite )

  • ৬ ফেব্রুয়ারি, ২০২৬: যেসব প্রকল্পে পূর্বে এই মডেলটি ব্যবহার করা হয়নি, সেসব প্রকল্পে এটি আর ব্যবহারের জন্য উপলব্ধ থাকবে না।

  • ৩১ মার্চ, ২০২৬: এই মডেলগুলো বন্ধ হয়ে যাবে।

  উল্লেখ্য যে, স্থিতিশীল Gemini Live API 2.0 মডেলগুলো প্রভাবিত হবে না।

প্রতিস্থাপন : নতুন Gemini 3.x মডেলগুলির (যেমন gemini-3.1-flash-lite ) যেকোনো একটি ব্যবহার শুরু করুন।

জেমিনি ১.৫ ও ১.০ স্থিতিশীল মডেলসমূহ - বন্ধের তারিখ ও প্রতিস্থাপন

• জেমিনি ১.৫ প্রো মডেল:

  • gemini-1.5-pro-002 (এবং gemini-1.5-pro ): ২৪শে সেপ্টেম্বর, ২০২৫
  • gemini-1.5-pro-001 : ২৪ মে, ২০২৫

• জেমিনি ১.৫ ফ্ল্যাশ মডেলসমূহ:

  • gemini-1.5-flash-002 (এবং gemini-1.5-flash ): ২৪শে সেপ্টেম্বর, ২০২৫
  • gemini-1.5-flash-001 : ২৪ মে, ২০২৫

• জেমিনি ১.০ প্রো ভিশন মডেল: ২১ এপ্রিল, ২০২৫ (পূর্বে ০৯ এপ্রিল, ২০২৫ তারিখে নির্ধারিত ছিল)

• জেমিনি ১.০ প্রো মডেল: ২১ এপ্রিল, ২০২৫ (পূর্বে ০৯ এপ্রিল, ২০২৫ তারিখে আসার কথা ছিল)

প্রতিস্থাপন : নতুন Gemini 3.x মডেলগুলির (যেমন gemini-3.1-flash-lite ) যেকোনো একটি ব্যবহার শুরু করুন।

ফায়ারবেস এআই লজিক কি মডেল প্রশিক্ষণের জন্য আমার ডেটা ব্যবহার করে?

ডেটা গভর্নেন্স ও রেসপনসিবল এআই দেখুন।

ব্যবহারকারী প্রতি ব্যবহারের সীমা কীভাবে নির্ধারণ করবেন?

ডিফল্টরূপে, Firebase AI Logic প্রতি ব্যবহারকারীর জন্য অনুরোধের সীমা প্রতি মিনিটে ১০০টি (RPM) নির্ধারণ করে।

আপনি যদি আপনার ব্যবহারকারী-ভিত্তিক রেট লিমিট সমন্বয় করতে চান, তাহলে আপনাকে Firebase AI Logic API-এর কোটা সেটিংস পরিবর্তন করতে হবে।

Firebase AI Logic API কোটা সম্পর্কে আরও জানুন। সেই পৃষ্ঠায়, আপনি আপনার কোটা কীভাবে দেখবেন এবং সম্পাদনা করবেন তাও জানতে পারবেন।

কীভাবে লেটেন্সি এবং টোকেনের অতিরিক্ত ব্যবহার কমানো যায়?

যদি আপনি উচ্চ লেটেন্সি বা উচ্চ টোকেন ব্যবহারের সম্মুখীন হন, তবে সম্ভবত এর কারণ হলো আপনার ব্যবহৃত মডেলের থিঙ্কিং লেভেল কনফিগারেশন ।

জেমিনি ৩ এবং এর পরবর্তী মডেলগুলো সর্বদা একটি অভ্যন্তরীণ 'চিন্তন প্রক্রিয়া' ব্যবহার করে, যা তাদের যুক্তি ও বহু-ধাপের পরিকল্পনা করার ক্ষমতাকে উল্লেখযোগ্যভাবে উন্নত করে। এর ফলে তারা কোডিং, উন্নত গণিত এবং ডেটা বিশ্লেষণের মতো জটিল কাজগুলোর জন্য অত্যন্ত কার্যকর হয়ে ওঠে।

তবে, কাজের ধরনের ওপর নির্ভর করে, সবসময় উচ্চ স্তরের চিন্তাভাবনার প্রয়োজন হয় না এবং আপনি মডেলটিকে নিম্ন স্তরের চিন্তাভাবনা ব্যবহার করার জন্য কনফিগার করতে পারেন। নিম্ন স্তরের চিন্তাভাবনা ল্যাটেন্সি এবং টোকেন ব্যবহার কমাতে সাহায্য করবে। একটি মডেলের তার চিন্তাভাবনার ক্ষমতা কতটা প্রয়োজন হতে পারে, তা নির্ধারণে আপনাকে সাহায্য করার জন্য, কাজের জটিলতার তুলনাটি পর্যালোচনা করুন।

উল্লেখ্য যে, বেশিরভাগ জেমিনি ৩ এবং এর পরবর্তী মডেলগুলোতে ডিফল্ট চিন্তার স্তর ' HIGH তে সেট করা থাকে।

আমার মাল্টিমোডাল অনুরোধগুলিতে (যেমন ছবি, পিডিএফ, ভিডিও এবং অডিও ইনপুটের জন্য) কি MIME টাইপ প্রয়োজন?

হ্যাঁ, প্রতিটি মাল্টিমোডাল অনুরোধে আপনাকে অবশ্যই নিম্নলিখিতগুলি প্রদান করতে হবে:

• ফাইলটির mimeType । নিচে একটি ব্যতিক্রম দেখুন।

• ফাইলটি। আপনি ফাইলটি ইনলাইন ডেটা হিসেবে অথবা এর URL ব্যবহার করে প্রদান করতে পারেন।

‘সমর্থিত ইনপুট ফাইল এবং প্রয়োজনীয়তা’ অংশে সমর্থিত ইনপুট ফাইলের প্রকারভেদ, MIME টাইপ কীভাবে নির্দিষ্ট করতে হয় এবং ফাইল প্রদানের দুটি বিকল্প সম্পর্কে জানুন।

আপনার অনুরোধে MIME টাইপ অন্তর্ভুক্ত করার ক্ষেত্রে ব্যতিক্রম

নেটিভ অ্যান্ড্রয়েড এবং অ্যাপল প্ল্যাটফর্ম অ্যাপ থেকে করা অনুরোধের ক্ষেত্রে ইনলাইন ইমেজ ইনপুটের জন্য MIME টাইপ প্রদান করার প্রয়োজন হয় না।

অ্যান্ড্রয়েড এবং অ্যাপল প্ল্যাটফর্মের জন্য ফায়ারবেস এআই লজিক এসডিকে (Firebase AI Logic SDK) রিকোয়েস্টে ছবি হ্যান্ডেল করার একটি সরলীকৃত এবং প্ল্যাটফর্ম-বান্ধব উপায় প্রদান করে — সার্ভারে পাঠানোর আগে সমস্ত ছবি (সেগুলোর ফরম্যাট যাই হোক না কেন) ক্লায়েন্ট-সাইডে ৮০% কোয়ালিটির JPEG-এ রূপান্তরিত হয়। এর মানে হলো , যখন আপনি অ্যান্ড্রয়েড এবং অ্যাপল প্ল্যাটফর্মের এসডিকে ব্যবহার করে ইনলাইন ডেটা হিসেবে ছবি প্রদান করেন, তখন রিকোয়েস্টে MIME টাইপ উল্লেখ করার প্রয়োজন হয় না ।

এই সরলীকৃত পরিচালনা পদ্ধতিটি ফায়ারবেস এআই লজিক ডকুমেন্টেশনে, অনুরোধে বেস৬৪-এনকোডেড ছবি পাঠানোর উদাহরণগুলিতে দেখানো হয়েছে।

এই ফিচারটি সম্পর্কে এখানে কিছু অতিরিক্ত প্ল্যাটফর্ম-ভিত্তিক তথ্য দেওয়া হলো:

• অ্যান্ড্রয়েডের জন্য :

  • যেসব মাল্টিমোডাল প্রম্পটে ইনলাইন ডেটা হিসেবে ছবি থাকে, সেগুলোতে প্ল্যাটফর্ম-নেটিভ ছবির ধরন ( Bitmap ) পরিচালনা করার সরলীকৃত পদ্ধতির সুবিধা আপনি নিতে পারেন ( উদাহরণ দেখুন)।

  • ইমেজ ফরম্যাট এবং রূপান্তরের উপর আরও বেশি নিয়ন্ত্রণের জন্য, আপনি ইমেজগুলিকে একটি InlineDataPart হিসাবে প্রদান করতে পারেন এবং নির্দিষ্ট MIME টাইপ সরবরাহ করতে পারেন। উদাহরণস্বরূপ:

    content { inlineData(/* PNG as byte array */, "image/png") }

• অ্যাপল প্ল্যাটফর্মের জন্য :

  • যেসব মাল্টিমোডাল প্রম্পটে ইনলাইন ডেটা হিসেবে ছবি থাকে, সেগুলোতে প্ল্যাটফর্ম-নেটিভ ইমেজ টাইপগুলো ( UIImage , NSImage , CIImage , এবং CGImage ) পরিচালনা করার সরলীকৃত পদ্ধতির সুবিধা আপনি নিতে পারেন ( উদাহরণ দেখুন)।

  • ইমেজ ফরম্যাট এবং রূপান্তরের উপর আরও বেশি নিয়ন্ত্রণের জন্য, আপনি ইমেজগুলিকে একটি InlineDataPart হিসাবে প্রদান করতে পারেন এবং নির্দিষ্ট MIME টাইপ সরবরাহ করতে পারেন। উদাহরণস্বরূপ:

    InlineDataPart(data: Data(/* PNG Data */), mimeType: "image/png")

ফায়ারবেস এআই লজিক ব্যবহার করার সময় এই বৈশিষ্ট্যগুলি কি পাওয়া যায়: গুগল ইমেজ সার্চের সাথে গ্রাউন্ডিং, একটি মডেলের ফাইন টিউনিং, এমবেডিং তৈরি এবং সিমান্টিক রিট্রিভাল?

নিম্নলিখিত বৈশিষ্ট্যগুলি বিভিন্ন মডেল এবং এপিআই প্রদানকারী দ্বারা সমর্থিত, কিন্তু Firebase AI Logic ব্যবহার করার সময় সেগুলি উপলব্ধ নয় :

• গুগল ইমেজ সার্চের মাধ্যমে ভিত্তি স্থাপন
• একটি মডেলের সূক্ষ্ম সমন্বয়
• এমবেডিং জেনারেশন
• শব্দার্থিক পুনরুদ্ধার

আপনি যদি এগুলোকে ফিচার রিকোয়েস্ট হিসেবে যোগ করতে চান অথবা বিদ্যমান কোনো ফিচার রিকোয়েস্টে ভোট দিতে চান, তাহলে Firebase UserVoice-এ যান।

কেন নাম ' Vertex AI in Firebase ' থেকে ' Firebase AI Logic'- এ পরিবর্তন করা হলো?

২০২৪ সালে, আমরা একগুচ্ছ ফায়ারবেস ক্লায়েন্ট SDK চালু করেছিলাম যা ভার্টেক্স এআই জেমিনি এপিআই ব্যবহার করতে পারত। এর সাথে ছিল একটি ফায়ারবেস প্রক্সি গেটওয়ে, যা এপিআই-কে অপব্যবহার থেকে রক্ষা করত এবং অন্যান্য ফায়ারবেস প্রোডাক্টের সাথে ইন্টিগ্রেশন সক্ষম করত। আমরা আমাদের প্রোডাক্টের নাম দিয়েছিলাম "ভার্টেক্স এআই ইন ফায়ারবেস", এবং এই নামটি সেই সময়ে আমাদের প্রোডাক্টের উপলব্ধ ব্যবহারের ক্ষেত্রগুলোকে সঠিকভাবে বর্ণনা করেছিল।

তবে, তারপর থেকে আমরা আমাদের পণ্যের সক্ষমতা বাড়িয়েছি। উদাহরণস্বরূপ, ২০২৫ সালের মে মাস থেকে আমরা এখন জেমিনি ডেভেলপার এপিআই (Gemini Developer API)-এর জন্য সমর্থন প্রদান করছি, যার মধ্যে Firebase App Check -এর সাথে আমাদের ইন্টিগ্রেশন ব্যবহার করে জেমিনি ডেভেলপার এপিআই-কে অপব্যবহার থেকে সুরক্ষিত রাখার সক্ষমতাও অন্তর্ভুক্ত রয়েছে।

ফলস্বরূপ, 'Vertex AI in Firebase' নামটি আর আমাদের পণ্যের বর্ধিত পরিধিকে সঠিকভাবে উপস্থাপন করে না। তাই, একটি নতুন নাম — Firebase AI Logic — আমাদের ক্রমবিকাশমান ফিচার সেটকে আরও ভালোভাবে প্রতিফলিত করে এবং ভবিষ্যতে আমাদের পরিষেবা আরও প্রসারিত করার সুযোগ করে দেয়!

Firebase AI Logic- এর সব লেটেস্ট ফিচার পেতে (এবং চাইলে Gemini Developer API ব্যবহার শুরু করতে) মাইগ্রেশন গাইডটি দেখে নিন।

অ্যাপল প্ল্যাটফর্মের সুইফট অ্যাপের ক্ষেত্রে, মডিউলের নাম FirebaseAI থেকে FirebaseAILogic এ পরিবর্তন হলে কী করতে হবে?

অ্যাপল প্ল্যাটফর্ম অ্যাপের জন্য, Firebase SDK v12.5.0 থেকে শুরু করে, Firebase AI Logic এখন FirebaseAILogic মডিউলের অধীনে বিতরণ করা হচ্ছে। আমরা এই পরিবর্তনটি এমনভাবে করেছি যাতে এটি কোনো সমস্যা তৈরি না করে এবং পূর্ববর্তী সংস্করণগুলোর সাথে সামঞ্জস্যপূর্ণ থাকে।

আমরা কেন এই পরিবর্তনটি করলাম?

আমরা পূর্বে এই পরিষেবাটি FirebaseAI মডিউলের অধীনে বিতরণ করতাম। তবে, নিম্নলিখিত কারণগুলোর জন্য আমাদের এটির নাম পরিবর্তন করে FirebaseAILogic রাখতে হয়েছে:

• মডিউল এবং ক্লাসের মধ্যে নামের সংঘর্ষ এড়িয়ে চলুন, যা বাইনারি ডিস্ট্রিবিউশনে সমস্যা সৃষ্টি করে।

• ভবিষ্যৎ ফিচার উন্নয়নের জন্য আমাদেরকে সুইফট ম্যাক্রো ব্যবহার করার সুযোগ দিন।

v12.5.0+ সংস্করণে আপগ্রেড করলে কী করতে হবে?

মডিউলের নাম পরিবর্তন করে FirebaseAILogic রাখায় কোনো সমস্যা হবে না এবং এটি পূর্ববর্তী সংস্করণের সাথে সামঞ্জস্যপূর্ণ। তবে, ভবিষ্যতে Firebase SDK-এর কোনো বড় ধরনের পরিবর্তনমূলক রিলিজের সাথে আমরা পুরোনো মডিউলটি সরিয়ে ফেলতে পারি (এর সময়সীমা বর্তমানে অনির্ধারিত) ।

এই মডিউলের নাম পরিবর্তনের জন্য কোনো পরিবর্তনের প্রয়োজন নেই , তবে আমরা আপনাকে নিম্নলিখিত কাজগুলো করার পরামর্শ দিচ্ছি :

1. Swift PM ডিপেন্ডেন্সি বেছে নেওয়ার সময়, FirebaseAI এর পরিবর্তে FirebaseAILogic বেছে নিন।

2. ইম্পোর্ট স্টেটমেন্টগুলো FirebaseAI এর পরিবর্তে FirebaseAILogic এ পরিবর্তন করুন।

জেমিনি এপিআই কী কী?

জেমিনি ডেভেলপার এপিআই কলারকে অনুমোদন দেওয়ার জন্য একটি ' জেমিনি এপিআই কী' ব্যবহার করে। তাই, আপনি যদি ফায়ারবেস এআই লজিক এসডিকে-এর মাধ্যমে জেমিনি ডেভেলপার এপিআই ব্যবহার করেন, তাহলে সেই এপিআই-তে কল করার জন্য আপনার ফায়ারবেস প্রজেক্টে একটি বৈধ জেমিনি এপিআই কী থাকা প্রয়োজন।

" জেমিনি এপিআই কী" বলতে এমন একটি এপিআই কী বোঝায়, যার এপিআই অনুমোদিত তালিকায় জেমিনি ডেভেলপার এপিআই অন্তর্ভুক্ত রয়েছে।

আপনি যখন Firebase কনসোলে Firebase AI Logic সেটআপ ওয়ার্কফ্লো অনুসরণ করেন, তখন আমরা একটি Gemini API কী তৈরি করি যা শুধুমাত্র Gemini Developer API-এর জন্য সীমাবদ্ধ থাকে, এবং এই API কী ব্যবহার করার জন্য আমরা Firebase AI Logic প্রক্সি সার্ভিসটি সেটআপ করি। Google Cloud কনসোলের ক্রেডেনশিয়ালস পেজে, Firebase দ্বারা তৈরি এই Gemini API কী-টির নাম থাকে Gemini Developer API key (auto created by Firebase) ।

এপিআই কী-এর সীমাবদ্ধতা সম্পর্কে আরও জানুন।

Firebase AI Logic SDK ব্যবহার করার সময় আপনাকে আপনার অ্যাপের কোডবেসে আপনার Gemini API কী যোগ করতে হবে না । আপনার Gemini API কী সুরক্ষিত রাখার উপায় সম্পর্কে আরও জানুন।

আমার কি জেমিনি এপিআই কী-টি আমার মোবাইল অ্যাপের কোডবেসে নাকি ওয়েব অ্যাপে যোগ করা উচিত?

Firebase AI Logic SDK ব্যবহার করার সময়, আপনার অ্যাপের কোডবেসে আপনার Gemini API কী যোগ করবেন না ।

প্রকৃতপক্ষে, Firebase AI Logic SDK ব্যবহার করে ডেভেলপ করার সময়, আপনি সরাসরি আপনার Gemini API কী ব্যবহার করেন না। এর পরিবর্তে, আমাদের Firebase AI Logic প্রক্সি সার্ভিসটি Gemini Developer API- তে পাঠানো প্রতিটি রিকোয়েস্টে অভ্যন্তরীণভাবে Gemini API কী-টি অন্তর্ভুক্ত করে নেয় — যা সম্পূর্ণভাবে ব্যাকএন্ডে সম্পন্ন হয়।

Gemini Developer API কল করার জন্য ব্যবহৃত Gemini API key আমি কীভাবে পরিবর্তন করতে পারি?

Firebase AI Logic SDK ব্যবহার করার সময়, আপনার Gemini API কী পরিবর্তন করার প্রয়োজন হওয়ার সম্ভাবনা কম। তবে, এখানে দুটি ক্ষেত্র উল্লেখ করা হলো যেখানে আপনার এটি পরিবর্তন করার প্রয়োজন হতে পারে:

• যদি আপনি ভুলবশত কী-টি ফাঁস করে ফেলেন এবং এটিকে একটি নতুন সুরক্ষিত কী দিয়ে প্রতিস্থাপন করতে চান।

• যদি আপনি ভুলবশত কী-টি মুছে ফেলে থাকেন। মনে রাখবেন, মুছে ফেলার ৩০ দিনের মধ্যে আপনি কী-টি পুনরুদ্ধার করতে পারবেন।

Firebase AI Logic SDK-গুলোতে ব্যবহৃত Gemini API কী-টি যেভাবে পরিবর্তন করবেন, তা এখানে দেওয়া হলো:

1. আপনার Firebase থেকে তৈরি করা Gemini API কী-টি যদি এখনও থেকে থাকে, তাহলে সেটি মুছে ফেলুন।

   আপনি Google Cloud কনসোলের APIs & Services > Credentials প্যানেল থেকে এই API কী-টি মুছে ফেলতে পারেন। এটির নাম হলো:
   জেমিনি ডেভেলপার এপিআই কী (ফায়ারবেস দ্বারা স্বয়ংক্রিয়ভাবে তৈরি) ।

2. Google Cloud কনসোলের সেই একই পৃষ্ঠায়, একটি নতুন API কী তৈরি করুন। আমরা এটির নাম নিচের মতো কিছু রাখার পরামর্শ দিচ্ছি:
   ফায়ারবেসের জন্য জেমিনি ডেভেলপার এপিআই কী ।

3. এই নতুন API কী-তে API সীমাবদ্ধতা যোগ করুন এবং শুধুমাত্র জেনারেটিভ ল্যাঙ্গুয়েজ API নির্বাচন করুন।
   Google Cloud কনসোলে জেমিনি ডেভেলপার এপিআই- কে কখনও কখনও "জেনারেটিভ ল্যাঙ্গুয়েজ এপিআই" নামেও ডাকা হয়।

   কোনো অ্যাপ সীমাবদ্ধতা যোগ করবেন না ; অন্যথায় Firebase AI Logic প্রক্সি পরিষেবাটি প্রত্যাশিতভাবে কাজ করবে না।

4. এই নতুন কী-টিকে জেমিনি এপিআই কী হিসেবে সেট করতে নিম্নলিখিত কমান্ডটি চালান, যা ফায়ারবেস এআই লজিক প্রক্সি সার্ভিস ব্যবহার করবে।

   PROJECT_ID="PROJECT_ID"
   GENERATIVE_LANGUAGE_API_KEY="DEVELOPER_CREATED_GEMINI_API_KEY"
   curl \
     -X PATCH \
     -H "x-goog-user-project: ${PROJECT_ID}" \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     -H "Content-Type: application/json" \
     "https://firebasevertexai.googleapis.com/v1beta/projects/${PROJECT_ID}/locations/global/config" \
     -d "{\"generativeLanguageConfig\": {\"apiKey\": \"${GENERATIVE_LANGUAGE_API_KEY}\"}}"
   

   gcloud CLI সম্পর্কে জানুন।

আপনার অ্যাপের কোডবেসে এই নতুন জেমিনি এপিআই কী যোগ না করার বিষয়টি নিশ্চিত করুন। আপনার জেমিনি এপিআই কী সুরক্ষিত রাখার উপায় সম্পর্কে আরও জানুন।

আমি কি আমার "ফায়ারবেস এপিআই কী" জেমিনি এপিআই কী হিসেবে ব্যবহার করতে পারি?

না — আপনার 'ফায়ারবেস এপিআই কী' জেমিনি এপিআই কী হিসেবে ব্যবহার করা উচিত নয় । আমরা দৃঢ়ভাবে সুপারিশ করছি যে আপনি আপনার ফায়ারবেস এপিআই কী-এর অনুমোদিত তালিকায় জেমিনি ডেভেলপার এপিআই যোগ করবেন না ।

আপনার Firebase API কী হলো সেই API কী, যা আপনার Firebase কনফিগারেশন ফাইল বা অবজেক্টে তালিকাভুক্ত থাকে এবং যা আপনি আপনার অ্যাপকে Firebase-এর সাথে সংযোগ করার জন্য অ্যাপের কোডবেসে যোগ করেন। আপনার কোডে Firebase API কী অন্তর্ভুক্ত করা ঠিক আছে , যখন আপনি কী-টি শুধুমাত্র Firebase-সম্পর্কিত API-গুলির (যেমন Firebase AI Logic ) সাথে ব্যবহার করেন । Firebase API কী সম্পর্কে গুরুত্বপূর্ণ তথ্য জানুন ।

Google Cloud কনসোলের APIs & Services > Credentials প্যানেলে , ফায়ারবেস এপিআই কীগুলো দেখতে এইরকম হয়:

যেহেতু Firebase-সম্পর্কিত API-গুলো কাজ করার জন্য আপনার অ্যাপের কোডবেসে আপনার Firebase API কী যোগ করতে হয়, এবং যেহেতু Gemini Developer API-টি API কী-এর মাধ্যমে অনুমোদিত হয়, তাই আমরা দৃঢ়ভাবে সুপারিশ করছি যে আপনি আপনার Firebase API কী-এর জন্য API allowlist-এ Gemini Developer API (যা Google Cloud কনসোলে "Generative Language API" নামে পরিচিত) যোগ করবেন না। যদি আপনি তা করেন, তাহলে আপনি Gemini Developer API-কে সম্ভাব্য অপব্যবহারের ঝুঁকিতে ফেলবেন।

আমি আমার জেমিনি এপিআই কী কীভাবে সুরক্ষিত রাখব?

এই FAQ-তে আপনার Gemini API কী সুরক্ষিত রাখার জন্য কিছু প্রস্তাবিত সর্বোত্তম অনুশীলন বর্ণনা করা হয়েছে।

আপনি যদি আপনার মোবাইল বা ওয়েব অ্যাপ থেকে সরাসরি জেমিনি ডেভেলপার এপিআই কল করেন:

• Firebase AI Logic ক্লায়েন্ট SDK-গুলো ব্যবহার করুন।
• আপনার অ্যাপের কোডবেসে আপনার জেমিনি এপিআই কী যোগ করবেন না ।

Firebase AI Logic একটি প্রক্সি পরিষেবা প্রদান করে, যা সম্পূর্ণরূপে ব্যাকএন্ডে জেমিনি ডেভেলপার এপিআই -এর প্রতিটি অনুরোধে আপনার জেমিনি এপিআই কী অভ্যন্তরীণভাবে অন্তর্ভুক্ত করে।

এছাড়াও, আমরা নিম্নলিখিত বিষয়গুলো জোরালোভাবে সুপারিশ করছি:

• যখনই আপনি গুরুত্ব সহকারে আপনার অ্যাপ তৈরি করা শুরু করবেন, তখনই আপনার ব্যাকএন্ড রিসোর্স এবং জেনারেটিভ মডেল অ্যাক্সেস করতে ব্যবহৃত এপিআইগুলোকে সুরক্ষিত রাখতে Firebase App Check সাথে ইন্টিগ্রেট করুন ।

• Firebase AI Logic- এর বাইরে Firebase দ্বারা তৈরি Gemini API কী পুনরায় ব্যবহার করবেন না । যদি আপনার অন্য কোনো ব্যবহারের জন্য Gemini API কী-এর প্রয়োজন হয়, তবে একটি আলাদা কী তৈরি করুন।

• সাধারণত, আপনার ফায়ারবেস দ্বারা তৈরি জেমিনি এপিআই কী পরিবর্তন করা উচিত নয়। Google Cloud কনসোলে এই কী-টি জেমিনি ডেভেলপার এপিআই কী (ফায়ারবেস দ্বারা স্বয়ংক্রিয়ভাবে তৈরি) নামে থাকে।

  • আপনার Firebase-দ্বারা তৈরি Gemini API কী-এর API allowlist-এ কোনো অতিরিক্ত API যোগ করবেন না । এর API allowlist-এ, আপনার Gemini API কী-তে শুধুমাত্র Gemini Developer API (যা Google Cloud কনসোলে "Generative Language API" নামে পরিচিত) থাকা উচিত।

  • কোনো অ্যাপ সীমাবদ্ধতা যোগ করবেন না ; অন্যথায় Firebase AI Logic প্রক্সি পরিষেবাটি প্রত্যাশিতভাবে কাজ করবে না।

আমার জেমিনি এপিআই কী-টি হ্যাক হয়েছে। এখন আমার কী করা উচিত?

যদি আপনার Gemini API কী-টি অরক্ষিত হয়ে পড়ে, তাহলে Gemini Developer API কল করার জন্য ব্যবহৃত Gemini API কী-টি পরিবর্তন করতে নির্দেশাবলী অনুসরণ করুন।

এছাড়াও, আপনার জেমিনি এপিআই কী সুরক্ষিত রাখতে প্রস্তাবিত সর্বোত্তম অনুশীলনগুলো পর্যালোচনা করুন।