শুরু করুন: অ্যাপলের ফাউন্ডেশন মডেলস ফ্রেমওয়ার্কের মাধ্যমে জেমিনি এপিআই অ্যাক্সেস করুন।


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

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

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

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

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

পূর্বশর্ত

  • সর্বশেষ Xcode 27 বিটা ইনস্টল করুন।

  • একটি অ্যাপল প্ল্যাটফর্ম সিমুলেটর অথবা একটি বাস্তব ডিভাইস, উভয়টিতেই সংশ্লিষ্ট বিটা ওএস সংস্করণটি চলছে (উদাহরণস্বরূপ, আইওএস ২৭ বিটা)।

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

সমর্থিত জেমিনি মডেল

অ্যাপলের ফাউন্ডেশন মডেলস ফ্রেমওয়ার্কের সাথে ইন্টিগ্রেশন নিম্নলিখিত জেমিনি মডেলগুলোকে সাপোর্ট করে।

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

    • gemini-3.1-pro-preview
    • gemini-3.5-flash
    • gemini-3.1-flash-lite

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

    • gemini-3-pro-image (ওরফে "ন্যানো বানানা প্রো")
    • gemini-3.1-flash-image (ওরফে "ন্যানো বানানা ২")

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

ধাপ ১: একটি ফায়ারবেস প্রজেক্ট তৈরি করুন।

এই ইন্টিগ্রেশনটি খতিয়ে দেখার জন্য আমরা একটি নতুন ফায়ারবেস প্রজেক্ট দিয়ে শুরু করার পরামর্শ দিই।

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

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

  3. স্ক্রিনে দেওয়া নির্দেশাবলী অনুসরণ করুন। আপনাকে গুগল অ্যানালিটিক্স চালু করতে হবে না ।

ধাপ ২: আপনার অ্যাপটিকে ফায়ারবেসের সাথে সংযুক্ত করুন।

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

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

  2. আপনার অ্যাপটি নিবন্ধন করুন:

    1. আপনার অ্যাপের বান্ডেল আইডি লিখুন। নিশ্চিত করুন যে এটি এক্সকোডে (Xcode) বিল্ড করা প্রজেক্টের বান্ডেল আইডির সাথে মেলে।

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

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

    1. আপনার কনফিগারেশন ফাইলটি পেতে Download GoogleService-Info.plist এ ক্লিক করুন।

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

    3. Firebase কনসোলে Next-এ ক্লিক করুন।

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

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

  1. প্রয়োজনীয় ফায়ারবেস লাইব্রেরিগুলো যোগ করতে সুইফট প্যাকেজ ম্যানেজার ব্যবহার করুন:

    1. Xcode-এ আপনার অ্যাপ প্রজেক্টটি খোলা রেখে, File > Add Packages নির্বাচন করুন।

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

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

    3. ডিপেন্ডেন্সি রুল হিসেবে ব্রাঞ্চ নির্বাচন করুন এবং wwdc26-preview লিখুন।

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

    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 AI Logic সার্ভিসটি এনাবল করতে হবে এবং Firebase App Check ব্যবহার করে এর সংশ্লিষ্ট API-গুলোতে অ্যাক্সেস সুরক্ষিত করতে হবে।

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

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

  2. নির্দেশিত সেটআপ প্রক্রিয়াটি চালু করতে 'Get started'- এ ক্লিক করুন।

  3. 'জেমিনি এপিআই প্রোভাইডার' বেছে নিতে বলা হলে, আমরা জেমিনি ডেভেলপার এপিআই নির্বাচন করার পরামর্শ দিই, যা আপনাকে কোনো খরচ ছাড়াই দ্রুত কাজ শুরু করতে দেয়।

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

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

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

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

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

  1. আপনার Xcode প্রজেক্টে, Firebase কনফিগার করার আগে FirebaseAppCheck ইম্পোর্ট করুন এবং ডিবাগ প্রোভাইডার ফ্যাক্টরি দিয়ে 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 কনসোলে, Security > App Check > Apps ট্যাবে যান।

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

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

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

ধাপ ৫: আপনার অ্যাপে এআই লজিক পরিষেবাটি চালু করুন।

এই পৃষ্ঠায় প্রদানকারী-নির্দিষ্ট বিষয়বস্তু এবং কোড দেখতে আপনার জেমিনি এপিআই প্রদানকারীর উপর ক্লিক করুন।

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.5-flash")

ধাপ ৬: একজন জেমিনি মডেলকে অনুরোধ পাঠান

আপনার অ্যাপে 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.5-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)

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

প্রতিক্রিয়াটি স্ট্রিম করুন

মডেল জেনারেশনের সম্পূর্ণ ফলাফলের জন্য অপেক্ষা না করে, তার পরিবর্তে আংশিক ফলাফল হ্যান্ডেল করার জন্য স্ট্রিমিং ব্যবহার করে আপনি আরও দ্রুত ইন্টারঅ্যাকশন করতে পারেন। রেসপন্স স্ট্রিম করতে, 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.5-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
}

পরবর্তী পদক্ষেপ


অ্যাপলের ফাউন্ডেশন মডেলস ফ্রেমওয়ার্কের মাধ্যমে জেমিনি এপিআই অ্যাক্সেস করার বিষয়ে মতামত দিন।