מאמרי עזרה על Gemini API

במסמך הזה מפורטות הפניות ל-API של ממשקי ה-API החד-ערכיים, של הסטרימינג ושל הזמן אמת שבהם אפשר להשתמש כדי ליצור אינטראקציה עם המודלים של Gemini. אפשר להשתמש בממשקי REST API בכל סביבה שתומכת בבקשות HTTP. במדריך לתחילת השימוש מוסבר איך להתחיל עם הקריאה הראשונה ל-API. אם אתם מחפשים את ההפניות לספריות ולערכות ה-SDK הספציפיות לשפה שלנו, אתם יכולים לעבור לקישור של השפה הרלוונטית בחלונית הניווט הימנית בקטע הפניות ל-SDK.

נקודות קצה ראשיות

ממשק Gemini API מאורגן סביב נקודות הקצה העיקריות הבאות:

• אינטראקציות (CreateInteraction) (מומלץ): פרימיטיב סטנדרטי מומלץ לבנייה באמצעות Gemini, שעבר אופטימיזציה לזרימות עבודה של סוכנים, לניהול מצב בצד השרת ולשיחות מורכבות רב-שלביות ומרובות-אופנים.
• יצירת תוכן רגילה (generateContent): נקודת קצה רגילה של REST שמבצעת עיבוד של הבקשה ומחזירה את התשובה המלאה של המודל בחבילה אחת. השיטה הזו מתאימה במיוחד למשימות לא אינטראקטיביות שבהן אפשר לחכות לתוצאה המלאה.
• יצירת תוכן בסטרימינג (streamGenerateContent): משתמשת באירועים שנשלחים מהשרת (SSE) כדי לשלוח לכם נתחים מהתשובה בזמן שהם נוצרים. כך אפשר להשתמש באפליקציות כמו צ'אטבוטים בצורה מהירה ואינטראקטיבית יותר.
• ‫Live API‏ (BidiGenerateContent): ממשק API מבוסס WebSocket עם שמירת מצב לסטרימינג דו-כיווני, שנועד לתרחישי שימוש שיש בהם שיחה בזמן אמת.
• מצב אצווה (batchGenerateContent): נקודת קצה רגילה של REST לשליחת אצוות של בקשות generateContent.
• הטמעות (embedContent): נקודת קצה רגילה של REST שיוצרת וקטור הטמעת טקסט מהקלט Content.
• ‫Gen Media APIs: נקודות קצה ליצירת מדיה באמצעות המודלים הייעודיים שלנו, כמו Imagen ליצירת תמונות ו-Veo ליצירת סרטונים. יכולות דומות מובנות גם ב-Gemini, ואפשר לגשת אליהן באמצעות generateContent API.
• ‫Platform APIs: נקודות קצה של כלי עזר שתומכות ביכולות ליבה כמו העלאת קבצים וספירת טוקנים.

אימות

כל הבקשות ל-Gemini API חייבות לכלול כותרת x-goog-api-key עם מפתח ה-API שלכם. אפשר ליצור אותו בכמה קליקים ב-Google AI Studio.

בדוגמה הבאה מוצגת בקשה עם מפתח ה-API שכלול בכותרת:

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"
          }
        ]
      }
    ]
  }'

הוראות להעברת המפתח ל-API באמצעות ערכות Gemini SDK זמינות במדריך שימוש במפתחות Gemini API.