জেমিনি API কুইকস্টার্ট

এই কুইকস্টার্ট আপনাকে দেখায় কিভাবে আপনার পছন্দের SDK ব্যবহার করে Gemini API দিয়ে শুরু করবেন।

পূর্বশর্ত

পাইথন

গুগল এআই দেখুন Google Colab-এ চালান GitHub এ নোটবুক দেখুন

স্থানীয়ভাবে এই কুইকস্টার্টটি সম্পূর্ণ করতে, নিশ্চিত করুন যে আপনার উন্নয়ন পরিবেশ নিম্নলিখিত প্রয়োজনীয়তাগুলি পূরণ করে:

  • Python 3.9+
  • নোটবুক চালানোর জন্য jupyter একটি ইনস্টলেশন।

যাওয়া

এই কুইকস্টার্ট অনুমান করে যে আপনি Go এর সাথে অ্যাপ্লিকেশন তৈরি করার সাথে পরিচিত।

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

  • 1.20+ যান

Node.js

এই কুইকস্টার্ট অনুমান করে যে আপনি Node.js এর সাথে অ্যাপ্লিকেশন তৈরি করার সাথে পরিচিত।

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

  • Node.js v18+
  • npm

ওয়েব

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

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

  • (ঐচ্ছিক) Node.js
  • আধুনিক ওয়েব ব্রাউজার

ডার্ট (ফ্লটার)

এই কুইকস্টার্ট ধরে নেয় যে আপনি ডার্টের সাথে অ্যাপ্লিকেশন তৈরি করার সাথে পরিচিত।

এই কুইকস্টার্টটি সম্পূর্ণ করতে, নিশ্চিত করুন যে আপনার উন্নয়ন পরিবেশ নিম্নলিখিত প্রয়োজনীয়তাগুলি পূরণ করে:

  • ডার্ট 3.2.0+

সুইফট

এই কুইকস্টার্ট ধরে নেয় যে আপনি সুইফট অ্যাপস ডেভেলপ করতে এক্সকোড ব্যবহার করার সাথে পরিচিত।

এই কুইকস্টার্টটি সম্পূর্ণ করতে, নিশ্চিত করুন যে আপনার ডেভেলপমেন্ট এনভায়রনমেন্ট এবং সুইফট অ্যাপ নিম্নলিখিত প্রয়োজনীয়তাগুলি পূরণ করে:

  • Xcode 15.0 বা উচ্চতর
  • আপনার Swift অ্যাপটি অবশ্যই iOS 15 বা উচ্চতর, অথবা macOS 12 বা উচ্চতরকে টার্গেট করতে হবে।

অ্যান্ড্রয়েড

এই কুইকস্টার্ট অনুমান করে যে আপনি অ্যান্ড্রয়েড অ্যাপ্লিকেশানগুলি বিকাশ করতে অ্যান্ড্রয়েড স্টুডিও ব্যবহার করার সাথে পরিচিত৷

এই কুইকস্টার্টটি সম্পূর্ণ করতে, নিশ্চিত করুন যে আপনার ডেভেলপমেন্ট এনভায়রনমেন্ট এবং অ্যান্ড্রয়েড অ্যাপ নিম্নলিখিত প্রয়োজনীয়তাগুলি পূরণ করে:

  • অ্যান্ড্রয়েড স্টুডিও (সর্বশেষ সংস্করণ)
  • আপনার অ্যান্ড্রয়েড অ্যাপকে অবশ্যই API লেভেল 21 বা উচ্চতর টার্গেট করতে হবে।

আপনার API কী সেট আপ করুন

Gemini API ব্যবহার করতে, আপনার একটি API কী প্রয়োজন। আপনার যদি ইতিমধ্যে একটি না থাকে তবে Google AI স্টুডিওতে একটি কী তৈরি করুন৷

একটি API কী পান

তারপর আপনার কী কনফিগার করুন।

পাইথন

এটি দৃঢ়ভাবে সুপারিশ করা হয় যে আপনি আপনার সংস্করণ নিয়ন্ত্রণ সিস্টেমে একটি API কী চেক করবেন না ৷ এই কুইকস্টার্ট অনুমান করে যে আপনি একটি পরিবেশ পরিবর্তনশীল হিসাবে আপনার API কী অ্যাক্সেস করছেন।

একটি পরিবেশ পরিবর্তনশীল আপনার API কী বরাদ্দ করুন:

export API_KEY=<YOUR_API_KEY>

যাওয়া

এটি দৃঢ়ভাবে সুপারিশ করা হয় যে আপনি আপনার সংস্করণ নিয়ন্ত্রণ সিস্টেমে একটি API কী চেক করবেন না ৷ এই কুইকস্টার্ট অনুমান করে যে আপনি একটি পরিবেশ পরিবর্তনশীল হিসাবে আপনার API কী অ্যাক্সেস করছেন।

একটি পরিবেশ পরিবর্তনশীল আপনার API কী বরাদ্দ করুন:

export API_KEY=<YOUR_API_KEY>

Node.js

এটি দৃঢ়ভাবে সুপারিশ করা হয় যে আপনি আপনার সংস্করণ নিয়ন্ত্রণ সিস্টেমে একটি API কী চেক করবেন না ৷ এই কুইকস্টার্ট অনুমান করে যে আপনি একটি পরিবেশ পরিবর্তনশীল হিসাবে আপনার API কী অ্যাক্সেস করছেন।

একটি পরিবেশ পরিবর্তনশীল আপনার API কী বরাদ্দ করুন:

export API_KEY=<YOUR_API_KEY>

ওয়েব

এটি দৃঢ়ভাবে সুপারিশ করা হয় যে আপনি আপনার সংস্করণ নিয়ন্ত্রণ সিস্টেমে একটি API কী চেক করবেন না ৷ পরিবর্তে, মডেলটি শুরু করার আগে আপনার অ্যাপে আপনার API কী পাস করা উচিত।

এই কুইকস্টার্ট অনুমান করে যে আপনি একটি বিশ্বব্যাপী ধ্রুবক হিসাবে আপনার API কী অ্যাক্সেস করছেন।

ডার্ট (ফ্লটার)

এটি দৃঢ়ভাবে সুপারিশ করা হয় যে আপনি আপনার সংস্করণ নিয়ন্ত্রণ সিস্টেমে একটি API কী চেক করবেন না ৷ এই কুইকস্টার্ট অনুমান করে যে আপনি একটি প্রক্রিয়া পরিবেশ পরিবর্তনশীল হিসাবে আপনার API কী অ্যাক্সেস করছেন। আপনি যদি একটি Flutter অ্যাপ তৈরি করেন, তাহলে আপনি String.fromEnvironment ব্যবহার করতে পারেন এবং এপিআই কী দিয়ে কম্পাইল করতে flutter build করতে --dart-define=API_KEY=$API_KEY পাস flutter run পারেন কারণ অ্যাপটি চালানোর সময় প্রক্রিয়া পরিবেশ ভিন্ন হবে। .

সুইফট

এটি দৃঢ়ভাবে সুপারিশ করা হয় যে আপনি আপনার সংস্করণ নিয়ন্ত্রণ সিস্টেমে একটি API কী চেক করবেন না ৷ একটি বিকল্প বিকল্প হল এটি একটি GenerativeAI-Info.plist ফাইলে সংরক্ষণ করা, এবং তারপর .plist ফাইল থেকে API কী পড়ুন। আপনার অ্যাপের রুট ফোল্ডারে এই .plist ফাইলটি রাখা নিশ্চিত করুন এবং সংস্করণ নিয়ন্ত্রণ থেকে বাদ দিন।

enum APIKey {
   // Fetch the API key from `GenerativeAI-Info.plist`
   static var `default`: String {
      guard let filePath = Bundle.main.path(forResource: "GenerativeAI-Info", ofType: "plist")
      else {
         fatalError("Couldn't find file 'GenerativeAI-Info.plist'.")
      }
      let plist = NSDictionary(contentsOfFile: filePath)
      guard let value = plist?.object(forKey: "API_KEY") as? String else {
         fatalError("Couldn't find key 'API_KEY' in 'GenerativeAI-Info.plist'.")
      }
      if value.starts(with: "_") {
         fatalError(
           "Follow the instructions at https://ai.google.dev/tutorials/setup to get an API key."
         )
      }
      return value
   }
}

অ্যান্ড্রয়েড

এটি দৃঢ়ভাবে সুপারিশ করা হয় যে আপনি আপনার সংস্করণ নিয়ন্ত্রণ সিস্টেমে একটি API কী চেক করবেন না ৷ পরিবর্তে, আপনার এটি একটি local.properties ফাইলে সংরক্ষণ করা উচিত (যা আপনার প্রকল্পের রুট ডিরেক্টরিতে অবস্থিত, কিন্তু সংস্করণ নিয়ন্ত্রণ থেকে বাদ দেওয়া হয়েছে), এবং তারপরে একটি বিল্ড কনফিগারেশন ভেরিয়েবল হিসাবে আপনার API কী পড়তে Android এর জন্য সিক্রেটস গ্রেডল প্লাগইন ব্যবহার করুন৷

কোটলিন:

// Access your API key as a Build Configuration variable
val apiKey = BuildConfig.apiKey

জাভা:

// Access your API key as a Build Configuration variable
String apiKey = BuildConfig.apiKey;

আপনি যদি সিক্রেটস গ্রেডল প্লাগইনটির বাস্তবায়ন দেখতে চান, তাহলে আপনি এই SDK-এর জন্য নমুনা অ্যাপটি পর্যালোচনা করতে পারেন বা Android Studio Iguana-এর সর্বশেষ প্রিভিউ ব্যবহার করতে পারেন যার একটি Gemini API স্টার্টার টেমপ্লেট রয়েছে (যেটিতে আপনার শুরু করার জন্য local.properties ফাইল রয়েছে )

SDK ইনস্টল করুন

পাইথন

Gemini API-এর জন্য Python SDK google-generativeai প্যাকেজে রয়েছে। পিপ ব্যবহার করে নির্ভরতা ইনস্টল করুন:

pip install -q -U google-generativeai

যাওয়া

আপনার নিজের অ্যাপ্লিকেশনে Gemini API ব্যবহার করতে, আপনাকে আপনার মডিউল ডিরেক্টরিতে Go SDK প্যাকেজটি get হবে:

go get github.com/google/generative-ai-go

Node.js

আপনার নিজের অ্যাপ্লিকেশনে Gemini API ব্যবহার করতে, আপনাকে Node.js-এর জন্য GoogleGenerativeAI প্যাকেজ ইনস্টল করতে হবে:

npm install @google/generative-ai

ওয়েব

আপনার নিজস্ব ওয়েব অ্যাপে Gemini API ব্যবহার করতে, @google/generative-ai আমদানি করুন :

<script type="importmap">
   {
     "imports": {
       "@google/generative-ai": "https://esm.run/@google/generative-ai"
     }
   }
</script>

ডার্ট (ফ্লটার)

আপনার নিজের অ্যাপ্লিকেশনে Gemini API ব্যবহার করতে, আপনাকে আপনার ডার্ট বা ফ্লাটার অ্যাপে google_generative_ai প্যাকেজ add হবে:

ডার্ট:

dart pub add google_generative_ai

ফ্লাটার:

flutter pub add google_generative_ai

সুইফট

আপনার নিজের সুইফট অ্যাপে Gemini API ব্যবহার করতে, আপনার অ্যাপে GoogleGenerativeAI প্যাকেজ যোগ করুন:

  1. Xcode-এ, প্রজেক্ট নেভিগেটরে আপনার প্রোজেক্টে ডান-ক্লিক করুন।

  2. প্রসঙ্গ মেনু থেকে প্যাকেজ যোগ করুন নির্বাচন করুন।

  3. প্যাকেজ যোগ করুন ডায়ালগে, অনুসন্ধান বারে প্যাকেজ URL পেস্ট করুন: none https://github.com/google/generative-ai-swift

  4. প্যাকেজ যোগ করুন ক্লিক করুন। Xcode এখন আপনার প্রকল্পে GoogleGenerativeAI প্যাকেজ যোগ করবে।

অ্যান্ড্রয়েড

  1. আপনার মডিউলে (অ্যাপ-লেভেল) গ্রেডল কনফিগারেশন ফাইলে (যেমন <project>/<app-module>/build.gradle.kts ), Android এর জন্য Google AI SDK-এর নির্ভরতা যোগ করুন:

    কোটলিন:

    dependencies {

   // add the dependency for the Google AI client SDK for Android
   implementation("com.google.ai.client.generativeai:generativeai:0.3.0")
}

    জাভা:

    জাভার জন্য, আপনাকে দুটি অতিরিক্ত লাইব্রেরি যোগ করতে হবে।

    dependencies {

    // add the dependency for the Google AI client SDK for Android
    implementation("com.google.ai.client.generativeai:generativeai:0.3.0")

    // 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")
}

  2. Gradle ফাইলগুলির সাথে আপনার Android প্রকল্প সিঙ্ক করুন।

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

পাইথন

আপনি যেকোন API কল করার আগে, আপনাকে জেনারেটিভ মডেলটি আমদানি এবং আরম্ভ করতে হবে।

import google.generativeai as genai

genai.configure(api_key=os.environ["API_KEY"])
model = genai.GenerativeModel('gemini-pro')

যাওয়া

আপনি যেকোন API কল করার আগে, আপনাকে জেনারেটিভ মডেলটি আমদানি এবং আরম্ভ করতে হবে।

import "github.com/google/generative-ai-go/genai"
import "google.golang.org/api/option"

ctx := context.Background()
// Access your API key as an environment variable (see "Set up your API key" above)
client, err := genai.NewClient(ctx, option.WithAPIKey(os.Getenv("API_KEY")))
if err != nil {
    log.Fatal(err)
}
defer client.Close()

// For text-only input, use the gemini-pro model
model := client.GenerativeModel("gemini-pro")

Node.js

আপনি যেকোন API কল করার আগে, আপনাকে জেনারেটিভ মডেলটি আমদানি এবং আরম্ভ করতে হবে।

const { GoogleGenerativeAI } = require("@google/generative-ai");

// Access your API key as an environment variable (see "Set up your API key" above)
const genAI = new GoogleGenerativeAI(process.env.API_KEY);

// ...

// For text-only input, use the gemini-pro model
const model = genAI.getGenerativeModel({ model: "gemini-pro"});

// ...

ওয়েব

আপনি যেকোন API কল করার আগে, আপনাকে জেনারেটিভ মডেলটি আমদানি এবং আরম্ভ করতে হবে।

<html>
<body>
   <!-- ... Your HTML and CSS -->
   <!-- Import @google/generative-ai, as shown above. -->
   <script type="module">
      import { GoogleGenerativeAI } from "@google/generative-ai";

      // Fetch your API_KEY
      const API_KEY = "...";

      // Access your API key (see "Set up your API key" above)
      const genAI = new GoogleGenerativeAI(API_KEY);

      // ...

      // For text-only input, use the gemini-pro model
      const model = genAI.getGenerativeModel({ model: "gemini-pro"});

      // ...
   </script>
</body>
</html>

ডার্ট (ফ্লটার)

আপনি যেকোন API কল করার আগে, আপনাকে জেনারেটিভ মডেলটি আমদানি এবং আরম্ভ করতে হবে।

import 'package:google_generative_ai/google_generative_ai.dart';

// Access your API key as an environment variable (see "Set up your API key" above)
final apiKey = Platform.environment['API_KEY'];
if (apiKey == null) {
  print('No \$API_KEY environment variable');
  exit(1);
}

// For text-only input, use the gemini-pro model
final model = GenerativeModel(model: 'gemini-pro', apiKey: apiKey);

সুইফট

আপনি যেকোনো API কল করার আগে, আপনাকে জেনারেটিভ মডেলটি আরম্ভ করতে হবে।

  1. GoogleAI মডিউল আমদানি করুন:

    import GoogleGenerativeAI

  2. জেনারেটিভ মডেল শুরু করুন:

    // For text-only input, use the gemini-pro model
