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

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

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

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

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

אימות

כל הבקשות ל-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.