مرجع Gemini API

يوضّح مرجع واجهة برمجة التطبيقات هذا واجهات برمجة التطبيقات الأحادية والمتدفقة وفي الوقت الفعلي التي يمكنك استخدامها للتفاعل مع نماذج Gemini. يمكنك استخدام واجهات REST API في أي بيئة تتيح طلبات HTTP. راجِع دليل البدء لمعرفة كيفية بدء استخدام أول طلب بيانات من واجهة برمجة التطبيقات. إذا كنت تبحث عن مراجع لمكتبات وحِزم SDK بلغات معيّنة، انتقِل إلى الرابط الخاص بتلك اللغة في شريط التنقّل الأيمن ضمن مراجع حِزم SDK.

نقاط النهاية الأساسية

تم تنظيم Gemini API حول نقاط النهاية الرئيسية التالية:

• التفاعلات (CreateInteraction) (يُنصح به): هذا العنصر الأساسي العادي هو الخيار الذي يُنصح به عند إنشاء تطبيقات باستخدام Gemini، وهو محسّن لخطوات سير العمل المستندة إلى الذكاء الاصطناعي الوكيل وإدارة الحالة من جهة الخادم والمحادثات المعقّدة المتعددة الوسائط والمحادثات المترابطة.
• إنشاء المحتوى العادي (generateContent): نقطة نهاية عادية لخدمة REST تعالج طلبك وتعرض الرد الكامل للنموذج في حزمة واحدة. هذا الخيار هو الأفضل للمهام غير التفاعلية التي يمكنك فيها انتظار النتيجة الكاملة.
• إنشاء المحتوى أثناء البث (streamGenerateContent): يستخدم هذا الخيار أحداثًا يتم إرسالها من الخادم (SSE) لإرسال أجزاء من الرد إليك أثناء إنشائها. يوفّر ذلك تجربة أسرع وأكثر تفاعلية للتطبيقات، مثل روبوتات الدردشة.
• Live API (BidiGenerateContent): هي واجهة برمجة تطبيقات مستندة إلى WebSocket وتتضمّن معلومات الحالة، وهي مصمّمة لحالات الاستخدام الحواري في الوقت الفعلي.
• وضع الدُفعات (batchGenerateContent): نقطة نهاية عادية لخدمة REST لإرسال دُفعات من طلبات generateContent.
• التضمينات (embedContent): نقطة نهاية REST عادية تنشئ متّجه تضمين نصي من الإدخال Content.
• واجهات Gen Media APIs: نقاط نهاية لإنشاء الوسائط باستخدام نماذجنا المتخصصة، مثل Imagen لإنشاء الصور وVeo لإنشاء الفيديوهات يتضمّن Gemini أيضًا هذه الإمكانات التي يمكنك الوصول إليها باستخدام واجهة برمجة التطبيقات generateContent.
• واجهات برمجة التطبيقات الخاصة بالمنصة: نقاط نهاية الأدوات المساعدة التي تتيح إمكانات أساسية، مثل تحميل الملفات واحتساب الرموز المميزة.

المصادقة

يجب أن تتضمّن جميع الطلبات المُرسَلة إلى Gemini API عنوان x-goog-api-key مع مفتاح واجهة برمجة التطبيقات. يمكنك إنشاء تطبيق ببضع نقرات في Google AI Studio.

في ما يلي مثال على طلب يتضمّن مفتاح واجهة برمجة التطبيقات في العنوان:

curl "https://generativelanguage.googleapis.com/v1beta/models/gemini-3.5-flash:generateContent" \
  -H "x-goog-api-key: $GEMINI_API_KEY" \
  -H 'Content-Type: application/json' \
  -X POST \
  -d '{
    "contents": [
      {
        "parts": [
          {
            "text": "Explain how AI works in a few words"
          }
        ]
      }
    ]
  }'

للحصول على تعليمات حول كيفية تمرير المفتاح إلى واجهة برمجة التطبيقات باستخدام حِزم تطوير البرامج (SDK) من Gemini، راجِع دليل استخدام مفاتيح Gemini API.