জেমিনি এপিআই রেফারেন্স

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

প্রাথমিক শেষবিন্দু

জেমিনি এপিআই নিম্নলিখিত প্রধান এন্ডপয়েন্টগুলোকে কেন্দ্র করে সংগঠিত:

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

প্রমাণীকরণ

জেমিনি এপিআই-তে করা সমস্ত অনুরোধে আপনার এপিআই কী সহ একটি x-goog-api-key হেডার অবশ্যই অন্তর্ভুক্ত করতে হবে। গুগল এআই স্টুডিও -তে কয়েকটি ক্লিকেই একটি তৈরি করে নিন।

নিম্নলিখিতটি হেডারে এপিআই কী সহ একটি অনুরোধের উদাহরণ:

curl "https://generativelanguage.googleapis.com/v1beta/models/gemini-3.5-flash:generateContent" \
  -H "x-goog-api-key: $GEMINI_API_KEY" \
  -H 'Content-Type: application/json' \
  -X POST \
  -d '{
    "contents": [
      {
        "parts": [
          {
            "text": "Explain how AI works in a few words"
          }
        ]
      }
    ]
  }'

Gemini SDK ব্যবহার করে API-তে আপনার কী কীভাবে প্রেরণ করবেন, সে সম্পর্কিত নির্দেশাবলীর জন্য “Using Gemini API keys” গাইডটি দেখুন।