Gemini API key ব্যবহার করা

Gemini API ব্যবহার করতে, আপনাকে অবশ্যই নিজের অনুরোধ প্রমাণ করতে হবে। আপনি স্ট্যান্ডার্ড বা অনুমোদনের API কী ব্যবহার করে যাচাই করতে পারবেন।

Gemini API Key তৈরি বা দেখা

API key-এর ধরন: স্ট্যান্ডার্ড বনাম অনুমোদন

API কী Gemini API-তে অ্যাক্সেস প্রদান করে, কিন্তু সেগুলির সুরক্ষা সংক্রান্ত বৈশিষ্ট্য আলাদা আলাদা হয়। নিরাপত্তা উন্নত করতে Gemini API, সাধারণ API কী থেকে অনুমোদন কী-তে ট্রানজিশন করছে:

• স্ট্যান্ডার্ড API কী: বিলিং ও কোটা সংক্রান্ত উদ্দেশ্যে Google Cloud প্রোজেক্টের সাথে অনুরোধ অ্যাসোসিয়েট করুন। স্ট্যান্ডার্ড কী কলারকে শনাক্ত করে না, যা অনুমতি ও অ্যাক্সেস কন্ট্রোলের গ্র্যানুলারিটি সীমিত করে দেয় যা এটি কাজ করতে পারে।
• অনুমোদন (auth) কী: সরাসরি Google Cloud পরিষেবা অ্যাকাউন্টের সাথে যুক্ত। আপনি কোনও অনুমোদনের কী ব্যবহার করলে, আপনার অনুরোধ সেই আবদ্ধ পরিষেবা অ্যাকাউন্টের পরিচয় অনুযায়ী প্রসেস করা হয়, এর ফলে গ্র্যানুলার অ্যাক্সেস কন্ট্রোল চালু হয়। অনুমোদন কী ডিফল্ট হিসেবে Generative Language API (Gemini API)-এর মধ্যে সীমাবদ্ধ থাকে এবং দ্রুত কাজ করে এমন ফাঁস হওয়া কী এনফোর্সমেন্ট প্রদান করে যা আমাদের সিস্টেমের শনাক্ত করা ফাঁস হওয়া কীয়ের ব্যবহার দ্রুত বন্ধ করে দেয়।

নিরাপদ ব্যবহার নিশ্চিত করতে, Gemini API স্ট্যান্ডার্ড কী থেকে অথ কী-তে পরিবর্তিত হবে:

• ডিফল্ট অথ কী: ২৮ মে, ২০২৬ থেকে, Google AI Studio-তে তৈরি করা সব নতুন API কী অটোমেটিক অথ কী হিসেবে তৈরি করা হবে।
• সীমাবদ্ধতা নেই এমন কী বাতিল করা হয়েছে: Gemini API, সীমাবদ্ধতা নেই এমন স্ট্যান্ডার্ড কী থেকে আসা অনুরোধ বাতিল করে দেয়। যেসব স্ট্যান্ডার্ড API কী-তে স্পষ্ট বিধিনিষেধ প্রয়োগ করা হয়েছে সেগুলি কাজ করা চালিয়ে যাবে। এই বিধিনিষেধটি সর্বজনীনভাবে শেয়ার করা বা অন্যান্য পরিষেবার সাথে লিঙ্ক করা কী-এর অননুমোদিত ব্যবহারকে বাধা দেয়।

Google AI Studio-তে API কী ম্যানেজ করা

আপনি সরাসরি Google AI Studio-তে আপনার প্রোজেক্ট ও কী ম্যানেজ করতে পারবেন।

Google Cloud প্রোজেক্ট

প্রতিটি Gemini API কী একটি Google Cloud প্রোজেক্টের সাথে যুক্ত থাকে। Google Cloud প্রোজেক্ট বিলিং, কোল্যাবরেটর ও অনুমতি ম্যানেজ করে। Google AI Studio এইসব প্রোজেক্ট অ্যাক্সেস করার জন্য একটি হালকা ইন্টারফেস প্রদান করে।

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

প্রোজেক্ট ইমপোর্ট করা

ডিফল্ট হিসেবে, Google AI Studio আপনার সব Google Cloud প্রজেক্ট দেখায় না। আপনি যেসব প্রোজেক্ট ব্যবহার করতে চান সেগুলি ইমপোর্ট করতে হবে:

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

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

API কী তৈরি করুন বোতামটি উপলভ্য না থাকলে এবং এই মেসেজটি দেখালে: "এই প্রোজেক্টে কী তৈরি করার অনুমতি আপনার নেই", আপনার কাছে প্রয়োজনীয় IAM অনুমতি নেই।

আপনার Google Cloud প্রোজেক্ট বা সংস্থার অ্যাডমিনিস্ট্রেটরকে নিম্নলিখিত অনুমতি (যেমন, প্রোজেক্ট এডিটর) সহ একটি ভূমিকা প্রদান করতে বলুন:

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

আপনি অ্যাডমিনিস্ট্রেটিভ অ্যাক্সেস না পেলে, আপনার কী তৈরি করার জন্য কোনও সংস্থার সাথে যুক্ত নয় এমন একটি নতুন Google Cloud প্রোজেক্ট তৈরি করতে পারেন।

Google Cloud Console-এ কী তৈরি করা

Google AI Studio শুধুমাত্র সেইসব কী দেখায় যেগুলি সীমাবদ্ধ নয় অথবা Gemini API-তে সীমাবদ্ধ। আপনি AI Studio ব্যবহার করতে না পারলে অথবা আপনার সব API কী এক জায়গায় ম্যানেজ করতে চাইলে, API কী তৈরি করা সংক্রান্ত Cloud ডকুমেন্টেশন দেখুন। Gemini API কী তৈরি করতে হলে, এটিকে একটি পরিষেবা অ্যাকাউন্টের সাথে বাইন্ড করতে হয়।

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

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

বিকল্প ১: এনভায়রনমেন্ট ভেরিয়েবল ব্যবহার করা (সাজেস্ট করা হয়েছে)

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

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

~/.bashrc

touch ~/.bashrc && open ~/.bashrc

export GEMINI_API_KEY=

source ~/.bashrc

~/.zshrc

touch ~/.zshrc && open ~/.zshrc

export GEMINI_API_KEY=

source ~/.zshrc

বিকল্প ২: কোডে API কী স্পষ্টভাবে উল্লেখ করা

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

from google import genai

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

interaction = client.interactions.create(
    model="gemini-3.8-flash",
    input="Explain how AI works in a few words"
)
print(interaction.output_text)

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

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

async function main() {
  const interaction = await ai.interactions.create({
    model: "gemini-3.8-flash",
    input: "Explain how AI works in a few words",
  });
  console.log(interaction.output_text);
}

main();

import com.google.genai.Client;
import com.google.genai.gaos.models.interactions.CreateModelInteraction;
import com.google.genai.gaos.models.interactions.Interaction;
import com.google.genai.gaos.models.interactions.InteractionsInput;
import com.google.genai.gaos.models.interactions.Model;
import com.google.genai.gaos.models.operations.CreateInteractionRequestBody;

Client client = Client.builder().apiKey("YOUR_API_KEY").build();

CreateModelInteraction params =
    CreateModelInteraction.builder()
        .model(Model.of("gemini-3.8-flash"))
        .input(InteractionsInput.of("Explain how AI works in a few sentences."))
        .build();

Interaction interaction =
    client.interactions.create(CreateInteractionRequestBody.of(params)).interaction().get();

System.out.println(interaction.outputText().orElse(""));

package main

import (
    "context"
    "fmt"
    "log"

    "google.golang.org/genai"
    "google.golang.org/genai/interactions/models/interactions"
    "google.golang.org/genai/interactions/models/operations"
)

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

    res, err := client.Interactions.Create(ctx, operations.CreateInteractionRequest{
        Body: operations.NewCreateInteractionRequestBody(interactions.CreateModelInteraction{
            Model: interactions.Model("gemini-3.8-flash"),
            Input: interactions.NewInteractionsInput("Explain how AI works in a few sentences."),
        }),
    })
    if err != nil {
        log.Fatal(err)
    }
    if res.Interaction.OutputText != nil {
        fmt.Println(*res.Interaction.OutputText)
    }
}

curl "https://generativelanguage.googleapis.com/v1beta/interactions" \
  -H 'Content-Type: application/json' \
  -H "x-goog-api-key: YOUR_API_KEY" \
  -X POST \
  -d '{
    "model": "gemini-3.8-flash",
    "input": "Explain how AI works in a few words"
  }'

নিরাপত্তা ও গোপনীয়তা ম্যানেজমেন্ট

