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