مرجع Gemini API

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

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

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

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

المصادقة

يجب أن تتضمّن جميع الطلبات إلى 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"
          }
        ]
      }
    ]
  }'

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