هنگام ساخت با 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 | به طور فعال نگهداری نمیشود | از کتابخانههای مورد اعتماد جامعه یا شخص ثالث مانند firebase_ai استفاده کنید یا با استفاده از REST API به آن دسترسی پیدا کنید. |
| سویفت | generative-ai-swift | به طور فعال نگهداری نمیشود | از منطق هوش مصنوعی فایربیس استفاده کنید |
| اندروید | generative-ai-android | به طور فعال نگهداری نمیشود | از منطق هوش مصنوعی فایربیس استفاده کنید |
نکته برای توسعهدهندگان جاوا: هیچ SDK جاوای قدیمی ارائه شده توسط گوگل برای رابط برنامهنویسی Gemini وجود ندارد، بنابراین نیازی به مهاجرت از کتابخانه قبلی گوگل نیست. میتوانید مستقیماً با کتابخانه جدید در بخش پشتیبانی و نصب زبان شروع کنید.
مدلهای مولد (مثلاً Gemini، Claude) و IDEهای مبتنی بر هوش مصنوعی (مثلاً Cursor) ممکن است به دلیل محدودیت دادههای آموزشی، کدی را برای API Gemini با استفاده از کتابخانههای قدیمی یا منسوخشده تولید کنند. برای اینکه کد تولید شده از جدیدترین کتابخانههای توصیهشده استفاده کند، نسخه و راهنمای استفاده را مستقیماً در اعلانهای خود ارائه دهید. میتوانید از الگوهای زیر برای ارائه زمینه لازم استفاده کنید: