هنگام ساخت با API Gemini، توصیه می‌کنیم از Google GenAI SDK استفاده کنید. اینها کتابخانه‌های رسمی و آماده برای تولید هستند که ما برای محبوب‌ترین زبان‌ها توسعه داده و نگهداری می‌کنیم. آنها در دسترس عموم هستند و در تمام مستندات و مثال‌های رسمی ما استفاده می‌شوند.
اگر در استفاده از رابط برنامه‌نویسی کاربردی Gemini تازه‌کار هستید، برای شروع ، راهنمای شروع به کار ما را دنبال کنید.
پشتیبانی و نصب زبان
کیت توسعه نرم‌افزاری GenAI گوگل برای زبان‌های پایتون، جاوااسکریپت/تایپ‌اسکریپت، گو و جاوا در دسترس است. می‌توانید کتابخانه هر زبان را با استفاده از ابزارهای مدیریت بسته نصب کنید یا برای اطلاعات بیشتر به مخازن گیت‌هاب آنها مراجعه کنید:
پایتون
کتابخانه:
google-genaiمخزن گیت‌هاب: googleapis/python-genai
نصب:
pip install google-genai
جاوا اسکریپت
کتابخانه:
@google/genaiمخزن گیت‌هاب: googleapis/js-genai
نصب:
npm install @google/genai
برو
کتابخانه:
google.golang.org/genaiمخزن گیت‌هاب: googleapis/go-genai
نصب:
go get google.golang.org/genai
جاوا
کتابخانه:
google-genaiمخزن گیت‌هاب: googleapis/java-genai
نصب: اگر از Maven استفاده می‌کنید، موارد زیر را به وابستگی‌های خود اضافه کنید:
<dependencies>
<dependency>
<groupId>com.google.genai</groupId>
<artifactId>google-genai</artifactId>
<version>1.0.0</version>
</dependency>
</dependencies>
سی شارپ
کتابخانه:
Google.GenAIمخزن گیت‌هاب: googleapis/dotnet-genai
نصب:
dotnet add package Google.GenAI
در دسترس بودن عمومی
از ماه مه 2025، کیت توسعه نرم‌افزاری GenAI گوگل (Google GenAI SDK) در تمام پلتفرم‌های پشتیبانی‌شده به دسترسی عمومی (GA) رسیده است و کتابخانه‌های پیشنهادی برای دسترسی به API Gemini هستند. این کتابخانه‌ها پایدار هستند، برای استفاده در محیط عملیاتی کاملاً پشتیبانی می‌شوند و به‌طور فعال نگهداری می‌شوند. آنها دسترسی به جدیدترین ویژگی‌ها را فراهم می‌کنند و بهترین عملکرد را در کار با Gemini ارائه می‌دهند.
اگر از یکی از کتابخانه‌های قدیمی ما استفاده می‌کنید، اکیداً توصیه می‌کنیم که مهاجرت کنید تا بتوانید به جدیدترین ویژگی‌ها دسترسی پیدا کنید و بهترین عملکرد را در کار با Gemini داشته باشید. برای اطلاعات بیشتر، بخش کتابخانه‌های قدیمی را مرور کنید.
کتابخانه‌های قدیمی و مهاجرت
اگر از یکی از کتابخانه‌های قدیمی ما استفاده می‌کنید، توصیه می‌کنیم به کتابخانه‌های جدید مهاجرت کنید .
کتابخانه‌های قدیمی به ویژگی‌های جدید (مانند Live API و Veo ) دسترسی ندارند و از تاریخ 30 نوامبر 2025 منسوخ شده‌اند.
وضعیت پشتیبانی هر کتابخانه قدیمی متفاوت است که جزئیات آن در جدول زیر آمده است:
| زبان | کتابخانه قدیمی | وضعیت پشتیبانی | کتابخانه پیشنهادی |
|---|---|---|---|
| پایتون | google-generativeai | به طور فعال نگهداری نمی‌شود | google-genai |
| جاوا اسکریپت/تایپ اسکریپت | @google/generativeai | به طور فعال نگهداری نمی‌شود | @google/genai |
| برو | google.golang.org/generative-ai | به طور فعال نگهداری نمی‌شود | google.golang.org/genai |
| دارت و فلاتر | google_generative_ai | به طور فعال نگهداری نمی‌شود | از Genkit Dart یا Firebase AI Logic استفاده کنید |
| سویفت | generative-ai-swift | به طور فعال نگهداری نمی‌شود | از منطق هوش مصنوعی فایربیس استفاده کنید |
| اندروید | generative-ai-android | به طور فعال نگهداری نمی‌شود | از منطق هوش مصنوعی فایربیس استفاده کنید |
نکته برای توسعه‌دهندگان جاوا: هیچ SDK جاوای قدیمی ارائه شده توسط گوگل برای رابط برنامه‌نویسی Gemini وجود ندارد، بنابراین نیازی به مهاجرت از کتابخانه قبلی گوگل نیست. می‌توانید مستقیماً با کتابخانه جدید در بخش پشتیبانی و نصب زبان شروع کنید.