ספריות 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/go-genai

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

זמינות כללית

התחלנו להשיק את Google GenAI SDK, קבוצה חדשה של ספריות לגישה ל-Gemini API, בסוף 2024 כשהשקנו את Gemini 2.0.

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

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

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

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

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

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

שפה ספרייה מדור קודם סטטוס התמיכה ספרייה מומלצת
Python google-generativeai כל התמיכה, כולל תיקוני באגים, תסתיים ב-30 בנובמבר 2025. google-genai
‫JavaScript/TypeScript @google/generativeai כל התמיכה, כולל תיקוני באגים, תסתיים ב-30 בנובמבר 2025. @google/genai
Go google.golang.org/generative-ai כל התמיכה, כולל תיקוני באגים, תסתיים ב-30 בנובמבר 2025. 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 באמצעות ספריות לא עדכניות או שהוצאו משימוש, בגלל נתוני האימון שלו. כדי שהקוד שנוצר ישתמש בספריות העדכניות והמומלצות, צריך לספק הנחיות לגבי הגרסה והשימוש ישירות בהנחיות. אתם יכולים להשתמש בתבניות שבהמשך כדי לספק את ההקשר הנדרש: