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