عند إنشاء تطبيقات باستخدام 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
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>
#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 |
لم يتم صيانتها بشكل نشط | استخدام مكتبات موثوق بها من المنتدى أو من جهات خارجية، مثل 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 السابقة. يمكنك البدء مباشرةً باستخدام المكتبة الجديدة في قسم اللغات المتوافقة والتثبيت.
نماذج الطلبات لإنشاء الرموز البرمجية
النماذج التوليدية (مثل Gemini وClaude) وبيئات التطوير المتكاملة المستندة إلى الذكاء الاصطناعي (مثل قد ينتج عن استخدام أدوات مثل Cursor رمز برمجي لواجهة برمجة تطبيقات Gemini باستخدام مكتبات قديمة أو متوقفة نهائيًا بسبب تاريخ انتهاء صلاحية بيانات التدريب. لكي يستخدم الرمز البرمجي الذي تم إنشاؤه أحدث المكتبات المقترَحة، قدِّم إرشادات حول الإصدار والاستخدام مباشرةً في طلباتك. يمكنك استخدام النماذج أدناه لتقديم السياق اللازم: