کتابخانه های Gemini API

When building with the Gemini API, we recommend using the Google GenAI SDK . These are the official, production-ready libraries that we develop and maintain for the most popular languages. They are in General Availability and used in all our official documentation and examples.

If you're new to the Gemini API, follow our quickstart guide to get started.

پشتیبانی و نصب زبان

Google GenAI SDK برای زبان‌های Python، JavaScript/TypeScript، Go و Java در دسترس است. You can install each language's library using package managers, or visit their GitHub repos for further engagement:

پایتون

جاوا اسکریپت

برو

جاوا

  • کتابخانه: google-genai

  • مخزن GitHub: googleapis/java-genai

  • Installation: If you're using Maven, add the following to your dependencies: 

<dependencies>
  <dependency>
    <groupId>com.google.genai</groupId>
    <artifactId>google-genai</artifactId>
    <version>1.0.0</version>
  </dependency>
</dependencies>

در دسترس بودن عمومی

We started rolling out Google GenAI SDK, a new set of libraries to access Gemini API, in late 2024 when we launched Gemini 2.0.

از ماه مه 2025، آنها در همه پلتفرم‌های پشتیبانی شده به دسترسی عمومی (GA) رسیدند و کتابخانه‌های توصیه‌شده برای دسترسی به Gemini API هستند. آنها پایدار هستند، به طور کامل برای استفاده در تولید پشتیبانی می شوند و به طور فعال نگهداری می شوند. They provide access to the latest features, and offer the best performance working with Gemini.

اگر از یکی از کتابخانه‌های قدیمی ما استفاده می‌کنید، اکیداً توصیه می‌کنیم که مهاجرت کنید تا بتوانید به آخرین ویژگی‌ها دسترسی داشته باشید و بهترین عملکرد را در کار با Gemini داشته باشید. Review the legacy libraries section for more information.

کتابخانه های قدیمی و مهاجرت

اگر از یکی از کتابخانه های قدیمی ما استفاده می کنید، توصیه می کنیم به کتابخانه های جدید مهاجرت کنید.

کتابخانه‌های قدیمی دسترسی به ویژگی‌های اخیر (مانند Live API و Veo ) را فراهم نمی‌کنند و در مسیر منسوخ شدن قرار دارند. دریافت به‌روزرسانی‌ها در پایان سپتامبر 2025 متوقف می‌شود، شکاف‌های ویژگی‌ها افزایش می‌یابد و ممکن است دیگر باگ‌های احتمالی برطرف نشوند.

Each legacy library's support status varies, detailed in the following table:

زبان کتابخانه میراثی وضعیت پشتیبانی کتابخانه پیشنهادی
پایتون google-generativeai تمام پشتیبانی، از جمله رفع اشکال، در پایان سپتامبر 2025 به پایان می رسد. google-genai
جاوا اسکریپت/تایپ اسکریپت @google/generativeai تمام پشتیبانی، از جمله رفع اشکال، در پایان سپتامبر 2025 به پایان می رسد. @google/genai
برو google.golang.org/generative-ai تمام پشتیبانی، از جمله رفع اشکال، در پایان سپتامبر 2025 به پایان می رسد. google.golang.org/genai
دارت و فلاتر google_generative_ai به طور فعال نگهداری نمی شود از انجمن های مورد اعتماد یا کتابخانه های شخص ثالث مانند firebase_ai استفاده کنید یا با استفاده از REST API دسترسی داشته باشید
سویفت generative-ai-swift به طور فعال نگهداری نمی شود از Firebase AI Logic استفاده کنید
اندروید generative-ai-android به طور فعال نگهداری نمی شود از Firebase AI Logic استفاده کنید

نکته برای توسعه دهندگان جاوا: هیچ جاوا SDK قدیمی ارائه شده توسط Google برای Gemini API وجود نداشت، بنابراین نیازی به انتقال از کتابخانه قبلی Google نیست. می توانید مستقیماً با کتابخانه جدید در بخش پشتیبانی و نصب زبان شروع کنید.