כשמפתחים באמצעות Gemini API, מומלץ להשתמש ב-Google GenAI SDK.
אלה הספריות הרשמיות שמוכנות לשימוש בסביבת ייצור, שאנחנו מפתחים ומתחזקים עבור השפות הפופולריות ביותר. הם נמצאים בזמינות כללית ומשמשים בכל הדוגמאות והמסמכים הרשמיים שלנו.
Google GenAI SDK זמין לשפות Python, JavaScript/TypeScript, Go ו-Java. אפשר להתקין את הספרייה של כל שפה באמצעות מנהלי חבילות,
או להיכנס למאגרי GitHub שלהן כדי להשתתף בפיתוח:
התחלנו להשיק את Google GenAI SDK, קבוצה חדשה של ספריות לגישה ל-Gemini API, בסוף 2024 כשהשקנו את Gemini 2.0.
החל ממאי 2025, הן זמינות לכלל המשתמשים (GA) בכל הפלטפורמות הנתמכות, והן הספריות המומלצות לגישה ל-Gemini API. הן יציבות, נתמכות באופן מלא לשימוש בשלב הייצור ומתוחזקות באופן פעיל. הם נותנים גישה לתכונות הכי עדכניות ומציעים את הביצועים הכי טובים בעבודה עם Gemini.
אם אתם משתמשים באחת מהספריות מדור קודם, מומלץ מאוד לבצע מיגרציה כדי שתוכלו לגשת לתכונות העדכניות ביותר וליהנות מהביצועים הטובים ביותר בעבודה עם Gemini. מידע נוסף זמין בקטע בנושא ספריות מדור קודם.
הספריות מדור קודם לא מספקות גישה לתכונות חדשות (כמו Live API ו-Veo) והן נמצאות בתהליך הוצאה משימוש. הם יפסיקו לקבל עדכונים ב-30 בנובמבר 2025, הפערים בתכונות יגדלו ויכול להיות שבאגים פוטנציאליים לא יתוקנו יותר.
סטטוס התמיכה של כל ספרייה מהדור הקודם משתנה, והוא מפורט בטבלה הבאה:
הערה למפתחי Java: לא הייתה גרסה קודמת של Java SDK שסופקה על ידי Google ל-Gemini API, ולכן לא נדרש מעבר מספרייה קודמת של Google. אפשר להתחיל ישירות עם הספרייה החדשה בקטע תמיכה בשפות והתקנה.
תבניות של הנחיות ליצירת קוד
מודלים גנרטיביים (למשל, Gemini, Claude) וסביבות פיתוח משולבות (IDE) מבוססות-AI (למשל, Cursor) עשוי ליצור קוד עבור Gemini API באמצעות ספריות לא עדכניות או שהוצאו משימוש, בגלל נתוני האימון שלו. כדי שהקוד שנוצר ישתמש בספריות העדכניות והמומלצות, צריך לספק הנחיות לגבי הגרסה והשימוש ישירות בהנחיות. אתם יכולים להשתמש בתבניות שבהמשך כדי לספק את ההקשר הנדרש:
[[["התוכן קל להבנה","easyToUnderstand","thumb-up"],["התוכן עזר לי לפתור בעיה","solvedMyProblem","thumb-up"],["סיבה אחרת","otherUp","thumb-up"]],[["חסרים לי מידע או פרטים","missingTheInformationINeed","thumb-down"],["התוכן מורכב מדי או עם יותר מדי שלבים","tooComplicatedTooManySteps","thumb-down"],["התוכן לא עדכני","outOfDate","thumb-down"],["בעיה בתרגום","translationIssue","thumb-down"],["בעיה בדוגמאות/בקוד","samplesCodeIssue","thumb-down"],["סיבה אחרת","otherDown","thumb-down"]],["עדכון אחרון: 2025-08-25 (שעון UTC)."],[],[],null,["# Gemini API libraries\n\n\u003cbr /\u003e\n\nWhen building with the Gemini API, we recommend using the **Google GenAI SDK** .\nThese are the official, production-ready libraries that we develop and maintain\nfor the most popular languages. They are in [General Availability](/gemini-api/docs/libraries#new-libraries) and used in all our official\ndocumentation and examples.\n| **Note:** If you're using one of our legacy libraries, we strongly recommend you [migrate](/gemini-api/docs/migrate) to the Google GenAI SDK. Review the [legacy libraries](/gemini-api/docs/libraries#previous-sdks) section for more information.\n\nIf you're new to the Gemini API, follow our [quickstart guide](/gemini-api/docs/quickstart) to get started.\n\nLanguage support and installation\n---------------------------------\n\nThe Google GenAI SDK is available for the Python, JavaScript/TypeScript, Go and\nJava languages. You can install each language's library using package managers,\nor visit their GitHub repos for further engagement: \n\n### Python\n\n- Library: [`google-genai`](https://pypi.org/project/google-genai)\n\n- GitHub Repository: [googleapis/python-genai](https://github.com/googleapis/python-genai)\n\n- Installation: `pip install google-genai`\n\n### JavaScript\n\n- Library: [`@google/genai`](https://www.npmjs.com/package/@google/genai)\n\n- GitHub Repository: [googleapis/js-genai](https://github.com/googleapis/js-genai)\n\n- Installation: `npm install @google/genai`\n\n### Go\n\n- Library: [`google.golang.org/genai`](https://pkg.go.dev/google.golang.org/genai)\n\n- GitHub Repository: [googleapis/go-genai](https://github.com/googleapis/go-genai)\n\n- Installation: `go get google.golang.org/genai`\n\n### Java\n\n- Library: `google-genai`\n\n- GitHub Repository: [googleapis/java-genai](https://github.com/googleapis/java-genai)\n\n- Installation: If you're using Maven, add the following to your dependencies:\n\n \u003cdependencies\u003e\n \u003cdependency\u003e\n \u003cgroupId\u003ecom.google.genai\u003c/groupId\u003e\n \u003cartifactId\u003egoogle-genai\u003c/artifactId\u003e\n \u003cversion\u003e1.0.0\u003c/version\u003e\n \u003c/dependency\u003e\n \u003c/dependencies\u003e\n\nGeneral availability\n--------------------\n\nWe started rolling out Google GenAI SDK, a new set of libraries to access Gemini\nAPI, in late 2024 when we launched Gemini 2.0.\n\nAs of May 2025, they reached General Availability (GA) across all supported\nplatforms and are the recommended libraries to access the Gemini API. They are\nstable, fully supported for production use, and are actively maintained. They\nprovide access to the latest features, and offer the best performance working\nwith Gemini.\n\nIf you're using one of our legacy libraries,\nwe strongly recommend you migrate so that you can access the latest features and\nget the best performance working with Gemini. Review the [legacy libraries](/gemini-api/docs/libraries#previous-sdks) section for more information.\n\nLegacy libraries and migration\n------------------------------\n\nIf you are using one of our legacy libraries, we recommend that you\n[migrate to the new libraries](/gemini-api/docs/migrate).\n\nThe legacy libraries don't provide access to recent features (such as\n[Live API](/gemini-api/docs/live) and [Veo](/gemini-api/docs/video)) and are on\na deprecation path. They will stop receiving updates on November 30th,\n2025, the feature gaps will grow and potential bugs may no longer get fixed.\n\nEach legacy library's support status varies, detailed in the following table:\n\n| Language | Legacy library | Support status | Recommended library |\n|---------------------------|-----------------------------------------------------------------------------------------|----------------------------------------------------------------|------------------------------------------------------------------------------------------------------------------------------------|\n| **Python** | [google-generativeai](https://github.com/google-gemini/deprecated-generative-ai-python) | All support, including bug fixes, ends on November 30th, 2025. | [google-genai](https://github.com/googleapis/python-genai) |\n| **JavaScript/TypeScript** | [@google/generativeai](https://github.com/google-gemini/generative-ai-js) | All support, including bug fixes, ends on November 30th, 2025. | [@google/genai](https://github.com/googleapis/js-genai) |\n| **Go** | [google.golang.org/generative-ai](https://github.com/google/generative-ai-go) | All support, including bug fixes, ends on November 30th, 2025. | [google.golang.org/genai](https://github.com/googleapis/go-genai) |\n| **Dart and Flutter** | [google_generative_ai](https://pub.dev/packages/google_generative_ai/install) | Not actively maintained | Use trusted community or third party libraries, like [firebase_ai](https://pub.dev/packages/firebase_ai), or access using REST API |\n| **Swift** | [generative-ai-swift](https://github.com/google/generative-ai-swift) | Not actively maintained | Use [Firebase AI Logic](https://firebase.google.com/products/firebase-ai-logic) |\n| **Android** | [generative-ai-android](https://github.com/google-gemini/generative-ai-android) | Not actively maintained | Use [Firebase AI Logic](https://firebase.google.com/products/firebase-ai-logic) |\n\n**Note for Java developers:** There was no legacy Google-provided Java SDK for\nthe Gemini API, so no migration from a previous Google library is required. You\ncan start directly with the new library in the\n[Language support and installation](#install) section.\n\nPrompt templates for code generation\n------------------------------------\n\nGenerative models (e.g., Gemini, Claude) and AI-powered IDEs (e.g., Cursor) may\nproduce code for the Gemini API using outdated or deprecated libraries due to\ntheir training data cutoff. For the generated code to use the latest,\nrecommended libraries, provide version and usage guidance directly in your\nprompts. You can use the templates below to provide the necessary context:\n\n- [Python](https://github.com/googleapis/python-genai/blob/main/codegen_instructions.md)\n\n- [JavaScript/TypeScript](https://github.com/googleapis/js-genai/blob/main/codegen_instructions.md)"]]
