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

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

একটি জেমিনি এপিআই কী তৈরি করুন বা দেখুন

এপিআই কী-এর প্রকারভেদ: স্ট্যান্ডার্ড বনাম অথরাইজেশন

এপিআই কী (API key) জেমিনি এপিআই (Gemini API)-তে অ্যাক্সেস প্রদান করে, কিন্তু এগুলোর নিরাপত্তা বৈশিষ্ট্য ভিন্ন। নিরাপত্তা উন্নত করার জন্য জেমিনি এপিআই স্ট্যান্ডার্ড এপিআই কী থেকে অথরাইজেশন কী-তে স্থানান্তরিত হচ্ছে:

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

নিরাপদ ব্যবহার নিশ্চিত করতে, জেমিনি এপিআই স্ট্যান্ডার্ড কী থেকে অথোরাইজেশন কী-তে স্থানান্তরিত হবে:

• ডিফল্ট অথোরাইজেশন কী : গুগল এআই স্টুডিওতে তৈরি করা সমস্ত নতুন এপিআই কী স্বয়ংক্রিয়ভাবে অথোরাইজেশন কী হিসেবে তৈরি হয়ে যায়।
• ১৯শে জুন, ২০২৬ তারিখে : জেমিনি এপিআই (Gemini API) সীমাবদ্ধতাহীন স্ট্যান্ডার্ড কী (standard key) থেকে আসা অনুরোধ প্রত্যাখ্যান করবে। যেসব স্ট্যান্ডার্ড এপিআই কী-তে সুস্পষ্ট সীমাবদ্ধতা আরোপ করা হয়েছে, সেগুলো কাজ করতে থাকবে। এই সীমাবদ্ধতা এমন কী-গুলোর অননুমোদিত ব্যবহার রোধ করে, যেগুলো প্রকাশ্যে শেয়ার করা হতে পারে বা অন্য কোনো পরিষেবার সাথে সংযুক্ত থাকতে পারে।
• সেপ্টেম্বর ২০২৬ থেকে জেমিনি এপিআই স্ট্যান্ডার্ড কী (Standard key) থেকে আসা অনুরোধ প্রত্যাখ্যান করবে। পরিষেবা বিঘ্নিত হওয়া এড়াতে আপনাকে অবশ্যই এই তারিখের আগে অথোরাইজেশন কী (auth key)-তে মাইগ্রেট করতে হবে। সেপ্টেম্বর ২০২৬-এর আগে অথোরাইজেশন কী-তে মাইগ্রেট করা নিশ্চিত করুন।

গুগল এআই স্টুডিওতে এপিআই কী পরিচালনা করা

আপনি আপনার প্রোজেক্ট এবং কীগুলো সরাসরি গুগল এআই স্টুডিও- তে পরিচালনা করতে পারেন।

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

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

• ডিফল্ট প্রজেক্ট : আপনি যদি একজন নতুন ব্যবহারকারী হন, তাহলে পরিষেবার শর্তাবলীতে সম্মতি দেওয়ার পর Google AI Studio স্বয়ংক্রিয়ভাবে একটি ডিফল্ট Google Cloud প্রজেক্ট এবং API কী তৈরি করে। আপনি আপনার ড্যাশবোর্ডে থাকা প্রজেক্টস ভিউতে গিয়ে এই প্রজেক্টটির নাম পরিবর্তন করতে পারেন।
• বিদ্যমান প্রজেক্টসমূহ : আপনার যদি আগে থেকেই একটি গুগল ক্লাউড অ্যাকাউন্ট থাকে, তাহলে এআই স্টুডিও কোনো ডিফল্ট প্রজেক্ট তৈরি করে না। পরিবর্তে, আপনাকে আপনার বিদ্যমান প্রজেক্টগুলো ইম্পোর্ট করতে হবে।

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

ডিফল্টরূপে, গুগল এআই স্টুডিও আপনার সব গুগল ক্লাউড প্রজেক্ট প্রদর্শন করে না। আপনি যে প্রজেক্টগুলো ব্যবহার করতে চান, সেগুলো আপনাকে ইম্পোর্ট করতে হবে:

1. গুগল এআই স্টুডিও -তে যান।
2. বাম প্যানেল থেকে ড্যাশবোর্ড খুলুন এবং প্রজেক্টস নির্বাচন করুন।
3. ইমপোর্ট প্রোজেক্টস বাটনটিতে ক্লিক করুন।
4. আপনি যে গুগল ক্লাউড প্রজেক্টটি ইম্পোর্ট করতে চান সেটি খুঁজে বের করে নির্বাচন করুন, তারপর ইম্পোর্ট-এ ক্লিক করুন।
5. ইম্পোর্ট করা হয়ে গেলে, সেই প্রজেক্টে একটি কী তৈরি করতে ড্যাশবোর্ডের API Keys পেজে যান।

কী তৈরির অনুমতি সংক্রান্ত সমস্যা সমাধান

যদি "Create API key" বাটনটি অনুপলব্ধ থাকে এবং "You do not have permission to create a key in this project" বার্তাটি প্রদর্শিত হয়, তাহলে আপনার প্রয়োজনীয় IAM অনুমতি নেই।

আপনার গুগল ক্লাউড প্রজেক্ট বা অর্গানাইজেশন অ্যাডমিনিস্ট্রেটরকে নিম্নলিখিত অনুমতিগুলোসহ একটি রোল (যেমন প্রজেক্ট এডিটর) মঞ্জুর করার জন্য অনুরোধ করুন:

• resourcemanager.projects.get : এআই স্টুডিওকে প্রজেক্টটি যাচাই করার অনুমতি দেয়।
• apikeys.keys.create : কী তৈরি করার সুবিধা দেয়।
• serviceusage.services.enable : জেনারেটিভ ল্যাঙ্গুয়েজ এপিআই (Generative Language API) সক্রিয় আছে কিনা তা নিশ্চিত করে।
• iam.serviceAccounts.create : লিঙ্কড সার্ভিস অ্যাকাউন্ট তৈরি করার জন্য এটি আবশ্যক।
• iam.serviceAccountApiKeyBindings.create : সার্ভিস অ্যাকাউন্টকে এপিআই কী-এর সাথে সংযুক্ত করে।

আপনি যদি অ্যাডমিনিস্ট্রেটিভ অ্যাক্সেস না পান, তাহলে আপনার কী (key) তৈরি করার জন্য কোনো সংস্থার সাথে যুক্ত নয় এমন একটি নতুন গুগল ক্লাউড প্রজেক্ট তৈরি করতে পারেন।

আপনার পরিবেশ সেট আপ করা

একবার কী পেয়ে গেলে, আপনার অ্যাপ্লিকেশনগুলিতে এটি নিরাপদে ব্যবহার করার জন্য আপনার পরিবেশটি কনফিগার করুন।

এনভায়রনমেন্ট ভেরিয়েবল ব্যবহার করুন (সুপারিশকৃত)

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

ভেরিয়েবল সেট করতে আপনার অপারেটিং সিস্টেম নির্বাচন করুন:

~/.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

কোডে এপিআই কী স্পষ্টভাবে প্রদান করুন।

ক্লায়েন্ট ইনিশিয়ালাইজ করার সময় আপনি এপিআই কী স্পষ্টভাবে পাস করতে পারেন। শুধুমাত্র তখনই এটি করুন, যদি আপনি এনভায়রনমেন্ট ভেরিয়েবল ব্যবহার করতে না পারেন।

from google import genai

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

response = client.models.generate_content(
    model="gemini-3.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-3.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-3.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-3.5-flash",
            "Explain how AI works in a few words",
            null);

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

curl "https://generativelanguage.googleapis.com/v1beta/models/gemini-3.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"
          }
        ]
      }
    ]
  }'

নিরাপত্তা ও গোপনীয়তা ব্যবস্থাপনা

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

গুরুত্বপূর্ণ নিরাপত্তা নিয়মাবলী

• কীগুলি গোপন রাখুন : গিট-এর মতো সোর্স কন্ট্রোল সিস্টেমে কখনও এপিআই কী চেক ইন করবেন না।
• প্রোডাকশনে ক্লায়েন্ট-সাইডে কখনোই কী প্রকাশ করবেন না : ওয়েব বা মোবাইল অ্যাপে সরাসরি এপিআই কী হার্ডকোড করবেন না। ক্লায়েন্ট-সাইড কোডে কম্পাইল করা কী ব্যবহারকারীরা বের করে নিতে পারে। ক্লায়েন্ট-সাইড অ্যাপ সুরক্ষিত করতে, প্রকৃত এপিআই কলগুলো করার জন্য একটি ব্যাকএন্ড প্রক্সি সার্ভার চালান।

