ספריות Gemini API

כשמפתחים באמצעות Gemini API, מומלץ להשתמש ב-Google GenAI SDK. אלה ספריות רשמיות שמוכנות לשימוש בסביבת ייצור, שאנחנו מפתחים ומתחזקים עבור השפות הפופולריות ביותר. הם נמצאים בזמינות כללית ומשמשים בכל הדוגמאות והמסמכים הרשמיים שלנו.

אם אתם משתמשים ב-Gemini API בפעם הראשונה, כדאי לעיין במדריך למתחילים.

שפות נתמכות והתקנה

‫Google GenAI SDK זמין לשפות Python, ‏ JavaScript/TypeScript, ‏ Go ו-Java. אפשר להתקין את הספרייה של כל שפה באמצעות מנהלי חבילות, או להיכנס למאגרי GitHub שלהן כדי לקבל מידע נוסף:

Python

JavaScript

Go

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>

C#‎

  • ספרייה: Google.GenAI

  • מאגר GitHub: ‏ googleapis/dotnet-genai

  • התקנה: dotnet add package Google.GenAI

זמינות כללית

החל ממאי 2025, ערכת Google GenAI SDK זמינה לכולם (GA) בכל הפלטפורמות הנתמכות, והיא הספרייה המומלצת לגישה ל-Gemini API. הם יציבים, נתמכים באופן מלא לשימוש בשלב הייצור ומתעדכנים באופן פעיל. הם מספקים גישה לתכונות העדכניות ביותר ומציעים את הביצועים הכי טובים בעבודה עם Gemini.

אם אתם משתמשים באחת מהספריות מדור קודם, מומלץ מאוד לבצע מיגרציה כדי שתוכלו לגשת לתכונות העדכניות ביותר וליהנות מהביצועים הטובים ביותר בעבודה עם Gemini. מידע נוסף זמין בקטע ספריות מדור קודם.

ספריות קודמות והעברה

אם אתם משתמשים באחת מהספריות הקודמות שלנו, מומלץ לעבור לספריות החדשות.

הספריות מדור קודם לא מספקות גישה לתכונות חדשות (כמו Live API ו-Veo), והן יוצאו משימוש החל מ-30 בנובמבר 2025.

סטטוס התמיכה של כל ספרייה מהדור הקודם משתנה, והוא מפורט בטבלה הבאה:

שפה ספרייה מדור קודם סטטוס התמיכה ספרייה מומלצת
Python google-generativeai לא מתבצע תחזוקה פעילה google-genai
‫JavaScript/TypeScript @google/generativeai לא מתבצע תחזוקה פעילה @google/genai
Go google.golang.org/generative-ai לא מתבצע תחזוקה פעילה google.golang.org/genai
‫Dart ו-Flutter google_generative_ai לא מתבצע תחזוקה פעילה שימוש בספריות מהימנות של הקהילה או של צד שלישי, כמו firebase_ai, או גישה באמצעות API ל-REST
Swift generative-ai-swift לא מתבצע תחזוקה פעילה שימוש ב-Firebase AI Logic
Android generative-ai-android לא מתבצע תחזוקה פעילה שימוש ב-Firebase AI Logic

הערה למפתחי Java: לא הייתה גרסה קודמת של Java SDK שסופקה על ידי Google ל-Gemini API, ולכן לא נדרש מעבר מספרייה קודמת של Google. אפשר להתחיל ישירות עם הספרייה החדשה בקטע תמיכה בשפות והתקנה.

תבניות של הנחיות ליצירת קוד

מודלים גנרטיביים (למשל, ‫Gemini, ‏ Claude) וסביבות פיתוח משולבות (IDE) מבוססות-AI (לדוגמה, יכול להיות ש-Cursor) ייצור קוד ל-Gemini API באמצעות ספריות לא עדכניות או שהוצאו משימוש, בגלל נתוני האימון שלו. כדי שהקוד שנוצר ישתמש בספריות העדכניות והמומלצות, צריך לספק הנחיות לגבי הגרסה והשימוש ישירות בהנחיות. אתם יכולים להשתמש בתבניות שבהמשך כדי לספק את ההקשר הנדרש: