Gemini API কী ব্যবহার করে

Gemini API ব্যবহার করতে, আপনার একটি API কী প্রয়োজন। এই পৃষ্ঠাটি Google AI স্টুডিওতে কীভাবে আপনার কীগুলি তৈরি এবং পরিচালনা করতে হয় সেইসাথে কীভাবে আপনার কোডে সেগুলি ব্যবহার করার জন্য আপনার পরিবেশ সেট আপ করতে হয় তার রূপরেখা দেয়৷

API কী

একটি API কী হল একটি এনক্রিপ্ট করা স্ট্রিং যা আপনি Google ক্লাউড API কল করার সময় ব্যবহার করতে পারেন। আপনি Google AI স্টুডিও API কী পৃষ্ঠা থেকে আপনার সমস্ত Gemini API কী তৈরি এবং পরিচালনা করতে পারেন।

একবার আপনার কাছে একটি API কী থাকলে, আপনার কাছে Gemini API-এর সাথে সংযোগ করার জন্য নিম্নলিখিত বিকল্পগুলি রয়েছে:

• পরিবেশ পরিবর্তনশীল হিসাবে আপনার API কী সেট করা হচ্ছে
• আপনার API কী স্পষ্টভাবে প্রদান করা হচ্ছে

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

গুগল ক্লাউড প্রকল্প

Google ক্লাউড প্রকল্পগুলি Google ক্লাউড পরিষেবাগুলি (যেমন Gemini API), বিলিং পরিচালনা এবং সহযোগী এবং অনুমতিগুলি নিয়ন্ত্রণ করার জন্য মৌলিক। Google AI স্টুডিও আপনার Google ক্লাউড প্রকল্পগুলিতে একটি হালকা ইন্টারফেস প্রদান করে।

আপনার যদি এখনও কোনো প্রোজেক্ট তৈরি না করে থাকে, তাহলে আপনাকে অবশ্যই একটি নতুন প্রোজেক্ট তৈরি করতে হবে অথবা Google Cloud থেকে Google AI স্টুডিওতে আমদানি করতে হবে। Google AI স্টুডিওতে প্রজেক্ট পৃষ্ঠাটি জেমিনি API ব্যবহার করার জন্য পর্যাপ্ত অনুমতি আছে এমন সমস্ত কী প্রদর্শন করবে। নির্দেশাবলীর জন্য আমদানি প্রকল্প বিভাগে পড়ুন।

আমদানি প্রকল্প

প্রতিটি Gemini API কী একটি Google ক্লাউড প্রকল্পের সাথে যুক্ত। ডিফল্টরূপে, Google AI স্টুডিও আপনার সমস্ত ক্লাউড প্রজেক্ট দেখায় না। ইমপোর্ট প্রজেক্ট ডায়ালগে নাম বা প্রোজেক্ট আইডি অনুসন্ধান করে আপনি যে প্রজেক্ট চান তা ইম্পোর্ট করতে হবে। আপনার অ্যাক্সেস আছে এমন প্রকল্পগুলির একটি সম্পূর্ণ তালিকা দেখতে, ক্লাউড কনসোলে যান৷

আপনার যদি এখনও কোনো প্রজেক্ট ইম্পোর্ট করা না থাকে, তাহলে Google ক্লাউড প্রোজেক্ট ইমপোর্ট করতে এবং একটি কী তৈরি করতে এই ধাপগুলি অনুসরণ করুন:

1. গুগল এআই স্টুডিওতে যান।
2. বাম পাশের প্যানেল থেকে ড্যাশবোর্ড খুলুন।
3. প্রকল্প নির্বাচন করুন।
4. প্রজেক্ট পৃষ্ঠায় ইমপোর্ট প্রজেক্ট বোতামটি নির্বাচন করুন।
5. আপনি যে Google ক্লাউড প্রকল্পটি আমদানি করতে চান সেটি অনুসন্ধান করুন এবং নির্বাচন করুন এবং আমদানি বোতামটি নির্বাচন করুন৷

একবার একটি প্রকল্প আমদানি করা হলে, ড্যাশবোর্ড মেনু থেকে API কী পৃষ্ঠায় যান এবং আপনি যে প্রকল্পটি আমদানি করেছেন তাতে একটি API কী তৈরি করুন৷

সীমাবদ্ধতা

গুগল এআই স্টুডিওতে এপিআই কী এবং গুগল ক্লাউড প্রজেক্ট পরিচালনার সীমাবদ্ধতা নিচে দেওয়া হল।

• আপনি Google AI Studio Projects পৃষ্ঠা থেকে একবারে সর্বাধিক 10টি প্রকল্প তৈরি করতে পারেন।
• আপনি প্রকল্প এবং কীগুলির নাম এবং নাম পরিবর্তন করতে পারেন।
• API কী এবং প্রকল্প পৃষ্ঠাগুলি সর্বাধিক 100টি কী এবং 100টি প্রকল্প প্রদর্শন করে।
• শুধুমাত্র এপিআই কী যেগুলোর কোনো বিধিনিষেধ নেই, বা জেনারেটিভ ল্যাঙ্গুয়েজ এপিআই-তে সীমাবদ্ধ তা প্রদর্শিত হয়।

আপনার প্রকল্পগুলিতে অতিরিক্ত ব্যবস্থাপনা অ্যাক্সেসের জন্য, Google ক্লাউড কনসোলে যান৷

পরিবেশ পরিবর্তনশীল হিসাবে API কী সেট করা

আপনি যদি এনভায়রনমেন্ট ভেরিয়েবল GEMINI_API_KEY বা GOOGLE_API_KEY সেট করেন, Gemini API লাইব্রেরিগুলির একটি ব্যবহার করার সময় API কীটি স্বয়ংক্রিয়ভাবে ক্লায়েন্ট দ্বারা বাছাই করা হবে৷ এটি সুপারিশ করা হয় যে আপনি শুধুমাত্র এই ভেরিয়েবলগুলির মধ্যে একটি সেট করুন, কিন্তু যদি উভয়ই সেট করা থাকে, GOOGLE_API_KEY অগ্রাধিকার নেয়৷

আপনি যদি ব্রাউজারে REST API, বা JavaScript ব্যবহার করেন, তাহলে আপনাকে API কীটি স্পষ্টভাবে প্রদান করতে হবে।

বিভিন্ন অপারেটিং সিস্টেমের সাথে পরিবেশ পরিবর্তনশীল GEMINI_API_KEY হিসাবে আপনি কীভাবে স্থানীয়ভাবে আপনার API কী সেট করতে পারেন তা এখানে।

~/.bashrc

touch ~/.bashrc
open ~/.bashrc

export GEMINI_API_KEY=<YOUR_API_KEY_HERE>

source ~/.bashrc

~/.zshrc

touch ~/.zshrc
open ~/.zshrc

export GEMINI_API_KEY=<YOUR_API_KEY_HERE>

source ~/.zshrc

স্পষ্টভাবে API কী প্রদান করা হচ্ছে

কিছু ক্ষেত্রে, আপনি স্পষ্টভাবে একটি API কী প্রদান করতে চাইতে পারেন। যেমন:

• আপনি একটি সাধারণ API কল করছেন এবং API কীকে কঠিন কোডিং পছন্দ করছেন৷
• আপনি Gemini API লাইব্রেরি দ্বারা পরিবেশ ভেরিয়েবলের স্বয়ংক্রিয় আবিষ্কারের উপর নির্ভর না করে সুস্পষ্ট নিয়ন্ত্রণ চান
• আপনি এমন একটি পরিবেশ ব্যবহার করছেন যেখানে পরিবেশ ভেরিয়েবল সমর্থিত নয় (যেমন ওয়েব) অথবা আপনি REST কল করছেন।

আপনি কীভাবে স্পষ্টভাবে একটি API কী প্রদান করতে পারেন তার উদাহরণ নিচে দেওয়া হল:

from google import genai

client = genai.Client(api_key="YOUR_API_KEY")

response = client.models.generate_content(
    model="gemini-2.5-flash", contents="Explain how AI works in a few words"
)
print(response.text)

import { GoogleGenAI } from "@google/genai";

const ai = new GoogleGenAI({ apiKey: "YOUR_API_KEY" });

async function main() {
  const response = await ai.models.generateContent({
    model: "gemini-2.5-flash",
    contents: "Explain how AI works in a few words",
  });
  console.log(response.text);
}

main();

package main

import (
    "context"
    "fmt"
    "log"
    "google.golang.org/genai"
)

func main() {
    ctx := context.Background()
    client, err := genai.NewClient(ctx, &genai.ClientConfig{
        APIKey:  "YOUR_API_KEY",
        Backend: genai.BackendGeminiAPI,
    })
    if err != nil {
        log.Fatal(err)
    }

    result, err := client.Models.GenerateContent(
        ctx,
        "gemini-2.5-flash",
        genai.Text("Explain how AI works in a few words"),
        nil,
    )
    if err != nil {
        log.Fatal(err)
    }
    fmt.Println(result.Text())
}

package com.example;

import com.google.genai.Client;
import com.google.genai.types.GenerateContentResponse;

public class GenerateTextFromTextInput {
  public static void main(String[] args) {
    Client client = Client.builder().apiKey("YOUR_API_KEY").build();

    GenerateContentResponse response =
        client.models.generateContent(
            "gemini-2.5-flash",
            "Explain how AI works in a few words",
            null);

    System.out.println(response.text());
  }
}

curl "https://generativelanguage.googleapis.com/v1beta/models/gemini-2.5-flash:generateContent" \
  -H 'Content-Type: application/json' \
  -H "x-goog-api-key: YOUR_API_KEY" \
  -X POST \
  -d '{
    "contents": [
      {
        "parts": [
          {
            "text": "Explain how AI works in a few words"
          }
        ]
      }
    ]
  }'

আপনার API কী সুরক্ষিত রাখুন

আপনার জেমিনি API কীকে পাসওয়ার্ডের মতো ব্যবহার করুন। যদি আপস করা হয়, অন্যরা আপনার প্রকল্পের কোটা ব্যবহার করতে পারে, চার্জ দিতে পারে (যদি বিলিং সক্ষম করা থাকে), এবং ফাইলগুলির মতো আপনার ব্যক্তিগত ডেটা অ্যাক্সেস করতে পারে।

গুরুতর নিরাপত্তা নিয়ম

• সোর্স কন্ট্রোলের জন্য কখনই এপিআই কী কমিট করবেন না। Git এর মত সংস্করণ নিয়ন্ত্রণ সিস্টেমে আপনার API কী চেক করবেন না।

• ক্লায়েন্ট-সাইডে কখনই API কীগুলি প্রকাশ করবেন না। প্রডাকশনে ওয়েব বা মোবাইল অ্যাপে সরাসরি আপনার API কী ব্যবহার করবেন না। ক্লায়েন্ট-সাইড কোডের কীগুলি (আমাদের জাভাস্ক্রিপ্ট/টাইপস্ক্রিপ্ট লাইব্রেরি এবং REST কলগুলি সহ) বের করা যেতে পারে।

সর্বোত্তম অনুশীলন

• API কীগুলির সাথে সার্ভার-সাইড কলগুলি ব্যবহার করুন আপনার API কী ব্যবহার করার সবচেয়ে নিরাপদ উপায় হল একটি সার্ভার-সাইড অ্যাপ্লিকেশন থেকে Gemini API কল করা যেখানে কীটি গোপন রাখা যেতে পারে৷

• ক্লায়েন্ট-সাইড অ্যাক্সেসের জন্য ক্ষণস্থায়ী টোকেন ব্যবহার করুন (কেবল লাইভ API): লাইভ API-তে সরাসরি ক্লায়েন্ট-সাইড অ্যাক্সেসের জন্য, আপনি ক্ষণস্থায়ী টোকেন ব্যবহার করতে পারেন। তারা কম নিরাপত্তা ঝুঁকি নিয়ে আসে এবং উৎপাদন ব্যবহারের জন্য উপযুক্ত হতে পারে। আরও তথ্যের জন্য ক্ষণস্থায়ী টোকেন গাইড পর্যালোচনা করুন।

• আপনার কীতে সীমাবদ্ধতা যুক্ত করার কথা বিবেচনা করুন: আপনি API কী সীমাবদ্ধতা যুক্ত করে একটি কী-এর অনুমতি সীমিত করতে পারেন। এটি সম্ভাব্য ক্ষতি কমিয়ে দেয় যদি চাবিটি কখনও ফাঁস হয়ে যায়।

কিছু সাধারণ সর্বোত্তম অনুশীলনের জন্য, আপনি এই সমর্থন নিবন্ধটি পর্যালোচনা করতে পারেন।