תחילת העבודה

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

ה-API של האינטראקציות זמין דרך ה-SDK של Python ו-JavaScript, וגם דרך REST.

1. קבלת מפתח API

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

  • מערכת Google AI Studio יוצרת באופן אוטומטי פרויקט ומפתח API למשתמשים חדשים. אפשר להעתיק אותו מדף מפתחות ה-API.
  • אם אתם צריכים מפתח חדש, לוחצים על Create API key (יצירת מפתח API) ב-AI Studio ופועלים לפי ההוראות בתיבת הדו-שיח כדי להוסיף צמד חדש של מפתח ופרויקט.

איך יוצרים מפתח Gemini API

מגדירים את המפתח כמשתנה סביבה:

export GEMINI_API_KEY="YOUR_API_KEY"

שדרוג לרמה בתשלום

שדרוג לתוכנית בתשלום מגדיל את מגבלות הקצב ומחייב הגדרה של חיוב ב-Cloud.

  • לוחצים על הגדרת חיוב בדפים מפתחות API או פרויקטים ב-AI Studio.
  • פועלים לפי ההוראות בתיבת הדו-שיח של החיוב ב-Cloud כדי ליצור או לקשר חשבון לחיוב, להוסיף אמצעי תשלום ולשלם מראש סכום מינימלי של 10$ (או סכום שווה ערך במטבע אחר) בקרדיטים בתשלום.
  • אפשר לראות את השימוש ב-API ב-Google AI Studio בקטע מרכז הבקרה > שימוש.

מידע נוסף זמין בדף החיוב.

2. התקנה של SDK וביצוע השיחה הראשונה

מתקינים את ה-SDK ויוצרים טקסט באמצעות קריאה אחת ל-API.

Python

מתקינים את ה-SDK:

pip install -U google-genai

מאחלים את הלקוח ושולחים בקשה:

from google import genai

client = genai.Client()

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

JavaScript

מתקינים את ה-SDK:

npm install @google/genai

מאחלים את הלקוח ושולחים בקשה:

import { GoogleGenAI } from "@google/genai";

const ai = new GoogleGenAI({});

const interaction =