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

هنگام ساخت با Gemini API، توصیه می کنیم از Google GenAI SDK استفاده کنید. اینها کتابخانه های رسمی و آماده تولید هستند که ما برای محبوب ترین زبان ها ایجاد و نگهداری می کنیم. آنها در دسترس عمومی هستند و در تمام اسناد و نمونه های رسمی ما استفاده می شوند.

اگر با Gemini API تازه کار هستید، راهنمای شروع سریع ما را برای شروع دنبال کنید.

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

Google GenAI SDK برای زبان‌های Python، JavaScript/TypeScript، Go و Java در دسترس است. می‌توانید کتابخانه هر زبان را با استفاده از مدیران بسته نصب کنید، یا از مخازن GitHub آنها برای تعامل بیشتر بازدید کنید:

پایتون

جاوا اسکریپت

برو

جاوا

  • کتابخانه: 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>

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

ما در اواخر سال 2024 زمانی که Gemini 2.0 را راه اندازی کردیم، راه اندازی Google GenAI SDK، مجموعه جدیدی از کتابخانه ها برای دسترسی به Gemini API را آغاز کردیم.

از ماه مه 2025، آنها در همه پلتفرم‌های پشتیبانی شده به دسترسی عمومی (GA) رسیدند و کتابخانه‌های توصیه‌شده برای دسترسی به Gemini API هستند. آنها پایدار هستند، به طور کامل برای استفاده در تولید پشتیبانی می شوند و به طور فعال نگهداری می شوند. آنها دسترسی به آخرین ویژگی ها را فراهم می کنند و بهترین عملکرد را در کار با 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 به طور فعال نگهداری نمی شود از Firebase AI Logic استفاده کنید
اندروید generative-ai-android به طور فعال نگهداری نمی شود از Firebase AI Logic استفاده کنید

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

قالب های سریع برای تولید کد

مدل‌های تولیدی (مانند جمینی، کلود) و IDE‌های مبتنی بر هوش مصنوعی (به‌عنوان مثال، مکان‌نما) ممکن است با استفاده از کتابخانه‌های منسوخ یا منسوخ، کدهایی را برای Gemini API تولید کنند که دلیل آن برش داده‌های آموزشی است. برای اینکه کد تولید شده از جدیدترین کتابخانه های توصیه شده استفاده کند، نسخه و راهنمای استفاده را مستقیماً در درخواست های خود ارائه دهید. می توانید از الگوهای زیر برای ارائه زمینه لازم استفاده کنید: