عند إنشاء تطبيقات باستخدام Gemini API، ننصحك باستخدام مجموعتنا الرسمية من المكتبات المتوافقة مع اللغات الرئيسية، وهي Google GenAI SDK. وهي جاهزة للاستخدام في بيئة الإنتاج ضمن التوفّر للجمهور العام. تم إنشاء العيّنات والمستندات على هذا الموقع الإلكتروني باستخدام هذه المكتبات.
إذا كنت تستخدم Gemini API للمرة الأولى، اتّبِع دليل البدء السريع للبدء.
اللغات المتوافقة وعملية التثبيت
تتوفّر حزمة تطوير البرامج (SDK) من Google للذكاء الاصطناعي التوليدي للغات 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
انتقال
المكتبة:
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>
مدى التوفّر للجميع
بدأنا بطرح "حزمة تطوير البرامج" (SDK) من Google للذكاء الاصطناعي التوليدي في أواخر عام 2024. اعتبارًا من مايو 2025، أصبحت هذه الميزة متاحة للجميع على جميع المنصات المتوافقة. وهذا يعني أنّ المكتبات مستقرة ومتوافقة تمامًا مع الاستخدام في بيئة الإنتاج. ويتم صيانتها بشكل نشط، وتتيح الوصول إلى أحدث الميزات، وتوفّر أفضل أداء عند استخدامها مع Gemini.
إذا كنت لا تستخدم حزمة تطوير البرامج (SDK) من Google GenAI وتستخدم إحدى مكتباتنا القديمة، ننصحك بشدة بنقل البيانات. راجِع قسم المكتبات القديمة للحصول على مزيد من المعلومات.
المكتبات القديمة ونقل البيانات
إذا كنت تستخدم إحدى مكتباتنا القديمة، ننصحك بالانتقال إلى المكتبات الجديدة.
لا تتيح المكتبات القديمة الوصول إلى الميزات الحديثة (مثل 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، أو الوصول إليها باستخدام REST API |
| Swift | generative-ai-swift |
لم يعُد يتم صيانتها | استخدام Gemini في Firebase |
| Android | generative-ai-android |
لم يعُد يتم صيانتها | استخدام Gemini في Firebase |
ملاحظة لمطوّري Java: لم تتوفّر حزمة SDK قديمة للغة Java من Google لواجهة Gemini API، لذا لا يلزم نقل البيانات من مكتبة Google السابقة. يمكنك البدء مباشرةً باستخدام المكتبة الجديدة في قسم اللغات المتوافقة والتثبيت.