هنگام ساخت با Gemini API، توصیه می کنیم از Google GenAI SDK استفاده کنید. اینها کتابخانه های رسمی و آماده تولید هستند که ما برای محبوب ترین زبان ها ایجاد و نگهداری می کنیم. آنها در دسترس عمومی هستند و در تمام اسناد و نمونه های رسمی ما استفاده می شوند.
اگر با Gemini API تازه کار هستید، راهنمای شروع سریع ما را برای شروع دنبال کنید.
پشتیبانی و نصب زبان
Google GenAI SDK برای زبان‌های Python، JavaScript/TypeScript، Go و Java در دسترس است. می‌توانید کتابخانه هر زبان را با استفاده از مدیران بسته نصب کنید، یا از مخازن GitHub آنها برای تعامل بیشتر بازدید کنید:
ما در اواخر سال 2024 زمانی که Gemini 2.0 را راه اندازی کردیم، راه اندازی Google GenAI SDK، مجموعه جدیدی از کتابخانه ها برای دسترسی به Gemini API را آغاز کردیم.
از ماه مه 2025، آنها در همه پلتفرم‌های پشتیبانی شده به دسترسی عمومی (GA) رسیدند و کتابخانه‌های توصیه‌شده برای دسترسی به Gemini API هستند. آنها پایدار هستند، به طور کامل برای استفاده در تولید پشتیبانی می شوند و به طور فعال نگهداری می شوند. آنها دسترسی به آخرین ویژگی ها را فراهم می کنند و بهترین عملکرد را در کار با Gemini ارائه می دهند.
اگر از یکی از کتابخانه‌های قدیمی ما استفاده می‌کنید، اکیداً توصیه می‌کنیم که مهاجرت کنید تا بتوانید به آخرین ویژگی‌ها دسترسی داشته باشید و بهترین عملکرد را در کار با Gemini داشته باشید. برای اطلاعات بیشتر، بخش کتابخانه‌های قدیمی را مرور کنید.
کتابخانه‌های قدیمی دسترسی به ویژگی‌های اخیر (مانند Live API و Veo ) را فراهم نمی‌کنند و در مسیر منسوخ شدن قرار دارند. دریافت به‌روزرسانی‌ها در 30 نوامبر 2025 متوقف می‌شود، شکاف‌های ویژگی‌ها افزایش می‌یابد و ممکن است دیگر باگ‌های احتمالی برطرف نشوند.
وضعیت پشتیبانی هر کتابخانه قدیمی متفاوت است که در جدول زیر توضیح داده شده است:
نکته برای توسعه دهندگان جاوا: هیچ جاوا SDK قدیمی ارائه شده توسط Google برای Gemini API وجود نداشت، بنابراین نیازی به انتقال از کتابخانه قبلی Google نیست. می توانید مستقیماً با کتابخانه جدید در بخش پشتیبانی و نصب زبان شروع کنید.
قالب های سریع برای تولید کد
مدل‌های تولیدی (مانند جمینی، کلود) و IDEهای مبتنی بر هوش مصنوعی (به‌عنوان مثال، مکان‌نما) ممکن است با استفاده از کتابخانه‌های منسوخ یا منسوخ، کدهایی را برای Gemini API تولید کنند که دلیل آن برش داده‌های آموزشی است. برای اینکه کد تولید شده از جدیدترین کتابخانه های توصیه شده استفاده کند، نسخه و راهنمای استفاده را مستقیماً در درخواست های خود ارائه دهید. می توانید از الگوهای زیر برای ارائه زمینه لازم استفاده کنید:
تاریخ آخرین بهروزرسانی 2025-08-22 بهوقت ساعت هماهنگ جهانی.
[[["درک آسان","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-22 بهوقت ساعت هماهنگ جهانی."],[],[],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)"]]