আপনার Gemini API key-কে পাসওয়ার্ডের মতো গুরুত্ব দিন। সুরক্ষা দুর্বল হলে, অন্যরা আপনার প্রোজেক্টের কোটা ব্যবহার করতে, অপ্রত্যাশিত বিলিং চার্জ করতে এবং ব্যক্তিগত রিসোর্স অ্যাক্সেস করতে পারে।

গুরুত্বপূর্ণ নিরাপত্তা সংক্রান্ত নিয়ম

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

গোপনীয় তথ্য ম্যানেজ করা সংক্রান্ত পেশাদার পদ্ধতি

• এনভায়রনমেন্ট ভেরিয়েবল: কনফিগারেশন ফাইল থেকে কী পড়ার পরিবর্তে এনভায়রনমেন্ট ভেরিয়েবল থেকে কী পড়ুন।
• Secret Manager: প্রোডাকশনের জন্য, আপনার কীগুলি Google Cloud Secret Manager-এর মতো নিরাপদ সিক্রেট স্টোরে সেভ করুন।
• বিলিং অ্যালার্ট: Google Cloud Console-এ বিলিং অ্যালার্ট সেট-আপ করে ব্যবহার বা খরচ বেড়ে গেলে বিজ্ঞপ্তি পান।

লিকেজ সংক্রান্ত উত্তরের চেকলিস্ট

আপনার API key ফাঁস হয়ে গেছে বলে সন্দেহ করলে:

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

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

আপনার API কী-তে বিধিনিষেধ যোগ করলে, কোনও কী সুরক্ষিত না থাকলে সম্ভাব্য ক্ষতি কম হয়।

অনুরোধের উৎস সংক্রান্ত বিধিনিষেধ প্রয়োগ করা

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

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

সীমাবদ্ধতা ছাড়া স্ট্যান্ডার্ড API কী সুরক্ষিত করা

Gemini API ব্যবহার করা চালিয়ে যেতে, আপনাকে অবশ্যই কোনও বিধিনিষেধহীন কী সুরক্ষিত করতে হবে।

পদ্ধতি 'ক': শুধুমাত্র Gemini API (AI Studio)-তে কী সীমাবদ্ধ করুন

আপনি যদি শুধুমাত্র Gemini API-এর জন্য কী ব্যবহার করেন, তাহলে এটি সরাসরি AI Studio-তে সুরক্ষিত করুন:

1. Google AI Studio-তে API কী পৃষ্ঠায়, সীমাবদ্ধ নয় লেবেল দিয়ে চিহ্নিত কী খুঁজে দেখুন।
2. লেবেলের উপরে মাউস নিয়ে যান এবং ডায়ালগে বিধিনিষেধ যোগ করুন বিকল্পে ক্লিক করুন।
3. শুধুমাত্র Gemini API-তে সীমাবদ্ধ করুন বিকল্প বেছে নিন।
4. কনফার্ম করতে কী সীমাবদ্ধ করুন বিকল্পে ক্লিক করুন।

পদ্ধতি 'খ': অন্যান্য পরিষেবার জন্য কী সীমাবদ্ধ করুন (Google Cloud কনসোল)

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

1. Google Cloud Console ক্রেডেনশিয়াল পৃষ্ঠা দেখুন।
2. প্রোজেক্ট ও API কী বেছে নিন।
3. API বিধিনিষেধ-এর অধীনে, এই কী দিয়ে আপনি যেসব API অ্যাক্সেস করতে চান সেগুলি বেছে নিতে, API বিধিনিষেধ বেছে নিন ড্রপ-ডাউন মেনু ব্যবহার করুন। Generative Language API বেছে নেবেন না।
4. সেভ করুন বিকল্পে ক্লিক করুন। Gemini API ব্যবহার করা চালিয়ে যেতে AI Studio-তে একটি আলাদা, সীমিত কী তৈরি করুন।

ব্লক করা নিষ্ক্রিয় কী

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

যাচাইকরণ কী-তে মাইগ্রেট করা

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

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

সীমাবদ্ধতা

Google AI Studio-তে প্রোজেক্ট ও কী ম্যানেজমেন্ট সংক্রান্ত নিম্নলিখিত বিধিনিষেধ আরোপ করা হয়:

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

উন্নত প্রোজেক্ট ম্যানেজমেন্টের জন্য বা অন্যান্য বিধিনিষেধ সহ কী পরিবর্তন করতে, Google Cloud console ক্রেডেনশিয়াল পৃষ্ঠা ব্যবহার করুন।