כשמפתחים באמצעות Gemini API, מומלץ להשתמש באוסף הרשמי של הספריות שלנו בשפות העיקריות: Google GenAI SDK. הם מוכנים לשימוש בסביבת ייצור במסגרת זמינות כללית. הדוגמאות והתיעוד באתר הזה מבוססים על הספריות האלה.
אם אתם חדשים ב-Gemini API, כדאי לעיין במדריך למתחילים.
שפות נתמכות והתקנה
Google GenAI SDK זמין לשפות 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
Go
ספרייה:
google.golang.org/genaiמאגר GitHub: googleapis/go-genai
התקנה:
go get google.golang.org/genai
Java
ספרייה:
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>
זמינות כללית
התחלנו להשיק את Google GenAI SDK בסוף 2024. החל ממאי 2025, הוא זמין לכלל המשתמשים (GA) בכל הפלטפורמות הנתמכות. כלומר, הספריות יציבות ויש להן תמיכה מלאה לשימוש בשלב הייצור. אנחנו מתחזקים אותם באופן פעיל, הם מספקים גישה לתכונות העדכניות ביותר ומציעים את הביצועים הכי טובים בעבודה עם Gemini.
אם אתם לא משתמשים ב-Google GenAI SDK ואתם משתמשים באחת מהספריות מדור קודם שלנו, מומלץ מאוד לבצע מיגרציה. מידע נוסף זמין בקטע ספריות מדור קודם.
ספריות קודמות והעברה
אם אתם משתמשים באחת מהספריות הקודמות שלנו, מומלץ לעבור לספריות החדשות.
הספריות מדור קודם לא מספקות גישה לתכונות חדשות (כמו Live API ו-Veo) והן נמצאות בתהליך הוצאה משימוש. הם יפסיקו לקבל עדכונים בסוף ספטמבר 2025, הפערים בתכונות יגדלו ויכול להיות שבאגים פוטנציאליים לא יתוקנו יותר.
סטטוס התמיכה של כל ספרייה מהדור הקודם משתנה, והוא מפורט בטבלה הבאה:
| שפה | ספרייה מדור קודם | סטטוס התמיכה | ספרייה מומלצת |
|---|---|---|---|
| Python | google-generativeai |
כל התמיכה, כולל תיקוני באגים, תסתיים בסוף ספטמבר 2025. | google-genai |
| JavaScript/TypeScript | @google/generativeai |
כל התמיכה, כולל תיקוני באגים, תסתיים בסוף ספטמבר 2025. | @google/genai |
| Go | google.golang.org/generative-ai |
כל התמיכה, כולל תיקוני באגים, תסתיים בסוף ספטמבר 2025. | google.golang.org/genai |
| Dart ו-Flutter | google_generative_ai |
לא מתוחזק באופן פעיל | אפשר להשתמש בספריות אמינות של הקהילה או של צד שלישי, כמו firebase_ai, או לגשת באמצעות API ל-REST |
| Swift | generative-ai-swift |
לא מתוחזק באופן פעיל | שימוש ב-Gemini ב-Firebase |
| Android | generative-ai-android |
לא מתוחזק באופן פעיל | שימוש ב-Gemini ב-Firebase |
הערה למפתחי Java: לא הייתה גרסה קודמת של Java SDK שסופקה על ידי Google ל-Gemini API, ולכן לא נדרש מעבר מספרייה קודמת של Google. אפשר להתחיל ישירות עם הספרייה החדשה בקטע תמיכה בשפות והתקנה.