مكتبات Gemini API

عند إنشاء التطبيقات باستخدام Gemini API، ننصحك باستخدام Google GenAI SDK. هذه هي المكتبات الرسمية الجاهزة للإنتاج التي نطورها ونحافظ عليها للغات الأكثر شيوعًا. وهي متوفرة للجمهور العام ومُستخدَمة في جميع مستنداتنا الرسمية وأمثلتنا.

إذا كنت مستخدمًا جديدًا لـ Gemini API، يمكنك الاطّلاع على دليل البدء للبدء.

اللغات المتاحة والتثبيت

تتوفّر حزمة تطوير البرامج (SDK) للذكاء الاصطناعي التوليدي من Google للغات Python وJavaScript/TypeScript وGo وJava. يمكنك تثبيت مكتبة كل لغة باستخدام أدوات إدارة الحِزم، أو زيارة مستودعات GitHub الخاصة بها لمزيد من التفاعل:

Python

JavaScript

Go

جافا

  • المكتبة: 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
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: لم تتوفّر حزمة Java SDK قديمة من Google لواجهة Gemini API، لذا لا حاجة إلى نقل البيانات من مكتبة Google سابقة. يمكنك البدء مباشرةً باستخدام المكتبة الجديدة في قسم دعم اللغة والتثبيت.