জেমিনি এপিআই ব্যবহার করার জন্য, আপনার একটি এপিআই কী প্রয়োজন। এই পৃষ্ঠায় গুগল এআই স্টুডিওতে কীভাবে আপনার কী তৈরি এবং পরিচালনা করবেন এবং কীভাবে আপনার কোডে সেগুলি ব্যবহার করার জন্য আপনার পরিবেশ সেট আপ করবেন তা বর্ণনা করা হয়েছে।
এপিআই কী
API কী হল একটি এনক্রিপ্টেড স্ট্রিং যা আপনি Google Cloud API গুলিতে কল করার সময় ব্যবহার করতে পারেন। আপনি Google AI Studio API Keys পৃষ্ঠা থেকে আপনার সমস্ত Gemini API Key তৈরি এবং পরিচালনা করতে পারেন।
একবার আপনার কাছে একটি API কী হয়ে গেলে, Gemini API-এর সাথে সংযোগ করার জন্য আপনার কাছে নিম্নলিখিত বিকল্পগুলি থাকবে:
প্রাথমিক পরীক্ষার জন্য, আপনি একটি API কী হার্ড কোড করতে পারেন, তবে এটি কেবল অস্থায়ী হওয়া উচিত কারণ এটি নিরাপদ নয়। আপনি "প্রদানকারী API কী স্পষ্টভাবে" বিভাগে API কী হার্ড কোডিংয়ের উদাহরণ খুঁজে পেতে পারেন।
গুগল ক্লাউড প্রকল্প
গুগল ক্লাউড পরিষেবা (যেমন জেমিনি এপিআই) ব্যবহার, বিলিং পরিচালনা এবং সহযোগী এবং অনুমতি নিয়ন্ত্রণের জন্য গুগল ক্লাউড প্রকল্পগুলি মৌলিক। গুগল এআই স্টুডিও আপনার গুগল ক্লাউড প্রকল্পগুলিতে একটি হালকা ইন্টারফেস সরবরাহ করে।
যদি আপনার এখনও কোনও প্রকল্প তৈরি না করে থাকেন, তাহলে আপনাকে হয় একটি নতুন প্রকল্প তৈরি করতে হবে অথবা গুগল ক্লাউড থেকে গুগল এআই স্টুডিওতে একটি আমদানি করতে হবে। গুগল এআই স্টুডিওর প্রজেক্ট পৃষ্ঠায় জেমিনি এপিআই ব্যবহারের জন্য পর্যাপ্ত অনুমতি থাকা সমস্ত কী প্রদর্শিত হবে। নির্দেশাবলীর জন্য আমদানি প্রকল্প বিভাগটি দেখুন।
ডিফল্ট প্রকল্প
নতুন ব্যবহারকারীদের জন্য, পরিষেবার শর্তাবলী গ্রহণ করার পরে, Google AI Studio ব্যবহারের সুবিধার্থে একটি ডিফল্ট Google Cloud Project এবং API Key তৈরি করে। আপনি Google AI Studio-তে এই প্রকল্পটির নাম পরিবর্তন করতে পারেন ড্যাশবোর্ডে Projects view-এ নেভিগেট করে, একটি প্রকল্পের পাশে 3 ডট সেটিংস বোতামে ক্লিক করে এবং Rename project নির্বাচন করে। বিদ্যমান ব্যবহারকারীরা, অথবা যাদের ইতিমধ্যেই Google Cloud অ্যাকাউন্ট আছে তাদের কোনও ডিফল্ট প্রকল্প তৈরি করা হবে না।
আমদানি প্রকল্প
প্রতিটি জেমিনি এপিআই কী একটি গুগল ক্লাউড প্রোজেক্টের সাথে যুক্ত। ডিফল্টরূপে, গুগল এআই স্টুডিও আপনার সমস্ত ক্লাউড প্রোজেক্ট দেখায় না। ইমপোর্ট প্রোজেক্টস ডায়ালগে নাম বা প্রোজেক্ট আইডি অনুসন্ধান করে আপনার পছন্দসই প্রোজেক্টগুলি আমদানি করতে হবে। আপনার অ্যাক্সেস থাকা প্রোজেক্টগুলির একটি সম্পূর্ণ তালিকা দেখতে, ক্লাউড কনসোলটি দেখুন।
যদি আপনার এখনও কোনও প্রকল্প আমদানি না করা থাকে, তাহলে একটি Google ক্লাউড প্রকল্প আমদানি করতে এবং একটি কী তৈরি করতে এই পদক্ষেপগুলি অনুসরণ করুন:
- গুগল এআই স্টুডিওতে যান।
- বাম পাশের প্যানেল থেকে ড্যাশবোর্ড খুলুন।
- প্রকল্প নির্বাচন করুন।
- প্রজেক্ট পৃষ্ঠায় ইমপোর্ট প্রজেক্ট বোতামটি নির্বাচন করুন।
- আপনি যে গুগল ক্লাউড প্রজেক্টটি আমদানি করতে চান তা অনুসন্ধান করুন এবং নির্বাচন করুন এবং আমদানি বোতামটি নির্বাচন করুন।
একবার একটি প্রকল্প আমদানি করা হয়ে গেলে, ড্যাশবোর্ড মেনু থেকে API কী পৃষ্ঠায় যান এবং আপনার আমদানি করা প্রকল্পে একটি API কী তৈরি করুন।
সীমাবদ্ধতা
গুগল এআই স্টুডিওতে API কী এবং গুগল ক্লাউড প্রকল্প পরিচালনার সীমাবদ্ধতাগুলি নিচে দেওয়া হল।
- আপনি গুগল এআই স্টুডিও প্রজেক্টস পৃষ্ঠা থেকে একবারে সর্বোচ্চ ১০টি প্রজেক্ট তৈরি করতে পারবেন।
- আপনি প্রকল্প এবং কীগুলির নাম এবং নাম পরিবর্তন করতে পারেন।
- API কী এবং প্রজেক্ট পৃষ্ঠাগুলিতে সর্বাধিক ১০০টি কী এবং ৫০টি প্রজেক্ট প্রদর্শিত হয়।
- শুধুমাত্র সেই API কীগুলি প্রদর্শিত হয় যার কোনও বিধিনিষেধ নেই, অথবা জেনারেটিভ ল্যাঙ্গুয়েজ API-এর মধ্যে সীমাবদ্ধ।
আপনার প্রকল্পগুলিতে অতিরিক্ত ব্যবস্থাপনা অ্যাক্সেসের জন্য, Google Cloud Console দেখুন।
API কীকে একটি পরিবেশ পরিবর্তনশীল হিসেবে সেট করা
যদি আপনি পরিবেশ পরিবর্তনশীল GEMINI_API_KEY অথবা GOOGLE_API_KEY সেট করেন, তাহলে Gemini API লাইব্রেরি ব্যবহার করার সময় ক্লায়েন্ট API কীটি স্বয়ংক্রিয়ভাবে গ্রহণ করবে। এই ভেরিয়েবলগুলির মধ্যে শুধুমাত্র একটি সেট করার পরামর্শ দেওয়া হচ্ছে, কিন্তু যদি উভয়ই সেট করা থাকে, তাহলে GOOGLE_API_KEY অগ্রাধিকার পাবে।
আপনি যদি ব্রাউজারে REST API, অথবা JavaScript ব্যবহার করেন, তাহলে আপনাকে স্পষ্টভাবে API কী প্রদান করতে হবে।
বিভিন্ন অপারেটিং সিস্টেমের সাথে আপনি কীভাবে আপনার API কী স্থানীয়ভাবে GEMINI_API_KEY পরিবেশ পরিবর্তনশীল হিসাবে সেট করতে পারেন তা এখানে দেওয়া হল।
লিনাক্স/ম্যাকওএস - ব্যাশ
Bash হল একটি সাধারণ Linux এবং macOS টার্মিনাল কনফিগারেশন। নিম্নলিখিত কমান্ডটি চালিয়ে আপনি এটির জন্য একটি কনফিগারেশন ফাইল আছে কিনা তা পরীক্ষা করতে পারেন:
~/.bashrc যদি উত্তরটি "কোনও ফাইল বা ডিরেক্টরি নেই" হয়, তাহলে আপনাকে এই ফাইলটি তৈরি করতে হবে এবং নিম্নলিখিত কমান্ডগুলি চালিয়ে এটি খুলতে হবে, অথবা zsh ব্যবহার করতে হবে:
touch ~/.bashrcopen ~/.bashrc
এরপর, আপনাকে নিম্নলিখিত এক্সপোর্ট কমান্ড যোগ করে আপনার API কী সেট করতে হবে:
export GEMINI_API_KEY=<YOUR_API_KEY_HERE>ফাইলটি সংরক্ষণ করার পরে, নিম্নলিখিতটি চালিয়ে পরিবর্তনগুলি প্রয়োগ করুন:
source ~/.bashrcম্যাকওএস - জেডএসএইচ
Zsh হল একটি সাধারণ লিনাক্স এবং ম্যাকোস টার্মিনাল কনফিগারেশন। নিম্নলিখিত কমান্ডটি চালিয়ে আপনি এটির জন্য একটি কনফিগারেশন ফাইল আছে কিনা তা পরীক্ষা করতে পারেন:
~/.zshrc যদি উত্তরটি "কোনও ফাইল বা ডিরেক্টরি নেই" হয়, তাহলে আপনাকে এই ফাইলটি তৈরি করতে হবে এবং নিম্নলিখিত কমান্ডগুলি চালিয়ে এটি খুলতে হবে, অথবা bash ব্যবহার করতে হবে:
touch ~/.zshrcopen ~/.zshrc
এরপর, আপনাকে নিম্নলিখিত এক্সপোর্ট কমান্ড যোগ করে আপনার API কী সেট করতে হবে:
export GEMINI_API_KEY=<YOUR_API_KEY_HERE>ফাইলটি সংরক্ষণ করার পরে, নিম্নলিখিতটি চালিয়ে পরিবর্তনগুলি প্রয়োগ করুন:
source ~/.zshrcজানালা
- অনুসন্ধান বারে "পরিবেশের পরিবর্তনশীল" অনুসন্ধান করুন।
- সিস্টেম সেটিংস পরিবর্তন করতে বেছে নিন। আপনাকে নিশ্চিত করতে হতে পারে যে আপনি এটি করতে চান।
- সিস্টেম সেটিংস ডায়ালগে, Environment Variables লেবেলযুক্ত বোতামটি ক্লিক করুন।
- ব্যবহারকারী ভেরিয়েবল (বর্তমান ব্যবহারকারীর জন্য) অথবা সিস্টেম ভেরিয়েবল (যে সকল ব্যবহারকারী মেশিন ব্যবহারকারীর জন্য প্রযোজ্য) এর অধীনে, নতুন... ক্লিক করুন।
- ভেরিয়েবলের নাম
GEMINI_API_KEYহিসেবে উল্লেখ করুন। আপনার জেমিনি API কী ভেরিয়েবলের মান হিসেবে উল্লেখ করুন। - পরিবর্তনগুলি প্রয়োগ করতে ঠিক আছে ক্লিক করুন।
- নতুন ভেরিয়েবল পেতে একটি নতুন টার্মিনাল সেশন (cmd অথবা Powershell) খুলুন।
স্পষ্টভাবে API কী প্রদান করা
কিছু ক্ষেত্রে, আপনি স্পষ্টভাবে একটি API কী প্রদান করতে চাইতে পারেন। উদাহরণস্বরূপ:
- তুমি একটা সাধারণ API কল করছো এবং 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 কী ব্যবহার করবেন না। ক্লায়েন্ট-সাইড কোডের (আমাদের JavaScript/TypeScript লাইব্রেরি এবং REST কল সহ) কীগুলি বের করা যেতে পারে।
সেরা অনুশীলন
API কী ব্যবহার করে সার্ভার-সাইড কল ব্যবহার করুন। আপনার API কী ব্যবহারের সবচেয়ে নিরাপদ উপায় হল সার্ভার-সাইড অ্যাপ্লিকেশন থেকে জেমিনি API কল করা যেখানে কীটি গোপন রাখা যেতে পারে।
ক্লায়েন্ট-সাইড অ্যাক্সেসের জন্য ক্ষণস্থায়ী টোকেন ব্যবহার করুন (শুধুমাত্র লাইভ API): লাইভ API-তে সরাসরি ক্লায়েন্ট-সাইড অ্যাক্সেসের জন্য, আপনি ক্ষণস্থায়ী টোকেন ব্যবহার করতে পারেন। এগুলিতে কম নিরাপত্তা ঝুঁকি থাকে এবং উৎপাদন ব্যবহারের জন্য উপযুক্ত হতে পারে। আরও তথ্যের জন্য ক্ষণস্থায়ী টোকেন নির্দেশিকা পর্যালোচনা করুন।
আপনার কী-তে সীমাবদ্ধতা যোগ করার কথা বিবেচনা করুন: আপনি API কী-তে সীমাবদ্ধতা যোগ করে একটি কী-এর অনুমতি সীমিত করতে পারেন। এটি কীটি কখনও ফাঁস হয়ে গেলে সম্ভাব্য ক্ষতি কমিয়ে দেয়।
কিছু সাধারণ সেরা অনুশীলনের জন্য, আপনি এই সহায়তা নিবন্ধটিও পর্যালোচনা করতে পারেন।
,জেমিনি এপিআই ব্যবহার করার জন্য, আপনার একটি এপিআই কী প্রয়োজন। এই পৃষ্ঠায় গুগল এআই স্টুডিওতে কীভাবে আপনার কী তৈরি এবং পরিচালনা করবেন এবং কীভাবে আপনার কোডে সেগুলি ব্যবহার করার জন্য আপনার পরিবেশ সেট আপ করবেন তা বর্ণনা করা হয়েছে।
এপিআই কী
API কী হল একটি এনক্রিপ্টেড স্ট্রিং যা আপনি Google Cloud API গুলিতে কল করার সময় ব্যবহার করতে পারেন। আপনি Google AI Studio API Keys পৃষ্ঠা থেকে আপনার সমস্ত Gemini API Key তৈরি এবং পরিচালনা করতে পারেন।
একবার আপনার কাছে একটি API কী হয়ে গেলে, Gemini API-এর সাথে সংযোগ করার জন্য আপনার কাছে নিম্নলিখিত বিকল্পগুলি থাকবে:
প্রাথমিক পরীক্ষার জন্য, আপনি একটি API কী হার্ড কোড করতে পারেন, তবে এটি কেবল অস্থায়ী হওয়া উচিত কারণ এটি নিরাপদ নয়। আপনি "প্রদানকারী API কী স্পষ্টভাবে" বিভাগে API কী হার্ড কোডিংয়ের উদাহরণ খুঁজে পেতে পারেন।
গুগল ক্লাউড প্রকল্প
গুগল ক্লাউড পরিষেবা (যেমন জেমিনি এপিআই) ব্যবহার, বিলিং পরিচালনা এবং সহযোগী এবং অনুমতি নিয়ন্ত্রণের জন্য গুগল ক্লাউড প্রকল্পগুলি মৌলিক। গুগল এআই স্টুডিও আপনার গুগল ক্লাউড প্রকল্পগুলিতে একটি হালকা ইন্টারফেস সরবরাহ করে।
যদি আপনার এখনও কোনও প্রকল্প তৈরি না করে থাকেন, তাহলে আপনাকে হয় একটি নতুন প্রকল্প তৈরি করতে হবে অথবা গুগল ক্লাউড থেকে গুগল এআই স্টুডিওতে একটি আমদানি করতে হবে। গুগল এআই স্টুডিওর প্রজেক্ট পৃষ্ঠায় জেমিনি এপিআই ব্যবহারের জন্য পর্যাপ্ত অনুমতি থাকা সমস্ত কী প্রদর্শিত হবে। নির্দেশাবলীর জন্য আমদানি প্রকল্প বিভাগটি দেখুন।
ডিফল্ট প্রকল্প
নতুন ব্যবহারকারীদের জন্য, পরিষেবার শর্তাবলী গ্রহণ করার পরে, Google AI Studio ব্যবহারের সুবিধার্থে একটি ডিফল্ট Google Cloud Project এবং API Key তৈরি করে। আপনি Google AI Studio-তে এই প্রকল্পটির নাম পরিবর্তন করতে পারেন ড্যাশবোর্ডে Projects view-এ নেভিগেট করে, একটি প্রকল্পের পাশে 3 ডট সেটিংস বোতামে ক্লিক করে এবং Rename project নির্বাচন করে। বিদ্যমান ব্যবহারকারীরা, অথবা যাদের ইতিমধ্যেই Google Cloud অ্যাকাউন্ট আছে তাদের কোনও ডিফল্ট প্রকল্প তৈরি করা হবে না।
আমদানি প্রকল্প
প্রতিটি জেমিনি এপিআই কী একটি গুগল ক্লাউড প্রোজেক্টের সাথে যুক্ত। ডিফল্টরূপে, গুগল এআই স্টুডিও আপনার সমস্ত ক্লাউড প্রোজেক্ট দেখায় না। ইমপোর্ট প্রোজেক্টস ডায়ালগে নাম বা প্রোজেক্ট আইডি অনুসন্ধান করে আপনার পছন্দসই প্রোজেক্টগুলি আমদানি করতে হবে। আপনার অ্যাক্সেস থাকা প্রোজেক্টগুলির একটি সম্পূর্ণ তালিকা দেখতে, ক্লাউড কনসোলটি দেখুন।
যদি আপনার এখনও কোনও প্রকল্প আমদানি না করা থাকে, তাহলে একটি Google ক্লাউড প্রকল্প আমদানি করতে এবং একটি কী তৈরি করতে এই পদক্ষেপগুলি অনুসরণ করুন:
- গুগল এআই স্টুডিওতে যান।
- বাম পাশের প্যানেল থেকে ড্যাশবোর্ড খুলুন।
- প্রকল্প নির্বাচন করুন।
- প্রজেক্ট পৃষ্ঠায় ইমপোর্ট প্রজেক্ট বোতামটি নির্বাচন করুন।
- আপনি যে গুগল ক্লাউড প্রজেক্টটি আমদানি করতে চান তা অনুসন্ধান করুন এবং নির্বাচন করুন এবং আমদানি বোতামটি নির্বাচন করুন।
একবার একটি প্রকল্প আমদানি করা হয়ে গেলে, ড্যাশবোর্ড মেনু থেকে API কী পৃষ্ঠায় যান এবং আপনার আমদানি করা প্রকল্পে একটি API কী তৈরি করুন।
সীমাবদ্ধতা
গুগল এআই স্টুডিওতে API কী এবং গুগল ক্লাউড প্রকল্প পরিচালনার সীমাবদ্ধতাগুলি নিচে দেওয়া হল।
- আপনি গুগল এআই স্টুডিও প্রজেক্টস পৃষ্ঠা থেকে একবারে সর্বোচ্চ ১০টি প্রজেক্ট তৈরি করতে পারবেন।
- আপনি প্রকল্প এবং কীগুলির নাম এবং নাম পরিবর্তন করতে পারেন।
- API কী এবং প্রজেক্ট পৃষ্ঠাগুলিতে সর্বাধিক ১০০টি কী এবং ৫০টি প্রজেক্ট প্রদর্শিত হয়।
- শুধুমাত্র সেই API কীগুলি প্রদর্শিত হয় যার কোনও বিধিনিষেধ নেই, অথবা জেনারেটিভ ল্যাঙ্গুয়েজ API-এর মধ্যে সীমাবদ্ধ।
আপনার প্রকল্পগুলিতে অতিরিক্ত ব্যবস্থাপনা অ্যাক্সেসের জন্য, Google Cloud Console দেখুন।
API কীকে একটি পরিবেশ পরিবর্তনশীল হিসেবে সেট করা
যদি আপনি পরিবেশ পরিবর্তনশীল GEMINI_API_KEY অথবা GOOGLE_API_KEY সেট করেন, তাহলে Gemini API লাইব্রেরি ব্যবহার করার সময় ক্লায়েন্ট API কীটি স্বয়ংক্রিয়ভাবে গ্রহণ করবে। এই ভেরিয়েবলগুলির মধ্যে শুধুমাত্র একটি সেট করার পরামর্শ দেওয়া হচ্ছে, কিন্তু যদি উভয়ই সেট করা থাকে, তাহলে GOOGLE_API_KEY অগ্রাধিকার পাবে।
আপনি যদি ব্রাউজারে REST API, অথবা JavaScript ব্যবহার করেন, তাহলে আপনাকে স্পষ্টভাবে API কী প্রদান করতে হবে।
বিভিন্ন অপারেটিং সিস্টেমের সাথে আপনি কীভাবে আপনার API কী স্থানীয়ভাবে GEMINI_API_KEY পরিবেশ পরিবর্তনশীল হিসাবে সেট করতে পারেন তা এখানে দেওয়া হল।
লিনাক্স/ম্যাকওএস - ব্যাশ
Bash হল একটি সাধারণ Linux এবং macOS টার্মিনাল কনফিগারেশন। নিম্নলিখিত কমান্ডটি চালিয়ে আপনি এটির জন্য একটি কনফিগারেশন ফাইল আছে কিনা তা পরীক্ষা করতে পারেন:
~/.bashrc যদি উত্তরটি "কোনও ফাইল বা ডিরেক্টরি নেই" হয়, তাহলে আপনাকে এই ফাইলটি তৈরি করতে হবে এবং নিম্নলিখিত কমান্ডগুলি চালিয়ে এটি খুলতে হবে, অথবা zsh ব্যবহার করতে হবে:
touch ~/.bashrcopen ~/.bashrc
এরপর, আপনাকে নিম্নলিখিত এক্সপোর্ট কমান্ড যোগ করে আপনার API কী সেট করতে হবে:
export GEMINI_API_KEY=<YOUR_API_KEY_HERE>ফাইলটি সংরক্ষণ করার পরে, নিম্নলিখিতটি চালিয়ে পরিবর্তনগুলি প্রয়োগ করুন:
source ~/.bashrcম্যাকওএস - জেডএসএইচ
Zsh হল একটি সাধারণ লিনাক্স এবং ম্যাকোস টার্মিনাল কনফিগারেশন। নিম্নলিখিত কমান্ডটি চালিয়ে আপনি এটির জন্য একটি কনফিগারেশন ফাইল আছে কিনা তা পরীক্ষা করতে পারেন:
~/.zshrc যদি উত্তরটি "কোনও ফাইল বা ডিরেক্টরি নেই" হয়, তাহলে আপনাকে এই ফাইলটি তৈরি করতে হবে এবং নিম্নলিখিত কমান্ডগুলি চালিয়ে এটি খুলতে হবে, অথবা bash ব্যবহার করতে হবে:
touch ~/.zshrcopen ~/.zshrc
এরপর, আপনাকে নিম্নলিখিত এক্সপোর্ট কমান্ড যোগ করে আপনার API কী সেট করতে হবে:
export GEMINI_API_KEY=<YOUR_API_KEY_HERE>ফাইলটি সংরক্ষণ করার পরে, নিম্নলিখিতটি চালিয়ে পরিবর্তনগুলি প্রয়োগ করুন:
source ~/.zshrcজানালা
- অনুসন্ধান বারে "পরিবেশের পরিবর্তনশীল" অনুসন্ধান করুন।
- সিস্টেম সেটিংস পরিবর্তন করতে বেছে নিন। আপনাকে নিশ্চিত করতে হতে পারে যে আপনি এটি করতে চান।
- সিস্টেম সেটিংস ডায়ালগে, Environment Variables লেবেলযুক্ত বোতামটি ক্লিক করুন।
- ব্যবহারকারী ভেরিয়েবল (বর্তমান ব্যবহারকারীর জন্য) অথবা সিস্টেম ভেরিয়েবল (যে সকল ব্যবহারকারী মেশিন ব্যবহারকারীর জন্য প্রযোজ্য) এর অধীনে, নতুন... ক্লিক করুন।
- ভেরিয়েবলের নাম
GEMINI_API_KEYহিসেবে উল্লেখ করুন। আপনার জেমিনি API কী ভেরিয়েবলের মান হিসেবে উল্লেখ করুন। - পরিবর্তনগুলি প্রয়োগ করতে ঠিক আছে ক্লিক করুন।
- নতুন ভেরিয়েবল পেতে একটি নতুন টার্মিনাল সেশন (cmd অথবা Powershell) খুলুন।
স্পষ্টভাবে API কী প্রদান করা
কিছু ক্ষেত্রে, আপনি স্পষ্টভাবে একটি API কী প্রদান করতে চাইতে পারেন। উদাহরণস্বরূপ:
- তুমি একটা সাধারণ API কল করছো এবং 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 কী ব্যবহার করবেন না। ক্লায়েন্ট-সাইড কোডের (আমাদের JavaScript/TypeScript লাইব্রেরি এবং REST কল সহ) কীগুলি বের করা যেতে পারে।
সেরা অনুশীলন
API কী ব্যবহার করে সার্ভার-সাইড কল ব্যবহার করুন। আপনার API কী ব্যবহারের সবচেয়ে নিরাপদ উপায় হল সার্ভার-সাইড অ্যাপ্লিকেশন থেকে জেমিনি API কল করা যেখানে কীটি গোপন রাখা যেতে পারে।
ক্লায়েন্ট-সাইড অ্যাক্সেসের জন্য ক্ষণস্থায়ী টোকেন ব্যবহার করুন (শুধুমাত্র লাইভ API): লাইভ API-তে সরাসরি ক্লায়েন্ট-সাইড অ্যাক্সেসের জন্য, আপনি ক্ষণস্থায়ী টোকেন ব্যবহার করতে পারেন। এগুলিতে কম নিরাপত্তা ঝুঁকি থাকে এবং উৎপাদন ব্যবহারের জন্য উপযুক্ত হতে পারে। আরও তথ্যের জন্য ক্ষণস্থায়ী টোকেন নির্দেশিকা পর্যালোচনা করুন।
আপনার কী-তে সীমাবদ্ধতা যোগ করার কথা বিবেচনা করুন: আপনি API কী-তে সীমাবদ্ধতা যোগ করে একটি কী-এর অনুমতি সীমিত করতে পারেন। এটি কীটি কখনও ফাঁস হয়ে গেলে সম্ভাব্য ক্ষতি কমিয়ে দেয়।
কিছু সাধারণ সেরা অনুশীলনের জন্য, আপনি এই সহায়তা নিবন্ধটিও পর্যালোচনা করতে পারেন।