শুরু করা যাক: Apple-এর Foundation Models ফ্রেমওয়ার্কের মাধ্যমে Gemini API অ্যাক্সেস করা


WWDC 2026-এ, Apple থার্ড-পার্টি মডেল অ্যাডাপ্টারের জন্য ফাউন্ডেশন মডেল ফ্রেমওয়ার্ক খুলে দিয়েছে, যার অর্থ হল আপনি ডিভাইস-হোস্ট করা মডেল অ্যাক্সেস করার জন্য যে API ব্যবহার করতেন, একই API ব্যবহার করে ফাউন্ডেশন মডেল ফ্রেমওয়ার্কের মাধ্যমে ক্লাউড-হোস্ট করা মডেল (যেমন Gemini) অ্যাক্সেস করতে পারবেন।

আপনার অ্যাপে, আপনার ব্যবহারের ক্ষেত্রে উপযুক্ত করে তুলতে, আপনার অনুরোধকে অন-ডিভাইস বা ক্লাউড ইনফারেন্সে রাউট করার জন্য আপনি মডেল ইনস্ট্যান্স অদল-বদল করতে পারবেন:

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

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

Gemini মডেলের অ্যাক্সেস সুরক্ষিত রাখতে, এই নির্দেশিকা আপনাকে কীভাবে Firebase App Check সেট-আপ করতে হয় তাও দেখায়, যা এমনকি ডেভেলপমেন্টের সময়ও গুরুত্বপূর্ণ।

পূর্বশর্ত

  • Mac App Store থেকে Xcode 27 ডাউনলোড করুন।

  • Apple প্ল্যাটফর্ম সিমুলেটর বা কোনও ফিজিক্যাল ডিভাইস, দু'টিতেই সংশ্লিষ্ট OS ভার্সন (যেমন, iOS 27) চলতে হবে।

  • SwiftUI ইন্টারফেস ব্যবহার করে Apple প্ল্যাটফর্ম অ্যাপের একটি নতুন Xcode প্রোজেক্ট।

Gemini মডেলের সাথে কাজ করে

Apple-এর ফাউন্ডেশন মডেল ফ্রেমওয়ার্কের সাথে ইন্টিগ্রেশন নিম্নলিখিত Gemini মডেলগুলিতে কাজ করে।

  • সাধারণ উদ্দেশ্যমূলক মডেল

    • gemini-3.1-pro-preview
    • gemini-3.8-flash (এবং এর আগের gemini-3.7-flash, gemini-3.6-flash ও gemini-3.5-flash)
    • gemini-3.5-flash-lite (এবং পুরনো gemini-3.1-flash-lite)

  • ছবি তৈরি করার মডেল

    • gemini-3-pro-image (ওরফে "Nano Banana Pro")
    • gemini-3.1-flash-image (ওরফে "Nano Banana 2")
    • gemini-3.1-flash-lite-image (ওরফে "Nano Banana 2 Lite")

Gemini Live API মডেল কাজ করে না। মনে রাখবেন, Gemini 2.5 মডেলগুলি টেকনিক্যালি কাজ করে, তবে নতুন প্রোজেক্টের জন্য এগুলি সাজেস্ট করা হয় না এবং এই নির্দেশিকায় উল্লেখ করা হয়নি এমন বিশেষ কনফিগারেশন প্রয়োজন হয়।

ধাপ ১: Firebase প্রোজেক্ট তৈরি করুন

এই ইন্টিগ্রেশন এক্সপ্লোর করার জন্য আমরা নতুন Firebase প্রোজেক্ট দিয়ে শুরু করার সাজেশন দিই।

  1. Firebase কনসোলে সাইন-ইন করুন।

  2. নতুন Firebase প্রোজেক্ট তৈরি করুন বিকল্পে ক্লিক করুন।

  3. স্ক্রিনে দেখানো নির্দেশাবলী অনুসরণ করুন। আপনাকে Google Analytics চালু করতে হবে না।

ধাপ ২: Firebase-এর সাথে আপনার অ্যাপ কানেক্ট করা

