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

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

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

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

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

পরিবেশ পরিবর্তনশীল হিসাবে 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?key=$YOUR_API_KEY" \
  -H 'Content-Type: application/json' \
  -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 কী সীমাবদ্ধতা যুক্ত করে একটি কী-এর অনুমতি সীমিত করতে পারেন। এটি সম্ভাব্য ক্ষতি কমিয়ে দেয় যদি চাবিটি কখনও ফাঁস হয়ে যায়।

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