Gemini API রেফারেন্স

এই API রেফারেন্সটি ইউনারি, স্ট্রিমিং এবং রিয়েল-টাইম API বর্ণনা করে যা আপনি Gemini মডেলের সাথে ইন্টার‍্যাক্ট করতে ব্যবহার করতে পারেন। HTTP অনুরোধ কাজ করে এমন যেকোনও পরিবেশে আপনি REST API ব্যবহার করতে পারবেন। আপনার প্রথম API কল কীভাবে শুরু করবেন তা জানতে শুরু করার নির্দেশিকা দেখুন। আপনি যদি আমাদের ভাষা-নির্দিষ্ট লাইব্রেরি এবং SDK-এর রেফারেন্স খুঁজছেন, তাহলে SDK রেফারেন্স-এর অধীনে বাঁদিকের নেভিগেশনে সেই ভাষার লিঙ্কে যান।

প্রাথমিক এন্ডপয়েন্ট

Gemini API নিম্নলিখিত প্রধান এন্ডপয়েন্টের ভিত্তিতে সাজানো হয়েছে:

• ইন্টার‍্যাকশন (CreateInteraction) (সাজেস্ট করা): Gemini-র মাধ্যমে তৈরি করার জন্য সাজেস্ট করা স্ট্যান্ডার্ড প্রিমিটিভ, যা এজেন্টিক ওয়ার্কফ্লো, সার্ভার-সাইড স্টেট ম্যানেজমেন্ট এবং জটিল মাল্টি-মোডাল, মাল্টি-টার্ন কথোপকথনের জন্য অপ্টিমাইজ করা হয়েছে।
• স্ট্যান্ডার্ড কন্টেন্ট জেনারেশন (generateContent): একটি স্ট্যান্ডার্ড REST এন্ডপয়েন্ট যা আপনার অনুরোধ প্রসেস করে এবং একটি প্যাকেজে মডেলের সম্পূর্ণ উত্তর প্রদান করে। এটি নন-ইন্টার‍্যাক্টিভ টাস্কের জন্য সবচেয়ে ভালো যেখানে আপনি সম্পূর্ণ ফলাফলের জন্য অপেক্ষা করতে পারবেন।
• স্ট্রিমিং কন্টেন্ট জেনারেশন (streamGenerateContent): উত্তরের অংশগুলি তৈরি হওয়ার সাথে সাথে আপনাকে পুশ করার জন্য সার্ভার-প্রেরিত ইভেন্ট (SSE) ব্যবহার করে। এটি চ্যাটবটের মতো অ্যাপ্লিকেশনের জন্য আরও দ্রুত, আরও ইন্টার‍্যাক্টিভ অভিজ্ঞতা প্রদান করে।
• Live API (BidiGenerateContent): দ্বি-নির্দেশমূলক স্ট্রিমিংয়ের জন্য স্টেটফুল WebSocket-ভিত্তিক API, যা রিয়েল-টাইম কথোপকথনমূলক ব্যবহারের জন্য ডিজাইন করা হয়েছে।
• ব্যাচ মোড (batchGenerateContent): generateContent অনুরোধের ব্যাচ জমা দেওয়ার জন্য একটি স্ট্যান্ডার্ড REST এন্ডপয়েন্ট।
• এম্বেডিং (embedContent): একটি স্ট্যান্ডার্ড REST এন্ডপয়েন্ট যা ইনপুট Content থেকে একটি টেক্সট এম্বেডিং ভেক্টর তৈরি করে।
• Gen Media API: আমাদের বিশেষ মডেলের মাধ্যমে মিডিয়া জেনারেট করার এন্ডপয়েন্ট, যেমন ইমেজ জেনারেশনের জন্য Imagen এবং ভিডিও জেনারেশনের জন্য Veo। এছাড়াও, Gemini-তে এইসব ক্ষমতা বিল্ট-ইন আছে যা আপনি generateContent API ব্যবহার করে অ্যাক্সেস করতে পারবেন।
• প্ল্যাটফর্ম API: ইউটিলিটি এন্ডপয়েন্ট যা ফাইল আপলোড করা এবং টোকেন গণনা করার মতো মূল ক্ষমতাগুলিকে সাপো��্ট করে।

যাচাইকরণ

Gemini API-তে করা সব অনুরোধে আপনার API কী সহ x-goog-api-key হেডার অন্তর্ভুক্ত থাকতে হবে। Google AI Studio-তে কয়েকটি ক্লিক করেই একটি তৈরি করুন।

হেডারে API কী সহ অনুরোধের একটি উদাহরণ নিচে দেওয়া হল:

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

Gemini SDK ব্যবহার করে API-তে কীভাবে আপনার 'কী' পাস করবেন সেই সংক্রান্ত নির্দেশাবলীর জন্য, Gemini API কী ব্যবহার করা সংক্রান্ত নির্দেশিকা দেখুন।