Firebase-এর সাথে আপনার অ্যাপ কানেক্ট করতে, আপনাকে অবশ্যই নিজের Firebase প্রোজেক্টের সাথে এটি রেজিস্টার করতে হবে এবং আপনার কোডবেসে একটি কনফিগারেশন ফাইল যোগ করতে হবে।

  1. প্রোজেক্ট ওভারভিউ পৃষ্ঠার মাঝখানে, সেট-আপ ওয়ার্কফ্লো লঞ্চ করতে iOS+ আইকনে ক্লিক করুন।

  2. আপনার অ্যাপ রেজিস্টার করুন:

    1. আপনার অ্যাপের বান্ডেল আইডি লিখুন। Xcode-এ আপনি যে প্রোজেক্ট তৈরি করছেন সেটির বান্ডেল আইডির সাথে এটি ম্যাচ করছে কিনা তা ভালোভাবে দেখে নিন।

    2. অ্যাপ রেজিস্টার করুন বিকল্পে ক্লিক করুন।

  3. Firebase কনফিগারেশন ফাইল যোগ করুন। এই ফাইলে Firebase SDK-এর সেটিংস থাকে যা আপনার Firebase প্রোজেক্টের সাথে কানেক্ট করে।

    1. আপনার কনফিগারেশন ফাইল পেতে ডাউনলোড করুন GoogleService-Info.plist বিকল্পে ক্লিক করুন।

    2. GoogleService-Info.plist-কে আপনার Xcode প্রোজেক্টের রুটে সরান এবং সব টার্গেটে এটি যোগ করুন।

    3. Firebase কনসোলে পরবর্তী বিকল্পে ক্লিক করুন।

  4. কনসোলে ওয়ার্কফ্লো আপনার অ্যাপে Firebase SDK যোগ করার জন্য সাধারণ নির্দেশাবলী প্রদান করে। তাই, Firebase AI Logic-এর জন্য নির্দিষ্ট নির্দেশাবলী পেতে এই নির্দেশিকার পরবর্তী ধাপে যান।

ধাপ ৩: আপনার অ্যাপে Firebase লাইব্রেরি যোগ করুন এবং Firebase ইনিশিয়ালাইজ করুন

  1. প্রয়োজনীয় Firebase লাইব্রেরি যোগ করতে Swift Package Manager ব্যবহার করুন:

    1. Xcode-এ, আপনার অ্যাপ প্রোজেক্ট খোলা থাকা অবস্থায়, ফাইল > প্যাকেজ যোগ করুন বিকল্প বেছে নিন।

    2. Firebase Apple SDK রিপোজিটরি URL লিখুন:

      https://github.com/firebase/firebase-ios-sdk

    3. অন্তত 12.19.0 ভার্সন বেছে নিন।

    4. প্যাকেজ যোগ করুন বিকল্পে ক্লিক করুন। Xcode ডিপেন্ডেন্সি সংক্রান্ত সমস্যার সমাধান করবে এবং সেগুলি ডাউনলোড করবে।

    5. প্রম্পট করা হলে, আপনার অ্যাপ টার্গেটে FirebaseAILogic ও FirebaseAppCheck লাইব্রেরি যোগ করুন।

  2. আপনার অ্যাপের মূল এন্ট্রি পয়েন্টে নিচের কোডটি যোগ করে অ্যাপ চালু হওয়ার সময় Firebase-কে ইনিশিয়ালাইজ করুন:

    import SwiftUI
import FirebaseCore

@main
struct YourApp: App {
  init() {
    FirebaseApp.configure()
  }

  var body: some Scene {
    WindowGroup {
      NavigationView {
        ContentView()
      }
    }
  }
}

ধাপ ৪: Firebase পরিষেবা চালু ও সুরক্ষিত করুন

Firebase ব্যবহার করার জন্য আপনার অ্যাপ কনফিগার করা হয়ে গেলে, আপনাকে Firebase AI Logic পরিষেবা চালু করতে হবে এবং Firebase App Check ব্যবহার করে এর সাথে যুক্ত API-এর অ্যাক্সেস সুরক্ষিত করতে হবে।

ধাপ ৪ক: আপনার Firebase প্রোজেক্টে Firebase AI Logic সেট-আপ করুন

  1. Firebase কনসোলে, AI পরিষেবা > AI লজিক বিকল্পে যান।

  2. নির্দেশিত সেট-আপ ওয়ার্কফ্লো চালু করতে শুরু করুন বিকল্পে ক্লিক করুন।

  3. "Gemini API প্রদানকারী" বেছে নিতে বলা হলে, আমরা Gemini Developer API বেছে নেওয়ার সাজেশন দিই, এটি আপনাকে কোনও খরচ ছাড়াই দ্রুত শুরু করতে দেয়।

    পরে যেকোনও সময়, আপনি সবসময় Agent Platform Gemini API (formerly Vertex AI) সেট-আপ করতে পারবেন (এবং বিলিংয়ের জন্য এর প্রয়োজনীয়তা)।

  4. Firebase AI Logic-এর জন্য প্রয়োজনীয় API ও সংশ্লিষ্ট পরিষেবা সেট-আপ করতে ওয়ার্কফ্লোতে চালিয়ে যান।

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

ধাপ ৪খ: লোকাল ডেভেলপমেন্টের জন্য App Check ডিবাগ প্রদানকারী কনফিগার করা

লোকাল ডেভেলপমেন্টের জন্য, App Check এনফোর্সমেন্ট বজায় রেখেও অ্যাটেস্টেশন বাইপাস করতে, আপনাকে App Check ডিবাগ প্রোভাইডার কনফিগার করতে হবে।

  1. আপনার Xcode প্রোজেক্টে, FirebaseAppCheck ইমপোর্ট করুন এবং আগে Firebase কনফিগার করার আগে App Check ডিবাগ প্রোভাইডার ফ্যাক্টরি দিয়ে ইনিশিয়ালাইজ করুন।

    import SwiftUI
import FirebaseCore
import FirebaseAppCheck

@main
struct YourApp: App {
  init() {
    let providerFactory = AppCheckDebugProviderFactory()
    AppCheck.setAppCheckProviderFactory(providerFactory)
    FirebaseApp.configure()
  }

  var body: some Scene {
    WindowGroup {
      NavigationView {
        ContentView()
      }
    }
  }
}

  2. আপনার ডিবাগ টোকেন পান:

    1. সিমুলেটরে বা আপনার টেস্ট ডিভাইসে অ্যাপ লঞ্চ করুন।

    2. Xcode কনসোল খুলুন এবং App Check ডিবাগ টোকেন খুঁজুন। যেমন:

      <Warning> [AppCheckCore][I-GAC004001] App Check debug token: '123a4567-b89c-12d3-e456-789012345678'.

    3. টোকেনটি কপি করুন (যেমন, 123a4567-b89c-12d3-e456-789012345678)।

  3. App Check-এর সাথে আপনার ডিবাগ টোকেন রেজিস্টার করুন:

    1. Firebase কনসোলে, নিরাপত্তা > অ্যাপ চেক > অ্যাপ ট্যাব বিকল্পে যান।

    2. আপনার অ্যাপ খুঁজে নিন, ওভারফ্লো মেনুতে ক্লিক করুন () এবং তারপরে ডিবাগ টোকেন ম্যানেজ করুন বিকল্প বেছে নিন।

    3. আপনার ডিবাগ টোকেন রেজিস্টার করতে অন-স্ক্রিন নির্দেশাবলী অনুসরণ করুন।

ডিবাগ প্রদানকারী সম্পর্কে আরও তথ্য (নতুন ডিবাগ টোকেন কীভাবে পাবেন তা সহ) পেতে, অফিসিয়াল App Check ডকুমেন্ট দেখুন।

ধাপ ৫: আপনার অ্যাপে AI Logic পরিষেবা চালু করা

এই পৃষ্ঠায় প্রদানকারী-নির্দিষ্ট কন্টেন্ট ও কোড দেখতে আপনার Gemini API প্রদানকারীর আইকনে ক্লিক করুন।

Firebase এবং App Check কনফিগার করা হয়ে গেলে, আপনি এখন নিজের অ্যাপে Firebase AI Logic পরিষেবা চালু করতে পারবেন।

import FoundationModels
import FirebaseCore
import FirebaseAILogic