// Access your API key from your on-demand resource .plist file (see "Set up your API key" above)
let model = GenerativeModel(name: "gemini-pro", apiKey: APIKey.default)

অ্যান্ড্রয়েড

আপনি যেকোনো API কল করার আগে, আপনাকে GenerativeModel অবজেক্টটি আরম্ভ করতে হবে:

কোটলিন:

val generativeModel = GenerativeModel(
      // For text-only input, use the gemini-pro model
      modelName = "gemini-pro",
      // Access your API key as a Build Configuration variable (see "Set up your API key" above)
      apiKey = BuildConfig.apiKey
)

জাভা:

জাভার জন্য, আপনাকে GenerativeModelFutures অবজেক্ট শুরু করতে হবে।

// For text-only input, use the gemini-pro model
GenerativeModel gm = new GenerativeModel(/* modelName */ "gemini-pro",
// Access your API key as a Build Configuration variable (see "Set up your API key" above)
      /* apiKey */ BuildConfig.apiKey);

// Use the GenerativeModelFutures Java compatibility layer which offers
// support for ListenableFuture and Publisher APIs
GenerativeModelFutures model = GenerativeModelFutures.from(gm);

পাঠ্য তৈরি করুন

পাইথন

response = model.generate_content("Write a story about a magic backpack.")
print(response.text)

যাওয়া

resp, err := model.GenerateContent(ctx, genai.Text("Write a story about a magic backpack."))
if err != nil {
  log.Fatal(err)
}

Node.js

async function run() {
  const prompt = "Write a story about a magic backpack."

  const result = await model.generateContent(prompt);
  const response = await result.response;
  const text = response.text();
  console.log(text);
}

run();

ওয়েব

async function run() {
  const prompt = "Write a story about a magic backpack."

  const result = await model.generateContent(prompt);
  const response = await result.response;
  const text = response.text();
  console.log(text);
}

run();

ডার্ট (ফ্লটার)

void main() async {
   // Access your API key as an environment variable (see "Set up your API key" above)
   final apiKey = Platform.environment['API_KEY'];
   if (apiKey == null) {
      print('No \$API_KEY environment variable');
      exit(1);
   }
   // For text-only input, use the gemini-pro model
   final model = GenerativeModel(model: 'gemini-pro', apiKey: apiKey);
   final content = [Content.text('Write a story about a magic backpack.')];
   final response = await model.generateContent(content);
   print(response.text);
}

সুইফট

let prompt = "Write a story about a magic backpack."
let response = try await model.generateContent(prompt)
if let text = response.text {
  print(text)
}

অ্যান্ড্রয়েড

কোটলিন:

মনে রাখবেন যে generateContent() একটি সাসপেন্ড ফাংশন এবং এটি একটি Coroutine স্কোপ থেকে কল করা প্রয়োজন। আপনি যদি Coroutines এর সাথে অপরিচিত হন, তাহলে Android-এ Kotlin Coroutines পড়ুন।

val prompt = "Write a story about a magic backpack."
val response = generativeModel.generateContent(prompt)
print(response.text)

জাভা:

মনে রাখবেন যে generateContent() একটি ListenableFuture প্রদান করে। আপনি যদি এই API এর সাথে অপরিচিত হন তবে একটি ListenableFuture ব্যবহার করার বিষয়ে Android ডকুমেন্টেশন দেখুন।

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

Executor executor = // ...

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

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

এরপর কি

Gemini API-এর সাথে কাজ করার বিষয়ে আরও জানতে, আপনার পছন্দের ভাষার জন্য টিউটোরিয়ালটি দেখুন।

আপনি Gemini API ব্যবহার করে দেখতে curl কমান্ড ব্যবহার করতে পারেন:

আপনি যদি জেনারেটিভ AI মডেলগুলিতে নতুন হয়ে থাকেন, তাহলে আপনি দ্রুত স্টার্ট করার আগে ধারণার নির্দেশিকা এবং জেমিনি API ওভারভিউ দেখতে চাইতে পারেন।