מדריך להתחלה מהירה של Gemini API

במדריך למתחילים הזה מוסבר איך להתקין את הספריות שלנו ולשלוח את בקשת ה-API הראשונה ל-Gemini API באמצעות Interactions API.

לפני שמתחילים

כדי להשתמש ב-Gemini API, צריך מפתח API לאימות הבקשות, לאכיפת מגבלות אבטחה ולמעקב אחר השימוש בחשבון.

כדי להתחיל, אפשר ליצור אחד ב-AI Studio בחינם:

יצירת מפתח Gemini API

התקנה של Google GenAI SDK

Python

באמצעות Python 3.9 ואילך, מתקינים את החבילה google-genai באמצעות פקודת pip הבאה:

pip install -q -U google-genai

JavaScript

באמצעות Node.js v18+‎, מתקינים את Google Gen AI SDK ל-TypeScript ול-JavaScript באמצעות פקודת npm הבאה:

npm install @google/genai

שליחת הבקשה הראשונה

יש שתי דרכים לשלוח בקשה אל Gemini API:

  • (מומלץ) Interactions API הוא פרימיטיב חדש עם תמיכה מקורית בשימוש בכלי רב-שלבי, בתזמור ובזרימות מורכבות של חשיבה רציונלית באמצעות שלבי ביצוע מוקלדים. בעתיד, מודלים חדשים שאינם חלק ממשפחת המודלים המרכזית, יחד עם יכולות של AI אקטיבי וכלים חדשים, יושקו באופן בלעדי ב-Interactions API.
  • generateContent מאפשר ליצור תשובה פשוטה ובלי שמירת מצב ממודל. מומלץ להשתמש ב-Interactions API, אבל generateContent נתמך באופן מלא.

בדוגמה הזו נעשה שימוש ב-Interactions API כדי לשלוח בקשה אל Gemini API באמצעות מודל Gemini 3 Flash.

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

שימו לב: כל דוגמאות הקוד במסמכי התיעוד של Gemini API מניחות שהגדרתם את משתנה הסביבה GEMINI_API_KEY.

Python

# This will only work for SDK newer than 2.0.0
from google import genai

# The client gets the API key from the environment variable `GEMINI_API_KEY`.
client = genai.Client()

interaction = client.interactions.create(
    model="gemini-3-flash-preview", 
    input="Explain how AI works in a few words"
)

# Print the model's text response
for step in interaction.steps:
    if step.type == "model_output":
        for content_block in step.content:
            if content_block.type == "text":
                print(content_block.text)

JavaScript

// This will only work for SDK newer than 2.0.0
import { GoogleGenAI } from "@google/genai";

// The client gets the API key from the environment variable `GEMINI_API_KEY`.
const ai = new GoogleGenAI({});

async function main() {
  const interaction = await ai.interactions.create({
    model: "gemini-3-flash-preview",
    input: "Explain how AI works in a few words",
  });

  const modelStep = interaction.steps.find(s => s.type === 'model_output');
  if (modelStep) {
    for (const contentBlock of modelStep.content) {
      if (contentBlock.type === 'text') console.log(contentBlock.text);
    }
  }
}

main();

REST

# Specifies the API revision to avoid breaking changes when they become default
curl -X POST "https://generativelanguage.googleapis.com/v1beta/interactions" \
  -H "x-goog-api-key: $GEMINI_API_KEY" \
  -H 'Content-Type: application/json' \
  -H "Api-Revision: 2026-05-20" \
  -d '{
    "model": "gemini-3-flash-preview",
    "input": "Explain how AI works in a few words"
  }'

מצב בלי שמירת מצב

כברירת מחדל, ממשק Interactions API מנהל את מצב השיחה בצד השרת כשמשתמשים ב-previous_interaction_id. אם אתם מעדיפים לנהל את היסטוריית השיחות בעצמכם בצד הלקוח, אתם יכולים להפעיל את המצב חסר המצב על ידי הגדרת store=false והעברת השלבים המצטברים בשדה input של בקשות עוקבות.

פרטים ודוגמאות מלאות של שיחות מרובות תורות בלי שמירת מצב זמינים במדריך ליצירת טקסט.

המאמרים הבאים

אחרי ששלחתם את בקשת ה-API הראשונה, כדאי לעיין במדריכים הבאים שבהם אפשר לראות את Gemini בפעולה: