هنگام ساخت با 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/go-genai
نصب:
dotnet add package Google.GenAI
در دسترس بودن عمومی
ما در اواخر سال ۲۰۲۴، همزمان با انتشار Gemini 2.0، شروع به انتشار Google GenAI SDK، مجموعه‌ای جدید از کتابخانه‌ها برای دسترسی به Gemini API، کردیم.
از ماه مه 2025، آنها به دسترسی عمومی (GA) در تمام پلتفرم‌های پشتیبانی‌شده رسیدند و کتابخانه‌های پیشنهادی برای دسترسی به API Gemini هستند. آنها پایدار هستند، برای استفاده در محیط عملیاتی کاملاً پشتیبانی می‌شوند و به‌طور فعال نگهداری می‌شوند. آنها دسترسی به جدیدترین ویژگی‌ها را فراهم می‌کنند و بهترین عملکرد را در کار با Gemini ارائه می‌دهند.
اگر از یکی از کتابخانه‌های قدیمی ما استفاده می‌کنید، اکیداً توصیه می‌کنیم که مهاجرت کنید تا بتوانید به جدیدترین ویژگی‌ها دسترسی پیدا کنید و بهترین عملکرد را در کار با Gemini داشته باشید. برای اطلاعات بیشتر، بخش کتابخانه‌های قدیمی را مرور کنید.
کتابخانه‌های قدیمی و مهاجرت
اگر از یکی از کتابخانه‌های قدیمی ما استفاده می‌کنید، توصیه می‌کنیم به کتابخانه‌های جدید مهاجرت کنید .
کتابخانه‌های قدیمی به ویژگی‌های جدید (مانند Live API و Veo ) دسترسی ندارند و در مسیر منسوخ شدن هستند. دریافت به‌روزرسانی‌ها در 30 نوامبر 2025 متوقف خواهد شد، شکاف‌های ویژگی‌ها افزایش می‌یابد و ممکن است اشکالات احتمالی دیگر برطرف نشوند.
وضعیت پشتیبانی هر کتابخانه قدیمی متفاوت است که جزئیات آن در جدول زیر آمده است:
| زبان | کتابخانه قدیمی | وضعیت پشتیبانی | کتابخانه پیشنهادی |
|---|---|---|---|
| پایتون | google-generativeai | تمام پشتیبانی، از جمله رفع اشکالات، در تاریخ 30 نوامبر 2025 به پایان می‌رسد. | google-genai |
| جاوا اسکریپت/تایپ اسکریپت | @google/generativeai | تمام پشتیبانی، از جمله رفع اشکالات، در تاریخ 30 نوامبر 2025 به پایان می‌رسد. | @google/genai |
| برو | google.golang.org/generative-ai | تمام پشتیبانی، از جمله رفع اشکالات، در تاریخ 30 نوامبر 2025 به پایان می‌رسد. | google.golang.org/genai |
| دارت و فلاتر | google_generative_ai | به طور فعال نگهداری نمی‌شود | از کتابخانه‌های مورد اعتماد جامعه یا شخص ثالث مانند firebase_ai استفاده کنید یا با استفاده از REST API به آن دسترسی پیدا کنید. |
| سویفت | generative-ai-swift | به طور فعال نگهداری نمی‌شود | از منطق هوش مصنوعی فایربیس استفاده کنید |
| اندروید | generative-ai-android | به طور فعال نگهداری نمی‌شود | از منطق هوش مصنوعی فایربیس استفاده کنید |
نکته برای توسعه‌دهندگان جاوا: هیچ SDK جاوای قدیمی ارائه شده توسط گوگل برای رابط برنامه‌نویسی Gemini وجود ندارد، بنابراین نیازی به مهاجرت از کتابخانه قبلی گوگل نیست. می‌توانید مستقیماً با کتابخانه جدید در بخش پشتیبانی و نصب زبان شروع کنید.
قالب‌های آماده برای تولید کد
مدل‌های مولد (مثلاً Gemini، Claude) و IDEهای مبتنی بر هوش مصنوعی (مثلاً Cursor) ممکن است به دلیل محدودیت داده‌های آموزشی، کدی را برای API Gemini با استفاده از کتابخانه‌های قدیمی یا منسوخ‌شده تولید کنند. برای اینکه کد تولید شده از جدیدترین کتابخانه‌های توصیه‌شده استفاده کند، نسخه و راهنمای استفاده را مستقیماً در اعلان‌های خود ارائه دهید. می‌توانید از الگوهای زیر برای ارائه زمینه لازم استفاده کنید: