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

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

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

এপিআই কী

আপনি Google AI Studio API Keys পৃষ্ঠা থেকে আপনার সমস্ত Gemini API Key তৈরি এবং পরিচালনা করতে পারেন।

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

• আপনার এপিআই কী এনভায়রনমেন্ট ভেরিয়েবল হিসেবে সেট করা
• আপনার এপিআই কী স্পষ্টভাবে প্রদান করা

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

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

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

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

ডিফল্ট প্রকল্প

নতুন ব্যবহারকারীদের জন্য, পরিষেবার শর্তাবলী (Terms of Service) গ্রহণ করার পর, ব্যবহারের সুবিধার জন্য Google AI Studio একটি ডিফল্ট Google Cloud প্রজেক্ট এবং API Key তৈরি করে। আপনি ড্যাশবোর্ডের প্রজেক্টস ভিউতে গিয়ে, প্রজেক্টের পাশে থাকা ৩ ডট সেটিংস বোতামে ক্লিক করে এবং রিনেম প্রজেক্ট (Rename project) নির্বাচন করে Google AI Studio-তে এই প্রজেক্টটির নাম পরিবর্তন করতে পারেন। বিদ্যমান ব্যবহারকারী, বা যাদের আগে থেকেই Google Cloud অ্যাকাউন্ট আছে, তাদের জন্য কোনো ডিফল্ট প্রজেক্ট তৈরি করা হবে না।

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

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

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

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

প্রজেক্ট ইম্পোর্ট করার পর, ড্যাশবোর্ড মেনু থেকে API Keys পেজে যান এবং সদ্য ইম্পোর্ট করা প্রজেক্টটিতে একটি API কী তৈরি করুন।

সীমাবদ্ধতা

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

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

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

এপিআই কী-কে এনভায়রনমেন্ট ভেরিয়েবল হিসেবে সেট করা

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

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

বিভিন্ন অপারেটিং সিস্টেমে কীভাবে আপনার এপিআই কী স্থানীয়ভাবে GEMINI_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

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

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

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

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

from google import genai

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

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

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

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

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

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

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

• চাবিগুলি গোপন রাখুন : জেমিনির এপিআই কীগুলি এমন সংবেদনশীল ডেটা অ্যাক্সেস করতে পারে যার উপর আপনার অ্যাপ্লিকেশনটি নির্ভরশীল।

  • কখনো সোর্স কন্ট্রোলে এপিআই কী কমিট করবেন না। গিট-এর মতো ভার্সন কন্ট্রোল সিস্টেমে আপনার এপিআই কী চেক ইন করবেন না।

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

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

• ব্যবহার সীমাবদ্ধ করুন : প্রতিটি কী-এর জন্য শুধু প্রয়োজনীয় API-গুলো সক্রিয় করুন।

• নিয়মিত নিরীক্ষা করুন : আপনার API কীগুলি নিয়মিত নিরীক্ষা করুন এবং পর্যায়ক্রমে সেগুলি পরিবর্তন করুন।

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

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

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

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

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