Vertex AI Gemini API

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

শুরু করা হচ্ছে

আপনার অ্যাপ থেকে সরাসরি Vertex AI Gemini API-এর সাথে ইন্টারঅ্যাক্ট করার আগে, আপনি Vertex AI Studio- তে প্রম্পটগুলো নিয়ে পরীক্ষা-নিরীক্ষা করতে পারেন।

একটি ফায়ারবেস প্রজেক্ট তৈরি করুন এবং আপনার অ্যাপটিকে ফায়ারবেসের সাথে সংযুক্ত করুন।

আপনার অ্যাপ থেকে এপিআই কল করার জন্য প্রস্তুত হয়ে গেলে, ফায়ারবেস সেট আপ করতে এবং প্রয়োজনীয় এপিআই ও সার্ভিসগুলো চালু করতে ফায়ারবেস এআই লজিক গেটিং স্টার্টেড গাইডের "ধাপ ১"-এ দেওয়া নির্দেশাবলী অনুসরণ করুন।

গ্রেডল নির্ভরতা যোগ করুন

আপনার অ্যাপ মডিউলে নিম্নলিখিত গ্রেডল ডিপেন্ডেন্সিগুলো যোগ করুন:

dependencies {
  // ... other androidx dependencies

  // Import the BoM for the Firebase platform
  implementation(platform("com.google.firebase:firebase-bom:34.16.0"))

  // Add the dependencies for the Firebase AI Logic and App Check libraries
  // When using the BoM, you don't specify versions in Firebase library dependencies
  implementation("com.google.firebase:firebase-ai")
  implementation("com.google.firebase:firebase-appcheck-debug")
}

dependencies {
  // Import the BoM for the Firebase platform
  implementation(platform("com.google.firebase:34.16.0"))

  // Add the dependencies for the Firebase AI Logic and App Check libraries
  // When using the BoM, you don't specify versions in Firebase library dependencies
  implementation("com.google.firebase:firebase-ai")
  implementation("com.google.firebase:firebase-appcheck-debug")

  // Required for one-shot operations (to use `ListenableFuture` from Guava Android)
  implementation("com.google.guava:guava:31.0.1-android")

  // Required for streaming operations (to use `Publisher` from Reactive Streams)
  implementation("org.reactivestreams:reactive-streams:1.0.4")
}

স্থানীয় ডেভেলপমেন্টের জন্য অ্যাপ চেক ডিবাগ প্রোভাইডার কনফিগার করুন

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

1. আপনার ডিবাগ বিল্ডে, ডিবাগ প্রোভাইডার ফ্যাক্টরি ব্যবহার করার জন্য অ্যাপ চেক কনফিগার করুন:

   কোটলিন

   Firebase.initialize(context = this)
   Firebase.appCheck.installAppCheckProviderFactory(
       DebugAppCheckProviderFactory.getInstance(),
   )
   

   জাভা

   FirebaseApp.initializeApp(/*context=*/ this);
   FirebaseAppCheck firebaseAppCheck = FirebaseAppCheck.getInstance();
   firebaseAppCheck.installAppCheckProviderFactory(
           DebugAppCheckProviderFactory.getInstance());
   

2. আপনার ডিবাগ টোকেন সংগ্রহ করুন:

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

   2. আপনার লগগুলিতে অ্যাপ চেক ডিবাগ টোকেনটি খুঁজুন। উদাহরণস্বরূপ:

      D DebugAppCheckProvider: Enter this debug secret into the allow list
      in the Firebase Console for your project: 123a4567-b89c-12d3-e456-789012345678
      

   3. টোকেনটি কপি করুন (উদাহরণস্বরূপ, 123a4567-b89c-12d3-e456-789012345678 )।

3. অ্যাপ চেক-এর সাথে আপনার ডিবাগ টোকেন নিবন্ধন করুন:

   1. Firebase কনসোলে, Security > App Check > Apps ট্যাবে যান।

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

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

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

জেনারেটিভ মডেলটি প্রারম্ভিক করুন

প্রথমে একটি GenerativeModel ইনস্ট্যানশিয়েট করুন এবং মডেলের নামটি উল্লেখ করুন:

val model = Firebase.ai(backend = GenerativeBackend.vertexAI())
    .generativeModel("gemini-2.5-flash")
VertexAiGeminiApi.kt

GenerativeModel firebaseAI = FirebaseAI.getInstance(GenerativeBackend.vertexAI())
        .generativeModel("gemini-2.5-flash");

GenerativeModelFutures model = GenerativeModelFutures.from(firebaseAI);
VertexAiGeminiApiJava.java

Firebase ডকুমেন্টেশনে আপনি উপলব্ধ Gemini মডেলগুলো সম্পর্কে আরও জানতে পারবেন। এছাড়াও, আপনি মডেল প্যারামিটার কনফিগার করার পদ্ধতি সম্পর্কেও জানতে পারবেন।

টেক্সট তৈরি করুন

টেক্সট প্রতিক্রিয়া তৈরি করতে, আপনার প্রম্পট সহ generateContent() কল করুন।

suspend fun generateText(model: GenerativeModel) {
    // Note: generateContent() is a suspend function, which integrates well
    // with existing Kotlin code.
    val response = model.generateContent("Write a story about a magic backpack.")
    // ...
}
VertexAiGeminiApi.kt

Content prompt = new Content.Builder()
        .addText("Write a story about a magic backpack.")
        .build();

ListenableFuture<GenerateContentResponse> response = model.generateContent(prompt);
Futures.addCallback(response, new FutureCallback<GenerateContentResponse>() {
    @Override
    public void onSuccess(GenerateContentResponse result) {
        String resultText = result.getText();
        // ...
    }

    @Override
    public void onFailure(Throwable t) {
        t.printStackTrace();
    }
}, executor);
VertexAiGeminiApiJava.java

জেমিনি ডেভেলপার এপিআই-এর মতোই, আপনি আপনার টেক্সট প্রম্পটের সাথে ছবি, অডিও, ভিডিও এবং ফাইলও পাঠাতে পারেন। বিস্তারিত জানতে, আপনার অ্যাপ থেকে জেমিনি ডেভেলপার এপিআই-এর সাথে ইন্টারঅ্যাক্ট করুন দেখুন।

Firebase AI Logic SDK সম্পর্কে আরও জানতে, Firebase ডকুমেন্টেশন পড়ুন।