מדריך להתחלה מהירה של Gemini API
במדריך למתחילים הזה מוסבר איך להתקין את הספריות שלנו ולשלוח את בקשת ה-API הראשונה ל-Gemini API באמצעות Interactions API.
לפני שמתחילים
כדי להשתמש ב-Gemini API, צריך מפתח API לאימות הבקשות, לאכיפת מגבלות אבטחה ולמעקב אחר השימוש בחשבון.
כדי להתחיל, אפשר ליצור אחד ב-AI Studio בחינם:
התקנה של 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 בפעולה: