عند إنشاء التطبيقات باستخدام 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
Go
المكتبة:
google.golang.org/genaiمستودع GitHub: googleapis/go-genai
التثبيت:
go get google.golang.org/genai
جافا
المكتبة:
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/dotnet-genai
التثبيت:
dotnet add package Google.GenAI
متوفر للجمهور العام
اعتبارًا من مايو 2025، أصبحت حزمة تطوير البرامج (SDK) من Google للذكاء الاصطناعي التوليدي متاحة للجمهور العام على جميع المنصات المتوافقة، وهي المكتبات المقترَحة للوصول إلى Gemini API. وهي مستقرة ومعتمَدة بالكامل للاستخدام في الإنتاج وتتم صيانتها بشكل نشط. تتيح هذه الأجهزة الوصول إلى أحدث الميزات، وتوفّر أفضل أداء عند استخدامها مع Gemini.
إذا كنت تستخدم إحدى مكتباتنا القديمة، ننصحك بشدة بالانتقال إلى المكتبة الجديدة لتتمكّن من الوصول إلى أحدث الميزات والحصول على أفضل أداء عند العمل مع Gemini. يُرجى مراجعة قسم المكتبات القديمة لمزيد من المعلومات.
المكتبات القديمة ونقل البيانات
إذا كنت تستخدم إحدى مكتباتنا القديمة، ننصحك بالانتقال إلى المكتبات الجديدة.
لا تتيح المكتبات القديمة الوصول إلى الميزات الحديثة (مثل Live API وVeo) وهي متوقفة نهائيًا اعتبارًا من 30 نوفمبر 2025.
تختلف حالة توفّر كل مكتبة قديمة، كما هو موضّح في الجدول التالي:
| اللغة | المكتبة القديمة | حالة الدعم | المكتبة المقترَحة |
|---|---|---|---|
| Python | google-generativeai |
لا تتم صيانته بشكل نشط | google-genai |
| JavaScript/TypeScript | @google/generativeai |
لا تتم صيانته بشكل نشط | @google/genai |
| Go | google.golang.org/generative-ai |
لم يتم صيانتها بشكل نشط | google.golang.org/genai |
| Dart وFlutter | google_generative_ai |
لا تتم صيانته بشكل نشط | استخدام Genkit Dart أو Firebase AI Logic |
| Swift | generative-ai-swift |
لا تتم صيانته بشكل نشط | استخدام Firebase AI Logic |
| Android | generative-ai-android |
لم يتم صيانتها بشكل نشط | استخدام Firebase AI Logic |
ملاحظة لمطوّري Java: لم تكن هناك حزمة SDK قديمة للغة Java توفّرها Google لواجهة Gemini API، لذا لا يلزم نقل البيانات من مكتبة Google السابقة. يمكنك البدء مباشرةً باستخدام المكتبة الجديدة في قسم اللغات المتاحة والتثبيت.