כשמפתחים באמצעות 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, קבוצה חדשה של ספריות לגישה ל-Gemini API, בסוף 2024 כשהשקנו את Gemini 2.0.
החל ממאי 2025, הן זמינות לכלל המשתמשים (GA) בכל הפלטפורמות הנתמכות, והן הספריות המומלצות לגישה ל-Gemini API. הן יציבות, נתמכות באופן מלא לשימוש בסביבת ייצור ומתוחזקות באופן פעיל. הם מספקים גישה לתכונות הכי עדכניות ומציעים את הביצועים הכי טובים בעבודה עם Gemini.
אם אתם משתמשים באחת מהספריות מדור קודם שלנו, מומלץ מאוד לעבור לשימוש בספריות החדשות כדי שתוכלו לגשת לתכונות העדכניות ביותר וליהנות מהביצועים הטובים ביותר בעבודה עם Gemini. מידע נוסף זמין בקטע ספריות מדור קודם.
ספריות קודמות והעברה
אם אתם משתמשים באחת מהספריות הקודמות שלנו, מומלץ לעבור לספריות החדשות.
הספריות מדור קודם לא מספקות גישה לתכונות חדשות (כמו 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. אפשר להתחיל ישירות עם הספרייה החדשה בקטע תמיכה בשפות והתקנה.