عند الإنشاء باستخدام Gemini API، ننصحك باستخدام حزمة Google GenAI SDK. هذه هي المكتبات الرسمية الجاهزة للاستخدام في بيئات الإنتاج والتي نعمل على تطويرها وصيانتها للغات الأكثر شيوعًا. وهي متاحة للجمهور العام وتُستخدم في جميع مستنداتنا وأمثلتنا الرسمية.
إذا كنت تستخدم Gemini API للمرة الأولى، اتّبِع دليل البدء السريع للبدء.
اللغات المتاحة والتثبيت
تتوفّر حزمة Google GenAI SDK للغات 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
جافا
المكتبة:
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، أصبحت حزمة Google GenAI SDK متاحة للجمهور العام على جميع الأنظمة الأساسية المتوافقة، وهي المكتبات المقترَحة للوصول إلى Gemini API. وهي مكتبات ثابتة ومتاحة بالكامل للاستخدام في بيئات الإنتاج، ونعمل على صيانتها بشكل نشط. تتيح هذه المكتبات الوصول إلى أحدث الميزات وتقدّم أفضل أداء عند استخدام Gemini.
إذا كنت تستخدم إحدى مكتباتنا القديمة، ننصحك بشدة بنقل البيانات حتى تتمكّن من الوصول إلى أحدث الميزات والحصول على أفضل أداء عند استخدام Gemini. راجِع قسم الـمكتبات القديمة لمزيد من المعلومات.
المكتبات القديمة ونقل البيانات
إذا كنت تستخدم إحدى مكتباتنا القديمة، ننصحك بنقل البيانات إلى المكتبات الجديدة.
لا تتيح المكتبات القديمة الوصول إلى الميزات الحديثة (مثل Live API وVeo)، وسيتم إيقافها نهائيًا اعتبارًا من 30 نوفمبر 2025.
تختلف حالة الدعم لكل مكتبة قديمة، كما هو موضّح بالتفصيل في الجدول التالي:
| اللغة | المكتبة القديمة | حالة الدعم | المكتبة المقترَحة |
|---|---|---|---|
| Python | google-generativeai |
لا تتم صيانتها بشكل نشط | google-genai |
| JavaScript/TypeScript | @google/generativeai |
لا تتم صيانتها بشكل نشط | @google/genai |
| انتقال | 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: لم تكن هناك حزمة Java SDK قديمة من Google لـ Gemini API، لذا لا يلزم نقل البيانات من مكتبة سابقة من Google. يمكنك البدء مباشرةً بالمكتبة الجديدة في قسم اللغات المتاحة والتثبيت.