// Initialize the Gemini Developer API backend service.
let ai = FirebaseAI.firebaseAI(backend: .googleAI())
// Initialize a `geminiLanguageModel` with a Gemini model that supports your use case.
let model = ai.geminiLanguageModel(name: "gemini-3.8-flash")

ধাপ ৬: Gemini মডেলে অনুরোধ পাঠান

আপনার অ্যাপে Firebase AI Logic সেট-আপ, সুরক্ষিত ও ইনিশিয়ালাইজ করা থাকলে, আপনি Gemini মডেলে অনুরোধ পাঠানোর জন্য প্রস্তুত।

নিচে দেওয়া উদাহরণে সবচেয়ে প্রাথমিক ধরনের অনুরোধ দেখানো হয়েছে – শুধুমাত্র টেক্সট প্রম্পট থেকে টেক্সট তৈরি করা:

import FoundationModels
import FirebaseCore
import FirebaseAILogic

// Initialize the Gemini Developer API backend service.
let ai = FirebaseAI.firebaseAI(backend: .googleAI())
// Initialize a `geminiLanguageModel` with a Gemini model that supports your use case.
let model = ai.geminiLanguageModel(name: "gemini-3.8-flash")


// Create a session by injecting the model into Apple's `LanguageModelSession`.
let session = LanguageModelSession(model: model)

// Generate a text response to a prompt.
let response = try await session.respond(to: "Write a story about a magic backpack.")
print(response.content)

Gemini মডেল অন্যান্য ধরনের অনুরোধেও কাজ করে, যেমন ছবি ও PDF বিশ্লেষণ করা , স্ট্রাকচার্ড JSON আউটপুট তৈরি করা এবং ছবি তৈরি করা ("Nano Banana" মডেল ব্যবহার করে)। এই ধরনের অনুরোধের উদাহরণ ডকুমেন্ট বা স্যাম্পেল অ্যাপে দেখুন।

উত্তর স্ট্রিম করা

মডেল জেনারেশন থেকে সম্পূর্ণ ফলাফল পাওয়ার জন্য অপেক্ষা না করে, আপনি আরও দ্রুত ইন্টার‍্যাকশন করতে পারেন এবং পরিবর্তে আংশিক ফলাফল ম্যানেজ করার জন্য স্ট্রিমিং ব্যবহার করতে পারেন। উত্তর স্ট্রিম করতে, respond(to:)-এর পরিবর্তে streamResponse(to:) ব্যবহার করুন।

import FoundationModels
import FirebaseCore
import FirebaseAILogic

// Initialize the Gemini Developer API backend service.
let ai = FirebaseAI.firebaseAI(backend: .googleAI())
// Initialize a `geminiLanguageModel` with a Gemini model that supports your use case.
let model = ai.geminiLanguageModel(name: "gemini-3.8-flash")


// Create a session by injecting the model into Apple's `LanguageModelSession`.
let session = LanguageModelSession(model: model)

// Generate a streamed text response to a prompt.
// To stream the response, use `streamResponse(to:)` instead of `respond(to:)`
let stream = session.streamResponse(to: "Write a story about a magic backpack.")
var response = ""
for try await snapshot in stream {
  // The snapshot contains *all* content generated so far.
  response = snapshot.content
}

পরবর্তী ধাপ

  • Apple-এর Foundation Models ফ্রেমওয়ার্কের মাধ্যমে Gemini API অ্যাক্সেস করার সময় উপলভ্য ক্ষমতা এক্সপ্লোর করুন।
  • কীভাবে মডেল কনফিগার করতে হয় তা জানুন, এর মধ্যে রয়েছে চিন্তার লেভেল ("যুক্তি") সেট করা সহ এর উত্তর কন্ট্রোল করা।
  • কীভাবে মডেলকে টুল প্রদান করতে হয়, তার মধ্যে আপ-টু-ডেট তথ্যের জন্য গ্রাউন্ডিং অন্তর্ভুক্ত।
  • Firebase App Check এবং এটি কীভাবে আপনার রিসোর্স সুরক্ষিত রাখে সেই সম্পর্কে আরও জানুন।


মতামত জানান Apple-এর Foundation Models ফ্রেমওয়ার্কের মাধ্যমে Gemini API অ্যাক্সেস করা সম্পর্কে