مرجع 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.