গোপনীয়তা ব্যবস্থাপনার সর্বোত্তম অনুশীলন

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

লিক প্রতিক্রিয়া চেকলিস্ট

আপনার এপিআই কী ফাঁস হয়েছে বলে সন্দেহ হলে:

1. নতুন কী তৈরি করুন : Google AI Studio বা ক্লাউড কনসোলে একটি প্রতিস্থাপন কী তৈরি করুন।
2. আপনার অ্যাপ্লিকেশন আপডেট করুন : নতুন কী ব্যবহার করে আপনার কোড ডিপ্লয় করুন।
3. ফাঁস হওয়া কী-টি নিষ্ক্রিয় বা মুছে ফেলুন : নতুন কী-টি যাচাই হয়ে গেলে ক্লাউড কনসোলে ফাঁস হওয়া কী-টি নিষ্ক্রিয় করে দিন। অ্যাপ্লিকেশন ডাউনটাইম এড়াতে, নতুন কী-টি সম্পূর্ণরূপে সক্রিয় না হওয়া পর্যন্ত পুরানো কী-টি মুছবেন না।
4. ব্যবহার নিরীক্ষা করুন : অননুমোদিত কার্যকলাপ শনাক্ত করতে গুগল ক্লাউড কনসোলে বিলিং লগ এবং এপিআই (API) ব্যবহার পরীক্ষা করুন।

আপনার চাবি সীমাবদ্ধ ও সুরক্ষিত করা

আপনার এপিআই কী-গুলিতে বিধিনিষেধ যুক্ত করলে, কোনো কী ফাঁস হয়ে গেলে সম্ভাব্য ক্ষতির পরিমাণ কমে যায়।

অনুরোধের উৎস সীমাবদ্ধতা প্রয়োগ করুন

অরিজিন রেস্ট্রিকশন বা উৎস সীমাবদ্ধতা নির্ধারণ করে দেয় যে কোন আইপি অ্যাড্রেস, ওয়েবসাইট বা অ্যাপ্লিকেশন আপনার কী ব্যবহার করতে পারবে।

1. গুগল ক্লাউড কনসোল ক্রেডেনশিয়ালস পৃষ্ঠায় যান।
2. আপনার প্রজেক্টটি নির্বাচন করুন এবং যে এপিআই কী-টি সীমাবদ্ধ করতে চান, সেটির নামে ক্লিক করুন।
3. অ্যাপ্লিকেশন বিধিনিষেধের অধীনে, আইপি অ্যাড্রেস (অথবা আপনার পরিবেশের জন্য উপযুক্ত বিধিনিষেধের ধরণ) নির্বাচন করুন।
4. অনুমোদিত আইপি অ্যাড্রেস বা রেঞ্জগুলো নির্দিষ্ট করুন, তারপর সেভ-এ ক্লিক করুন।

অবাধ স্ট্যান্ডার্ড এপিআই কী সুরক্ষিত করা

১৯ জুন, ২০২৬-এর পর জেমিনি এপিআই ব্যবহার চালিয়ে যেতে হলে, আপনাকে অবশ্যই যেকোনো অবাধ কী সুরক্ষিত করতে হবে।

এআই স্টুডিওর মাধ্যমে কী-টি শুধুমাত্র জেমিনি এপিআই-এর জন্য সীমাবদ্ধ করুন।

আপনি যদি শুধুমাত্র জেমিনি এপিআই-এর জন্য কী-টি ব্যবহার করেন, তবে এটিকে সরাসরি এআই স্টুডিওতে সুরক্ষিত করুন:

1. Google AI Studio- এর API Keys পৃষ্ঠায়, Unrestricted লেবেল দিয়ে চিহ্নিত কী-গুলো খুঁজুন।
2. লেবেলটির উপর মাউস রাখুন এবং ডায়ালগ বক্সে থাকা 'Add restrictions'- এ ক্লিক করুন।
3. শুধুমাত্র জেমিনি এপিআই-এর জন্য সীমাবদ্ধ করুন নির্বাচন করুন।
4. নিশ্চিত করতে রেস্ট্রিক্ট কী-তে ক্লিক করুন।

গুগল ক্লাউড কনসোলের মাধ্যমে অন্যান্য পরিষেবার জন্য কী-টি সীমাবদ্ধ করুন।

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

1. গুগল ক্লাউড কনসোল ক্রেডেনশিয়ালস পৃষ্ঠাটি পরিদর্শন করুন।
2. প্রজেক্ট এবং এপিআই কী নির্বাচন করুন।
3. API বিধিনিষেধের অধীনে, ‘কী সীমাবদ্ধ করুন’ নির্বাচন করুন।
4. ড্রপ-ডাউন থেকে, এই কী-টির মাধ্যমে আপনি যে API-গুলো অ্যাক্সেস করতে চান, সেগুলো নির্বাচন করুন। জেনারেটিভ ল্যাঙ্গুয়েজ API নির্বাচন করবেন না।
5. সেভ-এ ক্লিক করুন। জেমিনি এপিআই ব্যবহার চালিয়ে যেতে এআই স্টুডিওতে একটি পৃথক, সীমাবদ্ধ কী তৈরি করুন।

অবরুদ্ধ নিষ্ক্রিয় কী

৭ই মে, ২০২৬ থেকে, জেমিনি এপিআই দীর্ঘ সময় ধরে নিষ্ক্রিয় থাকা অবাধ এপিআই কী-গুলো ব্লক করে দেবে। এই কী-গুলো এআই স্টুডিও-তে একটি 'ব্লকড' ট্যাগ দেখাবে। কাজ চালিয়ে যাওয়ার জন্য আপনাকে অবশ্যই একটি নতুন কী তৈরি করতে হবে অথবা একটি বিদ্যমান সীমাবদ্ধ কী ব্যবহার করতে হবে।

একটি প্রমাণীকরণ কী-তে স্থানান্তরিত করুন

একটি নতুন অথ এপিআই কী তৈরি করতে এবং আপনার অ্যাপ্লিকেশনগুলি আপডেট করতে এই ধাপগুলি অনুসরণ করুন:

1. এআই স্টুডিও এপিআই কী পেজে যান।
2. Standard হিসেবে তালিকাভুক্ত কোনো কী আছে কিনা তা শনাক্ত করতে Key Type কলামটি পরীক্ষা করুন।
3. একটি নতুন কী তৈরি করতে 'Create API key'-তে ক্লিক করুন। AI Studio-তে তৈরি করা সমস্ত নতুন কী স্বয়ংক্রিয়ভাবে অথোরাইজেশন কী (auth key) হিসেবে তৈরি হয়ে যায়।
4. নতুন অথোরাইজেশন এপিআই কী-টি কপি করুন।
5. নতুন অথোরাইজেশন এপিআই কী ব্যবহার করার জন্য আপনার অ্যাপ্লিকেশন কোড, এনভায়রনমেন্ট ভেরিয়েবল এবং যেকোনো ডেপ্লয়মেন্ট কনফিগারেশন আপডেট করুন।
6. নতুন কী-টি দিয়ে আপনার অ্যাপ্লিকেশনটি সঠিকভাবে কাজ করছে কিনা তা পরীক্ষা করে দেখুন।
7. যাচাই হয়ে গেলে, অপব্যবহার রোধ করতে আপনার পুরানো ট্র্যাফিক কী মুছে ফেলুন বা বাতিল করুন।

সীমাবদ্ধতা

গুগল এআই স্টুডিও প্রজেক্ট এবং কী ব্যবস্থাপনার ক্ষেত্রে নিম্নলিখিত সীমাবদ্ধতাগুলো আরোপ করে:

• গুগল এআই স্টুডিও প্রজেক্টস পেজ থেকে আপনি একবারে সর্বোচ্চ ১০টি প্রজেক্ট তৈরি করতে পারবেন।
• এপিআই কী এবং প্রজেক্ট পেজগুলোতে সর্বোচ্চ ১০০টি কী এবং ৫০টি প্রজেক্ট প্রদর্শন করা যায়।
• শুধুমাত্র সেই API কী-গুলোই দেখানো হয় যেগুলো অবাধ অথবা বিশেষভাবে জেনারেটিভ ল্যাঙ্গুয়েজ API (জেমিনি API)-এর জন্য সীমাবদ্ধ।

উন্নত প্রজেক্ট ম্যানেজমেন্টের জন্য অথবা অন্যান্য বিধিনিষেধসহ কী (key) পরিবর্তন করতে, গুগল ক্লাউড কনসোল ক্রেডেনশিয়ালস পেজ ব্যবহার করুন।