Gemini API

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

פתיחת הדף כ-Markdown פתיחת המפרט של OpenAPI

יצירת אינטראקציה

post https://generativelanguage.googleapis.com/v1beta/interactions

יצירת אינטראקציה חדשה.

גוף הבקשה

גוף הבקשה מכיל נתונים במבנה הבא:

model ModelOption  (אופציונלי)

השם של ה-`Model` שמשמש ליצירת האינטראקציה.
חובה אם לא צוין agent

ערכים אפשריים:

  • gemini-2.5-flash

    מודל חשיבה רציונלית היברידי הראשון שלנו, שתומך בחלון ההקשר של מיליון טוקנים וכולל תקציבי חשיבה.

  • gemini-2.5-flash-image

    מודל מקורי ליצירת תמונות, שעבר אופטימיזציה למהירות, לגמישות ולהבנה הקשרית. התמחור של קלט ופלט של טקסט זהה לזה של 2.5 Flash.

  • gemini-2.5-flash-lite

    המודל הכי קטן ומשתלם שלנו, שנועד לשימוש בהיקף גדול.

  • gemini-2.5-flash-lite-preview-09-2025

    המודל החדש ביותר שמבוסס על Gemini 2.5 Flash lite ועבר אופטימיזציה ליעילות בעלויות, לתפוקה גבוהה ולאיכות גבוהה.

  • gemini-2.5-flash-native-audio-preview-12-2025

    מודלים מקוריים של אודיו שעברו אופטימיזציה כדי לספק פלט אודיו באיכות גבוהה יותר, עם קצב טוב יותר, קול טבעי יותר, דרגת מלל גבוהה יותר ואווירה טובה יותר.

  • gemini-2.5-flash-preview-09-2025

    המודל הכי חדש שמבוסס על מודל ‎2.5 Flash. ‫2.5 Flash Preview הוא המודל הכי טוב לעיבוד בקנה מידה גדול, למשימות עם נפח גבוה שדורשות העמקה ולתרחישי שימוש אג'נטיים.

  • gemini-2.5-flash-preview-tts

    מודל ה-TTS שלנו, ‎2.5 Flash, מותאם ליצירת דיבור חזק עם זמן אחזור נמוך שאפשר לשלוט בו.

  • gemini-2.5-pro

    המודל המתקדם שלנו לשימוש רב-תכליתי, שמצטיין בכתיבת קוד ובמשימות מורכבות של חשיבה רציונלית.

  • gemini-2.5-pro-preview-tts

    מודל האודיו שלנו להמרת טקסט לדיבור, ‎2.5 Pro, עבר אופטימיזציה ליצירת דיבור עוצמתי עם זמן אחזור נמוך, כדי שהתוצאות יהיו טבעיות יותר ויהיה קל יותר לכוון את ההנחיות.

  • gemini-3-flash-preview

    המודל הכי חכם שלנו, שפועל במהירות, משלב בין יכולות מתקדמות לבין חיפוש והצמדה מעולים.

  • gemini-3-pro-image-preview

    מודל חדשני ומתקדם ליצירת ועריכת תמונות.

  • gemini-3-pro-preview

    המודל הכי חכם שלנו עם יכולות חשיבה רציונלית והבנה מולטי-מודאלית ברמה הכי גבוהה, ויכולות עוצמתיות של סוכנים ותכנות בשיטת Vibe coding.

  • gemini-3.1-pro-preview

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

  • gemini-3.1-flash-image-preview

    יכולות מתקדמות של בינה ויזואלית עם יעילות גבוהה במיוחד ויכולות יצירה שמבוססות על המציאות.

המודל שישלים את ההנחיה.\n\nפרטים נוספים זמינים במאמר בנושא [מודלים](https://ai.google.dev/gemini-api/docs/models).

agent AgentOption  (אופציונלי)

השם של ה-Agent ששימש ליצירת האינטראקציה.
חובה אם לא צוין דגם.

ערכים אפשריים:

  • deep-research-pro-preview-12-2025

    סוכן Gemini Deep Research

הסוכן שאיתו רוצים ליצור אינטראקציה.

input Content or array (Content) or array (Turn) or string  (required)

הקלט לאינטראקציה (משותף למודל ולנציג).

system_instruction string  (optional)

הוראה למערכת לגבי האינטראקציה.

tools מערך (Tool)  (אופציונלי)

רשימה של הצהרות על כלים שהמודל עשוי להשתמש בהם במהלך האינטראקציה.

response_format object  (optional)

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

response_mime_type string  (optional)

סוג ה-MIME של התשובה. השדה הזה נדרש אם מוגדר response_format.

stream boolean  (אופציונלי)

קלט בלבד. אם האינטראקציה תועבר בסטרימינג.

store boolean  (אופציונלי)

קלט בלבד. האם לאחסן את התשובה והבקשה לאחזור מאוחר יותר.

background boolean  (אופציונלי)

קלט בלבד. האם להריץ את האינטראקציה עם המודל ברקע.

generation_config GenerationConfig  (optional)

הגדרת המודל
פרמטרים להגדרת האינטראקציה עם המודל.
חלופה ל-`agent_config`. רלוונטי רק אם המאפיין `model` מוגדר.

פרמטרים של הגדרות אישיות לאינטראקציות עם המודל.

שדות

temperature number  (optional)

המדיניות קובעת את מידת הרנדומיזציה של הפלט.

top_p number  (optional)

ההסתברות המצטברת המקסימלית של אסימונים שצריך לקחת בחשבון כשמבצעים דגימה.

seed integer  (אופציונלי)

ה-Seed שמשמש בפענוח לשחזור.

stop_sequences array (string)  (optional)

רשימה של רצפי תווים שיפסיקו את האינטראקציה עם הפלט.

thinking_level ThinkingLevel  (optional)

רמת הטוקנים של המחשבות שהמודל צריך ליצור.

ערכים אפשריים:

  • minimal
  • low
  • medium
  • high

thinking_summaries ThinkingSummaries  (optional)

האם לכלול בתשובה סיכומי מחשבות.

ערכים אפשריים:

  • auto
  • none

‫max_output_tokens integer  (optional)

מספר האסימונים המקסימלי שייכללו בתשובה.

speech_config SpeechConfig  (optional)

הגדרות לאינטראקציה קולית.

ההגדרה של אינטראקציה קולית.

שדות

voice string  (אופציונלי)

הקול של הדובר.

language string  (אופציונלי)

השפה של הדיבור.

speaker string  (אופציונלי)

שם הדובר, שצריך להיות זהה לשם הדובר שצוין בהנחיה.

image_config ImageConfig  (optional)

הגדרות האינטראקציה עם תמונות.

ההגדרה של האינטראקציה עם התמונה.

שדות

aspect_ratio enum (string)  (optional)

לא סופק תיאור.

ערכים אפשריים:

  • 1:1
  • 2:3
  • 3:2
  • 3:4
  • 4:3
  • 4:5
  • 5:4
  • 9:16
  • 16:9
  • 21:9
  • 1:8
  • 8:1
  • 1:4
  • 4:1
image_size enum (string)  (optional)

לא סופק תיאור.

ערכים אפשריים:

  • 1K
  • 2K
  • 4K
  • 512
tool_choice ToolChoiceConfig או ToolChoiceType  (אופציונלי)

הכלי שנבחר לאינטראקציה.

agent_config object  (optional)

הגדרת הסוכן
הגדרות הסוכן. ‫
Alternative to `generation_config`. Only applicable when `agent` is set.

סוגים אפשריים

ערך הדיסקרימינטור הפולימורפי: type

DynamicAgentConfig

הגדרות של סוכנים דינמיים.

type object  (חובה)

לא סופק תיאור.

הערך תמיד יהיה "dynamic".

DeepResearchAgentConfig

ההגדרה של סוכן Deep Research.

thinking_summaries ThinkingSummaries  (אופציונלי)

האם לכלול בתשובה סיכומי מחשבות.

ערכים אפשריים:

  • auto
  • none

type object  (חובה)

לא סופק תיאור.

הערך תמיד יהיה "deep-research".

previous_interaction_id string  (optional)

המזהה של האינטראקציה הקודמת, אם יש כזו.

response_modalities ResponseModality  (optional)

האופנים המבוקשים של התגובה (TEXT, IMAGE, AUDIO).

ערכים אפשריים:

  • text
  • image
  • audio

תשובה

מחזירה משאב Interaction.

בקשה פשוטה

דוגמה לתשובה

{
  "created": "2025-11-26T12:25:15Z",
  "id": "v1_ChdPU0F4YWFtNkFwS2kxZThQZ05lbXdROBIXT1NBeGFhbTZBcEtpMWU4UGdOZW13UTg",
  "model": "gemini-3-flash-preview",
  "object": "interaction",
  "outputs": [
    {
      "text": "Hello! I'm functioning perfectly and ready to assist you.\n\nHow are you doing today?",
      "type": "text"
    }
  ],
  "role": "model",
  "status": "completed",
  "updated": "2025-11-26T12:25:15Z",
  "usage": {
    "input_tokens_by_modality": [
      {
        "modality": "text",
        "tokens": 7
      }
    ],
    "total_cached_tokens": 0,
    "total_input_tokens": 7,
    "total_output_tokens": 20,
    "total_thought_tokens": 22,
    "total_tokens": 49,
    "total_tool_use_tokens": 0
  }
}

שיחה מרובת תפניות

דוגמה לתשובה

{
  "id": "v1_ChdPU0F4YWFtNkFwS2kxZThQZ05lbXdROBIXT1NBeGFhbTZBcEtpMWU4UGdOZW13UTg",
  "model": "gemini-3-flash-preview",
  "status": "completed",
  "object": "interaction",
  "created": "2025-11-26T12:22:47Z",
  "updated": "2025-11-26T12:22:47Z",
  "role": "model",
  "outputs": [
    {
      "type": "text",
      "text": "The capital of France is Paris."
    }
  ],
  "usage": {
    "input_tokens_by_modality": [
      {
        "modality": "text",
        "tokens": 50
      }
    ],
    "total_cached_tokens": 0,
    "total_input_tokens": 50,
    "total_output_tokens": 10,
    "total_thought_tokens": 0,
    "total_tokens": 60,
    "total_tool_use_tokens": 0
  }
}

קלט תמונה

דוגמה לתשובה

{
  "id": "v1_ChdPU0F4YWFtNkFwS2kxZThQZ05lbXdROBIXT1NBeGFhbTZBcEtpMWU4UGdOZW13UTg",
  "model": "gemini-3-flash-preview",
  "status": "completed",
  "object": "interaction",
  "created": "2025-11-26T12:22:47Z",
  "updated": "2025-11-26T12:22:47Z",
  "role": "model",
  "outputs": [
    {
      "type": "text",
      "text": "A white humanoid robot with glowing blue eyes stands holding a red skateboard."
    }
  ],
  "usage": {
    "input_tokens_by_modality": [
      {
        "modality": "text",
        "tokens": 10
      },
      {
        "modality": "image",
        "tokens": 258
      }
    ],
    "total_cached_tokens": 0,
    "total_input_tokens": 268,
    "total_output_tokens": 20,
    "total_thought_tokens": 0,
    "total_tokens": 288,
    "total_tool_use_tokens": 0
  }
}

בקשה להפעלת פונקציה

דוגמה לתשובה

{
  "id": "v1_ChdPU0F4YWFtNkFwS2kxZThQZ05lbXdROBIXT1NBeGFhbTZBcEtpMWU4UGdOZW13UTg",
  "model": "gemini-3-flash-preview",
  "status": "requires_action",
  "object": "interaction",
  "created": "2025-11-26T12:22:47Z",
  "updated": "2025-11-26T12:22:47Z",
  "role": "model",
  "outputs": [
    {
      "type": "function_call",
      "id": "gth23981",
      "name": "get_weather",
      "arguments": {
        "location": "Boston, MA"
      }
    }
  ],
  "usage": {
    "input_tokens_by_modality": [
      {
        "modality": "text",
        "tokens": 100
      }
    ],
    "total_cached_tokens": 0,
    "total_input_tokens": 100,
    "total_output_tokens": 25,
    "total_thought_tokens": 0,
    "total_tokens": 125,
    "total_tool_use_tokens": 50
  }
}

Deep Research

דוגמה לתשובה

{
  "id": "v1_ChdPU0F4YWFtNkFwS2kxZThQZ05lbXdROBIXT1NBeGFhbTZBcEtpMWU4UGdOZW13UTg",
  "agent": "deep-research-pro-preview-12-2025",
  "status": "completed",
  "object": "interaction",
  "created": "2025-11-26T12:22:47Z",
  "updated": "2025-11-26T12:22:47Z",
  "role": "agent",
  "outputs": [
    {
      "type": "text",
      "text": "Here is a comprehensive research report on the current state of cancer research..."
    }
  ],
  "usage": {
    "input_tokens_by_modality": [
      {
        "modality": "text",
        "tokens": 20
      }
    ],
    "total_cached_tokens": 0,
    "total_input_tokens": 20,
    "total_output_tokens": 1000,
    "total_thought_tokens": 500,
    "total_tokens": 1520,
    "total_tool_use_tokens": 0
  }
}

אחזור אינטראקציה

get https://generativelanguage.googleapis.com/v1beta/interactions/{id}

אחזור הפרטים המלאים של אינטראקציה יחידה על סמך `Interaction.id`.

פרמטרים של נתיב או שאילתה

id string  (חובה)

המזהה הייחודי של האינטראקציה לאחזור.

stream boolean  (אופציונלי)

אם המדיניות מוגדרת כ-True, התוכן שנוצר יועבר בהדרגה.

ברירת המחדל: False

last_event_id string  (optional)

אופציונלי. אם הפרמטר מוגדר, הוא מפעיל מחדש את זרם האינטראקציות מהחלק הבא אחרי האירוע שמסומן על ידי מזהה האירוע. אפשר להשתמש בו רק אם הערך של stream הוא true.

include_input boolean  (optional)

אם הערך הוא true, הקלט נכלל בתשובה.

ברירת המחדל: False

api_version string  (optional)

באיזו גרסה של ה-API להשתמש.

תשובה

מחזירה משאב Interaction.

קבלת אינטראקציה

דוגמה לתשובה

{
  "id": "v1_ChdPU0F4YWFtNkFwS2kxZThQZ05lbXdROBIXT1NBeGFhbTZBcEtpMWU4UGdOZW13UTg",
  "model": "gemini-3-flash-preview",
  "status": "completed",
  "object": "interaction",
  "created": "2025-11-26T12:25:15Z",
  "updated": "2025-11-26T12:25:15Z",
  "role": "model",
  "outputs": [
    {
      "type": "text",
      "text": "I'm doing great, thank you for asking! How can I help you today?"
    }
  ]
}

מחיקת אינטראקציה

delete https://generativelanguage.googleapis.com/v1beta/interactions/{id}

מחיקת האינטראקציה לפי מזהה.

פרמטרים של נתיב או שאילתה

id string  (חובה)

המזהה הייחודי של האינטראקציה שרוצים למחוק.

api_version string  (optional)

באיזו גרסה של ה-API להשתמש.

תשובה

אם הפעולה בוצעה ללא שגיאות, התגובה תהיה ריקה.

מחיקת אינטראקציה

ביטול אינטראקציה

post https://generativelanguage.googleapis.com/v1beta/interactions/{id}/cancel

מבטל אינטראקציה לפי מזהה. ההגדרה הזו רלוונטית רק לאינטראקציות ברקע שעדיין פועלות.

פרמטרים של נתיב או שאילתה

id string  (חובה)

המזהה הייחודי של האינטראקציה שרוצים לבטל.

api_version string  (optional)

באיזו גרסה של ה-API להשתמש.

תשובה

מחזירה משאב Interaction.

ביטול האינטראקציה

דוגמה לתשובה

{
  "id": "v1_ChdPU0F4YWFtNkFwS2kxZThQZ05lbXdROBIXT1NBeGFhbTZBcEtpMWU4UGdOZW13UTg",
  "agent": "deep-research-pro-preview-12-2025",
  "status": "cancelled",
  "object": "interaction",
  "created": "2025-11-26T12:25:15Z",
  "updated": "2025-11-26T12:25:15Z",
  "role": "agent"
}

משאבים

אינטראקציה

משאב האינטראקציה.

שדות

model ModelOption  (אופציונלי)

השם של ה-`Model` שמשמש ליצירת האינטראקציה.

ערכים אפשריים:

  • gemini-2.5-flash

    מודל חשיבה רציונלית היברידי הראשון שלנו, שתומך בחלון ההקשר של מיליון טוקנים וכולל תקציבי חשיבה.

  • gemini-2.5-flash-image

    מודל מקורי ליצירת תמונות, שעבר אופטימיזציה למהירות, לגמישות ולהבנה הקשרית. התמחור של קלט ופלט של טקסט זהה לזה של 2.5 Flash.

  • gemini-2.5-flash-lite

    המודל הכי קטן ומשתלם שלנו, שנועד לשימוש בהיקף גדול.

  • gemini-2.5-flash-lite-preview-09-2025

    המודל החדש ביותר שמבוסס על Gemini 2.5 Flash lite ועבר אופטימיזציה ליעילות בעלויות, לתפוקה גבוהה ולאיכות גבוהה.

  • gemini-2.5-flash-native-audio-preview-12-2025

    מודלים מקוריים של אודיו שעברו אופטימיזציה כדי לספק פלט אודיו באיכות גבוהה יותר, עם קצב טוב יותר, קול טבעי יותר, דרגת מלל גבוהה יותר ואווירה טובה יותר.

  • gemini-2.5-flash-preview-09-2025

    המודל הכי חדש שמבוסס על מודל ‎2.5 Flash. ‫2.5 Flash Preview הוא המודל הכי טוב לעיבוד בקנה מידה גדול, למשימות עם נפח גבוה שדורשות העמקה ולתרחישי שימוש אג'נטיים.

  • gemini-2.5-flash-preview-tts

    מודל ה-TTS שלנו, ‎2.5 Flash, מותאם ליצירת דיבור חזק עם זמן אחזור נמוך שאפשר לשלוט בו.

  • gemini-2.5-pro

    המודל המתקדם שלנו לשימוש רב-תכליתי, שמצטיין בכתיבת קוד ובמשימות מורכבות של חשיבה רציונלית.

  • gemini-2.5-pro-preview-tts

    מודל האודיו שלנו להמרת טקסט לדיבור, ‎2.5 Pro, עבר אופטימיזציה ליצירת דיבור עוצמתי עם זמן אחזור נמוך, כדי שהתוצאות יהיו טבעיות יותר ויהיה קל יותר לכוון את ההנחיות.

  • gemini-3-flash-preview

    המודל הכי חכם שלנו, שפועל במהירות, משלב בין יכולות מתקדמות לבין חיפוש והצמדה מעולים.

  • gemini-3-pro-image-preview

    מודל חדשני ומתקדם ליצירת ועריכת תמונות.

  • gemini-3-pro-preview

    המודל הכי חכם שלנו עם יכולות חשיבה רציונלית והבנה מולטי-מודאלית ברמה הכי גבוהה, ויכולות עוצמתיות של סוכנים ותכנות בשיטת Vibe coding.

  • gemini-3.1-pro-preview

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

  • gemini-3.1-flash-image-preview

    יכולות מתקדמות של בינה ויזואלית עם יעילות גבוהה במיוחד ויכולות יצירה שמבוססות על המציאות.

המודל שישלים את ההנחיה.\n\nפרטים נוספים זמינים במאמר בנושא [מודלים](https://ai.google.dev/gemini-api/docs/models).

agent AgentOption  (אופציונלי)

השם של ה-Agent ששימש ליצירת האינטראקציה.

ערכים אפשריים:

  • deep-research-pro-preview-12-2025

    סוכן Gemini Deep Research

הסוכן שאיתו רוצים ליצור אינטראקציה.

id string  (optional)

פלט בלבד. מזהה ייחודי של השלמת האינטראקציה.

status enum (string)  (optional)

פלט בלבד. הסטטוס של האינטראקציה.

ערכים אפשריים:

  • in_progress
  • requires_action
  • completed
  • failed
  • cancelled
  • incomplete
created string  (אופציונלי)

פלט בלבד. השעה שבה התשובה נוצרה בפורמט ISO 8601‏ (YYYY-MM-DDThh:mm:ssZ).

updated string  (אופציונלי)

פלט בלבד. השעה שבה התשובה עודכנה לאחרונה בפורמט ISO 8601‏ (YYYY-MM-DDThh:mm:ssZ).

‫role string  (אופציונלי)

פלט בלבד. התפקיד של האינטראקציה.

‫outputs array (Content)  (אופציונלי)

פלט בלבד. תשובות מהמודל.

system_instruction string  (optional)

הוראה למערכת לגבי האינטראקציה.

tools מערך (Tool)  (אופציונלי)

רשימה של הצהרות על כלים שהמודל עשוי להשתמש בהם במהלך האינטראקציה.

usage Usage  (אופציונלי)

פלט בלבד. נתונים סטטיסטיים על השימוש בטוקן של בקשת האינטראקציה.

נתונים סטטיסטיים על השימוש בטוקן של בקשת האינטראקציה.

שדות

total_input_tokens integer  (optional)

מספר הטוקנים בהנחיה (בהקשר).

input_tokens_by_modality ModalityTokens  (optional)

פירוט של השימוש בטוקנים של קלט לפי אופן השימוש.

מספר הטוקנים עבור מודאליות תגובה יחידה.

שדות

modality ResponseModality  (אופציונלי)

האופן שבו האסימונים נספרים.

ערכים אפשריים:

  • text
  • image
  • audio

‫tokens integer  (אופציונלי)

מספר הטוקנים של האופן.

total_cached_tokens integer  (optional)

מספר הטוקנים בחלק המאוחסן במטמון של ההנחיה (התוכן המאוחסן במטמון).

cached_tokens_by_modality ModalityTokens  (optional)

פירוט של השימוש בטוקנים במטמון לפי אופן השימוש.

מספר הטוקנים עבור מודאליות תגובה יחידה.

שדות

modality ResponseModality  (אופציונלי)

האופן שבו האסימונים נספרים.

ערכים אפשריים:

  • text
  • image
  • audio

‫tokens integer  (אופציונלי)

מספר הטוקנים של האופן.

total_output_tokens integer  (optional)

המספר הכולל של טוקנים בכל התגובות שנוצרו.

output_tokens_by_modality ModalityTokens  (optional)

פירוט של השימוש באסימוני פלט לפי אופן השימוש.

מספר הטוקנים עבור מודאליות תגובה יחידה.

שדות

modality ResponseModality  (אופציונלי)

האופן שבו האסימונים נספרים.

ערכים אפשריים:

  • text
  • image
  • audio

‫tokens integer  (אופציונלי)

מספר הטוקנים של האופן.

total_tool_use_tokens integer  (optional)

מספר הטוקנים שמופיעים בהנחיות לשימוש בכלים.

tool_use_tokens_by_modality ModalityTokens  (optional)

פירוט של השימוש בטוקנים של כלי לפי אופן השימוש.

מספר הטוקנים עבור מודאליות תגובה יחידה.

שדות

modality ResponseModality  (אופציונלי)

האופן שבו האסימונים נספרים.

ערכים אפשריים:

  • text
  • image
  • audio

‫tokens integer  (אופציונלי)

מספר הטוקנים של האופן.

total_thought_tokens integer  (optional)

מספר הטוקנים של מחשבות למודלים חושבים.

total_tokens integer  (optional)

המספר הכולל של הטוקנים בבקשת האינטראקציה (הנחיה + תגובות + טוקנים פנימיים אחרים).

response_modalities ResponseModality  (optional)

האופנים המבוקשים של התגובה (TEXT, IMAGE, AUDIO).

ערכים אפשריים:

  • text
  • image
  • audio

response_format object  (optional)

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

response_mime_type string  (optional)

סוג ה-MIME של התשובה. השדה הזה נדרש אם מוגדר response_format.

previous_interaction_id string  (optional)

המזהה של האינטראקציה הקודמת, אם יש כזו.

input Content or array (Content) or array (Turn) or string  (required)

הקלט לאינטראקציה (משותף למודל ולנציג).

agent_config object  (optional)

פרמטרים להגדרה של האינטראקציה עם הנציג.

סוגים אפשריים

ערך הדיסקרימינטור הפולימורפי: type

DynamicAgentConfig

הגדרות של סוכנים דינמיים.

type object  (חובה)

לא סופק תיאור.

הערך תמיד יהיה "dynamic".

DeepResearchAgentConfig

ההגדרה של סוכן Deep Research.

thinking_summaries ThinkingSummaries  (אופציונלי)

האם לכלול בתשובה סיכומי מחשבות.

ערכים אפשריים:

  • auto
  • none

type object  (חובה)

לא סופק תיאור.

הערך תמיד יהיה "deep-research".

דוגמאות

דוגמה

{
  "created": "2025-12-04T15:01:45Z",
  "id": "v1_ChdXS0l4YWZXTk9xbk0xZThQczhEcmlROBIXV0tJeGFmV05PcW5NMWU4UHM4RHJpUTg",
  "model": "gemini-3-flash-preview",
  "object": "interaction",
  "outputs": [
    {
      "text": "Hello! I'm doing well, functioning as expected. Thank you for asking! How are you doing today?",
      "type": "text"
    }
  ],
  "role": "model",
  "status": "completed",
  "updated": "2025-12-04T15:01:45Z",
  "usage": {
    "input_tokens_by_modality": [
      {
        "modality": "text",
        "tokens": 7
      }
    ],
    "total_cached_tokens": 0,
    "total_input_tokens": 7,
    "total_output_tokens": 23,
    "total_thought_tokens": 49,
    "total_tokens": 79,
    "total_tool_use_tokens": 0
  }
}

מודלים של נתונים

תוכן

תוכן התשובה.

סוגים אפשריים

ערך הדיסקרימינטור הפולימורפי: type

TextContent

בלוק של תוכן טקסט.

text string  (חובה)

תוכן הטקסט.

annotations Annotation  (אופציונלי)

מידע על ציטוט של תוכן שנוצר על ידי מודל.

מידע על ציטוט של תוכן שנוצר על ידי מודל.

סוגים אפשריים

ערך הדיסקרימינטור הפולימורפי: type

UrlCitation

הערה של ציטוט כתובת URL.

‫url string  (optional)

כתובת ה-URL.

title string  (אופציונלי)

הכותרת של כתובת ה-URL.

type string  (חובה)

לא סופק תיאור.

הערך תמיד יהיה "url_citation".

start_index integer  (optional)

תחילת הקטע בתשובה שמשויך למקור הזה.

end_index integer  (optional)

סוף הקטע המשויך, לא כולל.

FileCitation

הערה לציטוט קובץ.

document_uri string  (אופציונלי)

ה-URI של הקובץ.

file_name string  (optional)

שם הקובץ.

source string  (אופציונלי)

המקור שמשויך לחלק מהטקסט.

type string  (חובה)

לא סופק תיאור.

הערך תמיד יהיה "file_citation".

start_index integer  (optional)

תחילת הקטע בתשובה שמשויך למקור הזה.

end_index integer  (optional)

סוף הקטע המשויך, לא כולל.

PlaceCitation

הערה של ציטוט מקום.

place_id string  (optional)

המזהה של המקום, בפורמט ‎ `places/{place_id}` ‎.

name string  (אופציונלי)

שם המקום.

‫url string  (optional)

הפניה ל-URI של המקום.

review_snippets ReviewSnippet  (אופציונלי)

קטעי ביקורות שמשמשים ליצירת תשובות לגבי התכונות של מקום מסוים במפות Google.

התשובה כוללת קטע מביקורת של משתמש שעונה על שאלה לגבי התכונות של מקום ספציפי במפות Google.

שדות

title string  (אופציונלי)

כותרת הביקורת.

‫url string  (optional)

קישור שמתאים לביקורת של המשתמש במפות Google.

review_id string  (optional)

המזהה של קטע הביקורת.

type string  (חובה)

לא סופק תיאור.

הערך תמיד יהיה "place_citation".

start_index integer  (optional)

תחילת הקטע בתשובה שמשויך למקור הזה.

end_index integer  (optional)

סוף הקטע המשויך, לא כולל.

type object  (חובה)

לא סופק תיאור.

הערך תמיד יהיה "text".

ImageContent

בלוק תוכן של תמונה.

data string  (אופציונלי)

תוכן התמונה.

uri מחרוזת  (אופציונלי)

ה-URI של התמונה.

mime_type enum (string)  (optional)

סוג ה-MIME של התמונה.

ערכים אפשריים:

  • image/png
  • image/jpeg
  • image/webp
  • image/heic
  • image/heif
resolution MediaResolution  (אופציונלי)

הרזולוציה של המדיה.

ערכים אפשריים:

  • low
  • medium
  • high
  • ultra_high

type object  (חובה)

לא סופק תיאור.

הערך תמיד יהיה "image".

AudioContent

בלוק של תוכן אודיו.

data string  (אופציונלי)

תוכן האודיו.

uri מחרוזת  (אופציונלי)

ה-URI של האודיו.

mime_type enum (string)  (optional)

סוג ה-MIME של האודיו.

ערכים אפשריים:

  • audio/wav
  • audio/mp3
  • audio/aiff
  • audio/aac
  • audio/ogg
  • audio/flac
type object  (חובה)

לא סופק תיאור.

הערך תמיד יהיה "audio".

DocumentContent

אבן בניין של תוכן במסמך.

data string  (אופציונלי)

תוכן המסמך.

uri מחרוזת  (אופציונלי)

ה-URI של המסמך.

mime_type enum (string)  (optional)

סוג ה-MIME של המסמך.

ערכים אפשריים:

  • application/pdf
type object  (חובה)

לא סופק תיאור.

הערך תמיד יהיה "document".

VideoContent

בלוק של תוכן וידאו.

data string  (אופציונלי)

תוכן הסרטון.

uri מחרוזת  (אופציונלי)

ה-URI של הסרטון.

mime_type enum (string)  (optional)

סוג ה-MIME של הסרטון.

ערכים אפשריים:

  • video/mp4
  • video/mpeg
  • video/mpg
  • video/mov
  • video/avi
  • video/x-flv
  • video/webm
  • video/wmv
  • video/3gpp
resolution MediaResolution  (אופציונלי)

הרזולוציה של המדיה.

ערכים אפשריים:

  • low
  • medium
  • high
  • ultra_high

type object  (חובה)

לא סופק תיאור.

הערך תמיד יהיה "video".

ThoughtContent

בלוק של מחשבה.

signature string  (אופציונלי)

חתימה שתתאים למקור ה-Backend שיהיה חלק מהיצירה.

summary ThoughtSummaryContent  (אופציונלי)

סיכום של המחשבה.

סוגים אפשריים

ערך הדיסקרימינטור הפולימורפי: type

TextContent

בלוק של תוכן טקסט.

text string  (חובה)

תוכן הטקסט.

annotations Annotation  (אופציונלי)

מידע על ציטוט של תוכן שנוצר על ידי מודל.

מידע על ציטוט של תוכן שנוצר על ידי מודל.

סוגים אפשריים

ערך הדיסקרימינטור הפולימורפי: type

UrlCitation

הערה של ציטוט כתובת URL.

‫url string  (optional)

כתובת ה-URL.

title string  (אופציונלי)

הכותרת של כתובת ה-URL.

type string  (חובה)

לא סופק תיאור.

הערך תמיד יהיה "url_citation".

start_index integer  (optional)

תחילת הקטע בתשובה שמשויך למקור הזה.

end_index integer  (optional)

סוף הקטע המשויך, לא כולל.

FileCitation

הערה לציטוט קובץ.

document_uri string  (אופציונלי)

ה-URI של הקובץ.

file_name string  (optional)

שם הקובץ.

source string  (אופציונלי)

המקור שמשויך לחלק מהטקסט.

type string  (חובה)

לא סופק תיאור.

הערך תמיד יהיה "file_citation".

start_index integer  (optional)

תחילת הקטע בתשובה שמשויך למקור הזה.

end_index integer  (optional)

סוף הקטע המשויך, לא כולל.

PlaceCitation

הערה של ציטוט מקום.

place_id string  (optional)

המזהה של המקום, בפורמט ‎ `places/{place_id}` ‎.

name string  (אופציונלי)

שם המקום.

‫url string  (optional)

הפניה ל-URI של המקום.

review_snippets ReviewSnippet  (אופציונלי)

קטעי ביקורות שמשמשים ליצירת תשובות לגבי התכונות של מקום מסוים במפות Google.

התשובה כוללת קטע מביקורת של משתמש שעונה על שאלה לגבי התכונות של מקום ספציפי במפות Google.

שדות

title string  (אופציונלי)

כותרת הביקורת.

‫url string  (optional)

קישור שמתאים לביקורת של המשתמש במפות Google.

review_id string  (optional)

המזהה של קטע הביקורת.

type string  (חובה)

לא סופק תיאור.

הערך תמיד יהיה "place_citation".

start_index integer  (optional)

תחילת הקטע בתשובה שמשויך למקור הזה.

end_index integer  (optional)

סוף הקטע המשויך, לא כולל.

type object  (חובה)

לא סופק תיאור.

הערך תמיד יהיה "text".

ImageContent

בלוק תוכן של תמונה.

data string  (אופציונלי)

תוכן התמונה.

uri מחרוזת  (אופציונלי)

ה-URI של התמונה.

mime_type enum (string)  (optional)

סוג ה-MIME של התמונה.

ערכים אפשריים:

  • image/png
  • image/jpeg
  • image/webp
  • image/heic
  • image/heif
resolution MediaResolution  (אופציונלי)

הרזולוציה של המדיה.

ערכים אפשריים:

  • low
  • medium
  • high
  • ultra_high

type object  (חובה)

לא סופק תיאור.

הערך תמיד יהיה "image".

type object  (חובה)

לא סופק תיאור.

הערך תמיד יהיה "thought".

FunctionCallContent

בלוק תוכן של קריאה לכלי פונקציה.

name string  (required)

השם של הכלי שאליו מתקשרים.

ארגומנטים object  (חובה)

הארגומנטים להעברה לפונקציה.

type object  (חובה)

לא סופק תיאור.

הערך תמיד יהיה "function_call".

id string  (חובה)

מזהה ייחודי של קריאה ספציפית לכלי.

signature string  (אופציונלי)

גיבוב חתימה לאימות בקצה העורפי.

FunctionResultContent

בלוק תוכן של תוצאה של כלי פונקציה.

name string  (אופציונלי)

שם הכלי שהופעל.

is_error boolean  (optional)

האם קריאת הכלי הסתיימה בשגיאה.

result array (FunctionResultSubcontent) or string  (required)

התוצאה של קריאת הכלי.

type object  (חובה)

לא סופק תיאור.

הערך תמיד יהיה "function_result".

call_id string  (required)

מזהה שצריך להיות זהה למזהה מבלוק בקשה להפעלת פונקציה.

signature string  (אופציונלי)

גיבוב חתימה לאימות בקצה העורפי.

CodeExecutionCallContent

תוכן שכולל ביצוע קוד.

arguments CodeExecutionCallArguments  (חובה)

הארגומנטים להעברה להרצת הקוד.

הארגומנטים להעברה להרצת הקוד.

שדות

language enum (string)  (optional)

שפת התכנות של הקוד.

ערכים אפשריים:

  • python
code string  (אופציונלי)

הקוד שיופעל.

type object  (חובה)

לא סופק תיאור.

הערך תמיד יהיה "code_execution_call".

id string  (חובה)

מזהה ייחודי של קריאה ספציפית לכלי.

signature string  (אופציונלי)

גיבוב חתימה לאימות בקצה העורפי.

CodeExecutionResultContent

תוכן של תוצאת הרצת הקוד.

result string  (required)

הפלט של הרצת הקוד.

is_error boolean  (optional)

האם הרצת הקוד הסתיימה בשגיאה.

type object  (חובה)

לא סופק תיאור.

הערך תמיד יהיה "code_execution_result".

call_id string  (required)

מזהה שצריך להיות זהה למזהה מבלוק הקוד של הקריאה להרצת הקוד.

signature string  (אופציונלי)

גיבוב חתימה לאימות בקצה העורפי.

UrlContextCallContent

תוכן ההקשר של כתובת ה-URL.

arguments UrlContextCallArguments  (required)

הארגומנטים להעברה להקשר של כתובת ה-URL.

הארגומנטים להעברה להקשר של כתובת ה-URL.

שדות

‫urls array (string)  (optional)

כתובות ה-URL לאחזור.

type object  (חובה)

לא סופק תיאור.

הערך תמיד יהיה "url_context_call".

id string  (חובה)

מזהה ייחודי של קריאה ספציפית לכלי.

signature string  (אופציונלי)

גיבוב חתימה לאימות בקצה העורפי.

UrlContextResultContent

תוכן התוצאה של ההקשר של כתובת ה-URL.

result UrlContextResult  (required)

התוצאות של ההקשר של כתובת ה-URL.

התוצאה של ההקשר של כתובת ה-URL.

שדות

‫url string  (optional)

כתובת ה-URL שאוחזרה.

status enum (string)  (optional)

הסטטוס של אחזור כתובת ה-URL.

ערכים אפשריים:

  • success
  • error
  • paywall
  • unsafe
is_error boolean  (optional)

האם ההקשר של כתובת ה-URL הוביל לשגיאה.

type object  (חובה)

לא סופק תיאור.

הערך תמיד יהיה "url_context_result".

call_id string  (required)

מזהה שצריך להיות זהה למזהה מבלוק הקריאה של הקשר של כתובת ה-URL.

signature string  (אופציונלי)

גיבוב חתימה לאימות בקצה העורפי.

GoogleSearchCallContent

תוכן בחיפוש Google.

arguments GoogleSearchCallArguments  (required)

הארגומנטים להעברה לחיפוש Google.

הארגומנטים להעברה לחיפוש Google.

שדות

‫queries array (string)  (optional)

שאילתות לחיפוש באינטרנט לחיפוש המשך באינטרנט.

search_type enum (string)  (optional)

סוג ההארקה של החיפוש שמופעל.

ערכים אפשריים:

  • web_search
  • image_search
type object  (חובה)

לא סופק תיאור.

הערך תמיד יהיה "google_search_call".

id string  (חובה)

מזהה ייחודי של קריאה ספציפית לכלי.

signature string  (אופציונלי)

גיבוב חתימה לאימות בקצה העורפי.

GoogleSearchResultContent

תוכן של תוצאות חיפוש ב-Google.

result GoogleSearchResult  (required)

תוצאות מחיפוש Google.

התוצאה של חיפוש Google.

שדות

search_suggestions string  (optional)

קטע קוד של תוכן אינטרנט שאפשר להטמיע בדף אינטרנט או בתצוגת אינטרנט של אפליקציה.

is_error boolean  (optional)

האם החיפוש ב-Google הסתיים בשגיאה.

type object  (חובה)

לא סופק תיאור.

הערך תמיד יהיה "google_search_result".

call_id string  (required)

המזהה צריך להיות זהה למזהה מחסימת השיחות בחיפוש Google.

signature string  (אופציונלי)

גיבוב חתימה לאימות בקצה העורפי.

McpServerToolCallContent

תוכן הקריאה לכלי MCPServer.

name string  (required)

השם של הכלי שהופעל.

server_name string  (required)

השם של שרת ה-MCP שנעשה בו שימוש.

ארגומנטים object  (חובה)

אובייקט JSON של הארגומנטים של הפונקציה.

type object  (חובה)

לא סופק תיאור.

הערך תמיד יהיה "mcp_server_tool_call".

id string  (חובה)

מזהה ייחודי של קריאה ספציפית לכלי.

signature string  (אופציונלי)

גיבוב חתימה לאימות בקצה העורפי.

McpServerToolResultContent

תוכן התוצאה של כלי MCPServer.

name string  (אופציונלי)

השם של הכלי שמופעל עבור קריאה ספציפית לכלי.

server_name string  (optional)

השם של שרת ה-MCP שנעשה בו שימוש.

result array (FunctionResultSubcontent) or string  (required)

הפלט מהקריאה לשרת MCP. יכול להיות טקסט פשוט או תוכן עשיר.

type object  (חובה)

לא סופק תיאור.

הערך תמיד יהיה "mcp_server_tool_result".

call_id string  (required)

מזהה שצריך להיות זהה למזהה מבלוק הקריאה לכלי של שרת ה-MCP.

signature string  (אופציונלי)

גיבוב חתימה לאימות בקצה העורפי.

FileSearchCallContent

תוכן חיפוש קבצים.

type object  (חובה)

לא סופק תיאור.

הערך תמיד יהיה "file_search_call".

id string  (חובה)

מזהה ייחודי של קריאה ספציפית לכלי.

signature string  (אופציונלי)

גיבוב חתימה לאימות בקצה העורפי.

FileSearchResultContent

תוכן של תוצאת חיפוש קבצים.

result FileSearchResult  (אופציונלי)

התוצאות של חיפוש הקבצים.

התוצאה של חיפוש הקובץ.

type object  (חובה)

לא סופק תיאור.

הערך תמיד יהיה "file_search_result".

call_id string  (required)

המזהה צריך להיות זהה למזהה מבלוק החיפוש של הקובץ.

signature string  (אופציונלי)

גיבוב חתימה לאימות בקצה העורפי.

GoogleMapsCallContent

התוכן במפות Google.

arguments GoogleMapsCallArguments  (optional)

הארגומנטים שמעבירים לכלי של מפות Google.

הארגומנטים שמעבירים לכלי של מפות Google.

שדות

‫queries array (string)  (optional)

השאילתות שיופעלו.

type object  (חובה)

לא סופק תיאור.

הערך תמיד יהיה "google_maps_call".

id string  (חובה)

מזהה ייחודי של קריאה ספציפית לכלי.

signature string  (אופציונלי)

גיבוב חתימה לאימות בקצה העורפי.

GoogleMapsResultContent

תוכן של תוצאות במפות Google.

result GoogleMapsResult  (חובה)

התוצאות של מפות Google.

התוצאה של מפות Google.

שדות

מקומות מקומות  (אופציונלי)

המקומות שנמצאו.

שדות

place_id string  (optional)

המזהה של המקום, בפורמט ‎ `places/{place_id}` ‎.

name string  (אופציונלי)

שם המקום.

‫url string  (optional)

הפניה ל-URI של המקום.

review_snippets ReviewSnippet  (אופציונלי)

קטעי ביקורות שמשמשים ליצירת תשובות לגבי התכונות של מקום מסוים במפות Google.

התשובה כוללת קטע מביקורת של משתמש שעונה על שאלה לגבי התכונות של מקום ספציפי במפות Google.

שדות

title string  (אופציונלי)

כותרת הביקורת.

‫url string  (optional)

קישור שמתאים לביקורת של המשתמש במפות Google.

review_id string  (optional)

המזהה של קטע הביקורת.

widget_context_token string  (optional)

שם המשאב של אסימון ההקשר של הווידג'ט של מפות Google.

type object  (חובה)

לא סופק תיאור.

הערך תמיד יהיה "google_maps_result".

call_id string  (required)

המזהה צריך להיות זהה למזהה מחסימת השיחות במפות Google.

signature string  (אופציונלי)

גיבוב חתימה לאימות בקצה העורפי.

דוגמאות

טקסט

{
  "type": "text",
  "text": "Hello, how are you?"
}

תמונה

{
  "type": "image",
  "data": "BASE64_ENCODED_IMAGE",
  "mime_type": "image/png"
}

אודיו

{
  "type": "audio",
  "data": "BASE64_ENCODED_AUDIO",
  "mime_type": "audio/wav"
}

מסמך

{
  "type": "document",
  "data": "BASE64_ENCODED_DOCUMENT",
  "mime_type": "application/pdf"
}

וידאו

{
  "type": "video",
  "uri": "https://www.youtube.com/watch?v=9hE5-98ZeCg"
}

חשיבה

{
  "type": "thought",
  "summary": [
    {
      "type": "text",
      "text": "The user is asking about the weather. I should use the get_weather tool."
    }
  ],
  "signature": "CoMDAXLI2nynRYojJIy6B1Jh9os2crpWLfB0+19xcLsGG46bd8wjkF/6RNlRUdvHrXyjsHkG0BZFcuO/bPOyA6Xh5jANNgx82wPHjGExN8A4ZQn56FlMwyZoqFVQz0QyY1lfibFJ2zU3J87uw26OewzcuVX0KEcs+GIsZa3EA6WwqhbsOd3wtZB3Ua2Qf98VAWZTS5y/tWpql7jnU3/CU7pouxQr/Bwft3hwnJNesQ9/dDJTuaQ8Zprh9VRWf1aFFjpIueOjBRrlT3oW6/y/eRl/Gt9BQXCYTqg/38vHFUU4Wo/d9dUpvfCe/a3o97t2Jgxp34oFKcsVb4S5WJrykIkw+14DzVnTpCpbQNFckqvFLuqnJCkL0EQFtunBXI03FJpPu3T1XU6id8S7ojoJQZSauGUCgmaLqUGdMrd08oo81ecoJSLs51Re9N/lISGmjWFPGpqJLoGq6uo4FHz58hmeyXCgHG742BHz2P3MiH1CXHUT2J8mF6zLhf3SR9Qb3lkrobAh"
}

בקשה להפעלת פונקציה

{
  "type": "function_call",
  "name": "get_weather",
  "id": "gth23981",
  "arguments": {
    "location": "Boston, MA"
  }
}

תוצאת הפונקציה

{
  "type": "function_result",
  "name": "get_weather",
  "call_id": "gth23981",
  "result": [
    {
      "type": "text",
      "text": "{\"weather\":\"sunny\"}"
    }
  ]
}

קריאה לביצוע קוד

{
  "type": "code_execution_call",
  "id": "call_123456",
  "arguments": {
    "language": "python",
    "code": "print('hello world')"
  }
}

תוצאה של ביצוע קוד

{
  "type": "code_execution_result",
  "call_id": "call_123456",
  "result": "hello world"
}

קריאה להקשר של כתובת URL

{
  "type": "url_context_call",
  "id": "call_123456",
  "arguments": {
    "urls": [
      "https://www.example.com"
    ]
  }
}

תוצאה של הקשר כתובת ה-URL

{
  "type": "url_context_result",
  "call_id": "call_123456",
  "result": [
    {
      "url": "https://www.example.com",
      "status": "SUCCESS"
    }
  ]
}

שיחה בחיפוש Google

{
  "type": "google_search_call",
  "id": "call_123456",
  "arguments": {
    "queries": [
      "weather in Boston"
    ]
  }
}

תוצאת חיפוש ב-Google

{
  "type": "google_search_result",
  "call_id": "call_123456",
  "result": [
    {
      "url": "https://www.google.com/search?q=weather+in+Boston",
      "title": "Weather in Boston"
    }
  ]
}

Mcp Server Tool Call

{
  "type": "mcp_server_tool_call",
  "id": "call_123456",
  "name": "get_forecast",
  "server_name": "weather_server",
  "arguments": {
    "city": "London"
  }
}

תוצאה של כלי שרת MCP

{
  "type": "mcp_server_tool_result",
  "name": "get_forecast",
  "server_name": "weather_server",
  "call_id": "call_123456",
  "result": "sunny"
}

שיחה לחיפוש קבצים

{
  "type": "file_search_call",
  "id": "call_123456"
}

תוצאת חיפוש קבצים

{
  "type": "file_search_result",
  "call_id": "call_123456",
  "result": [
    {
      "text": "search result chunk",
      "file_search_store": "file_search_store"
    }
  ]
}

שיחות במפות Google

{
  "type": "google_maps_call",
  "id": "call_123456",
  "arguments": {
    "query": "best food near me"
  }
}

תוצאה במפות Google

{
  "type": "google_maps_result",
  "call_id": "call_123456",
  "result": [
    {
      "places": [
        {
          "url": "https://www.google.com/maps/search/best+food+near+me",
          "name": "Tasty Restaurant"
        }
      ]
    }
  ]
}

כלי

סוגים אפשריים

ערך הדיסקרימינטור הפולימורפי: type

תפקיד

כלי שהמודל יכול להשתמש בו.

name string  (אופציונלי)

שם הפונקציה.

description string  (אופציונלי)

תיאור של הפונקציה.

parameters object  (אופציונלי)

סכימת ה-JSON של הפרמטרים של הפונקציה.

type string  (חובה)

לא סופק תיאור.

הערך תמיד יהיה "function".

GoogleSearch

כלי שהמודל יכול להשתמש בו כדי לחפש ב-Google.

search_types array (enum (string))  (optional)

סוגי ההארקה של החיפוש שרוצים להפעיל.

ערכים אפשריים:

  • web_search
  • image_search
type string  (חובה)

לא סופק תיאור.

הערך תמיד יהיה "google_search".

CodeExecution

כלי שהמודל יכול להשתמש בו כדי להריץ קוד.

type string  (חובה)

לא סופק תיאור.

הערך תמיד יהיה "code_execution".

UrlContext

כלי שהמודל יכול להשתמש בו כדי לאחזר את ההקשר של כתובת URL.

type string  (חובה)

לא סופק תיאור.

הערך תמיד יהיה "url_context".

ComputerUse

כלי שהמודל יכול להשתמש בו כדי ליצור אינטראקציה עם המחשב.

environment enum (string)  (optional)

הסביבה שבה מתבצעת הפעולה.

ערכים אפשריים:

  • browser
‫excludedPredefinedFunctions array (string)  (optional)

רשימת הפונקציות המוגדרות מראש שמוחרגות מהקריאה למודל.

type string  (חובה)

לא סופק תיאור.

הערך תמיד יהיה "computer_use".

McpServer

שרת MCPServer הוא שרת שהמודל יכול להפעיל כדי לבצע פעולות.

name string  (אופציונלי)

השם של MCPServer.

‫url string  (optional)

כתובת ה-URL המלאה של נקודת הקצה של שרת ה-MCP. דוגמה: "https://api.example.com/mcp"

headers object  (אופציונלי)

אופציונלי: שדות לכותרות אימות, פסק זמן וכו', אם צריך.

allowed_tools AllowedTools  (אופציונלי)

הכלים המותרים.

ההגדרה של הכלים המותרים.

שדות

mode ToolChoiceType  (optional)

המצב של בחירת הכלי.

ערכים אפשריים:

  • auto
  • any
  • none
  • validated

tools מערך (מחרוזת)  (אופציונלי)

השמות של הכלים המותרים.

type string  (חובה)

לא סופק תיאור.

הערך תמיד יהיה "mcp_server".

FileSearch

כלי שהמודל יכול להשתמש בו כדי לחפש קבצים.

file_search_store_names array (string)  (optional)

הקובץ מכיל את שמות החנויות שרוצים לחפש.

top_k integer  (optional)

מספר הצ'אנקים לאחזור סמנטי.

‫metadata_filter string  (אופציונלי)

מסנן מטא-נתונים להחלה על המסמכים ועל חלקי הטקסט שחולצו באמצעות אחזור סמנטי.

type string  (חובה)

לא סופק תיאור.

הערך תמיד יהיה "file_search".

GoogleMaps

כלי שהמודל יכול להשתמש בו כדי להתקשר למפות Google.

enable_widget boolean  (optional)

האם להחזיר אסימון הקשר של הווידג'ט בתוצאה של קריאת הכלי בתגובה.

‫latitude number  (optional)

קו הרוחב של המיקום של המשתמש.

longitude number  (optional)

קו האורך של המיקום של המשתמש.

type string  (אופציונלי)

לא סופק תיאור.

הערך תמיד יהיה "google_maps".

דוגמאות

פונקציה

GoogleSearch

CodeExecution

UrlContext

ComputerUse

McpServer

FileSearch

GoogleMaps

Turn

שדות

‫role string  (אופציונלי)

הגורם שיזם את התור הזה. חייב להיות משתמש לקלט או מודל לפלט של המודל.

content array (Content) or string  (optional)

התוכן של התור.

דוגמאות

תור המשתמש

{
  "role": "user",
  "content": [
    {
      "type": "text",
      "text": "user turn"
    }
  ]
}

התור של המודל

{
  "role": "model",
  "content": [
    {
      "type": "text",
      "text": "model turn"
    }
  ]
}

InteractionSseEvent

סוגים אפשריים

ערך הדיסקרימינטור הפולימורפי: event_type

InteractionStartEvent

interaction Interaction  (חובה)

לא סופק תיאור.

event_type enum (string)  (required)

לא סופק תיאור.

ערכים אפשריים:

  • interaction.start
event_id string  (optional)

הטוקן event_id שישמש להמשך זרם האינטראקציות, מהאירוע הזה.

InteractionCompleteEvent

interaction Interaction  (חובה)

האינטראקציה הושלמה עם פלט ריק כדי להקטין את נפח המטען הייעודי (payload). כדי לקבל את הפלט בפועל, צריך להשתמש באירועי ContentDelta הקודמים.

event_type enum (string)  (required)

לא סופק תיאור.

ערכים אפשריים:

  • interaction.complete
event_id string  (optional)

הטוקן event_id שישמש להמשך זרם האינטראקציות, מהאירוע הזה.

InteractionStatusUpdate

interaction_id string  (required)

לא סופק תיאור.

status enum (string)  (required)

לא סופק תיאור.

ערכים אפשריים:

  • in_progress
  • requires_action
  • completed
  • failed
  • cancelled
  • incomplete
event_type string  (required)

לא סופק תיאור.

הערך תמיד יהיה "interaction.status_update".

event_id string  (optional)

הטוקן event_id שישמש להמשך זרם האינטראקציות, מהאירוע הזה.

ContentStart

index integer  (required)

לא סופק תיאור.

content Content  (required)

לא סופק תיאור.

event_type string  (required)

לא סופק תיאור.

הערך תמיד יהיה "content.start".

event_id string  (optional)

הטוקן event_id שישמש להמשך זרם האינטראקציות, מהאירוע הזה.

ContentDelta

index integer  (required)

לא סופק תיאור.

delta object  (חובה)

לא סופק תיאור.

סוגים אפשריים

ערך הדיסקרימינטור הפולימורפי: type

TextDelta

text string  (חובה)

לא סופק תיאור.

annotations Annotation  (אופציונלי)

מידע על ציטוט של תוכן שנוצר על ידי מודל.

מידע על ציטוט של תוכן שנוצר על ידי מודל.

סוגים אפשריים

ערך הדיסקרימינטור הפולימורפי: type

UrlCitation

הערה של ציטוט כתובת URL.

‫url string  (optional)

כתובת ה-URL.

title string  (אופציונלי)

הכותרת של כתובת ה-URL.

type string  (חובה)

לא סופק תיאור.

הערך תמיד יהיה "url_citation".

start_index integer  (optional)

תחילת הקטע בתשובה שמשויך למקור הזה.

end_index integer  (optional)

סוף הקטע המשויך, לא כולל.

FileCitation

הערה לציטוט קובץ.

document_uri string  (אופציונלי)

ה-URI של הקובץ.

file_name string  (optional)

שם הקובץ.

source string  (אופציונלי)

המקור שמשויך לחלק מהטקסט.

type string  (חובה)

לא סופק תיאור.

הערך תמיד יהיה "file_citation".

start_index integer  (optional)

תחילת הקטע בתשובה שמשויך למקור הזה.

end_index integer  (optional)

סוף הקטע המשויך, לא כולל.

PlaceCitation

הערה של ציטוט מקום.

place_id string  (optional)

המזהה של המקום, בפורמט ‎ `places/{place_id}` ‎.

name string  (אופציונלי)

שם המקום.

‫url string  (optional)

הפניה ל-URI של המקום.

review_snippets ReviewSnippet  (אופציונלי)

קטעי ביקורות שמשמשים ליצירת תשובות לגבי התכונות של מקום מסוים במפות Google.

התשובה כוללת קטע מביקורת של משתמש שעונה על שאלה לגבי התכונות של מקום ספציפי במפות Google.

שדות

title string  (אופציונלי)

כותרת הביקורת.

‫url string  (optional)

קישור שמתאים לביקורת של המשתמש במפות Google.

review_id string  (optional)

המזהה של קטע הביקורת.

type string  (חובה)

לא סופק תיאור.

הערך תמיד יהיה "place_citation".

start_index integer  (optional)

תחילת הקטע בתשובה שמשויך למקור הזה.

end_index integer  (optional)

סוף הקטע המשויך, לא כולל.

type object  (חובה)

לא סופק תיאור.

הערך תמיד יהיה "text".

ImageDelta

data string  (אופציונלי)

לא סופק תיאור.

uri מחרוזת  (אופציונלי)

לא סופק תיאור.

mime_type enum (string)  (optional)

לא סופק תיאור.

ערכים אפשריים:

  • image/png
  • image/jpeg
  • image/webp
  • image/heic
  • image/heif
resolution MediaResolution  (אופציונלי)

הרזולוציה של המדיה.

ערכים אפשריים:

  • low
  • medium
  • high
  • ultra_high

type object  (חובה)

לא סופק תיאור.

הערך תמיד יהיה "image".

AudioDelta

data string  (אופציונלי)

לא סופק תיאור.

uri מחרוזת  (אופציונלי)

לא סופק תיאור.

mime_type enum (string)  (optional)

לא סופק תיאור.

ערכים אפשריים:

  • audio/wav
  • audio/mp3
  • audio/aiff
  • audio/aac
  • audio/ogg
  • audio/flac
type object  (חובה)

לא סופק תיאור.

הערך תמיד יהיה "audio".

DocumentDelta

data string  (אופציונלי)

לא סופק תיאור.

uri מחרוזת  (אופציונלי)

לא סופק תיאור.

mime_type enum (string)  (optional)

לא סופק תיאור.

ערכים אפשריים:

  • application/pdf
type object  (חובה)

לא סופק תיאור.

הערך תמיד יהיה "document".

VideoDelta

data string  (אופציונלי)

לא סופק תיאור.

uri מחרוזת  (אופציונלי)

לא סופק תיאור.

mime_type enum (string)  (optional)

לא סופק תיאור.

ערכים אפשריים:

  • video/mp4
  • video/mpeg
  • video/mpg
  • video/mov
  • video/avi
  • video/x-flv
  • video/webm
  • video/wmv
  • video/3gpp
resolution MediaResolution  (אופציונלי)

הרזולוציה של המדיה.

ערכים אפשריים:

  • low
  • medium
  • high
  • ultra_high

type object  (חובה)

לא סופק תיאור.

הערך תמיד יהיה "video".

ThoughtSummaryDelta

content ThoughtSummaryContent  (אופציונלי)

פריט סיכום חדש שיוסף למחשבה.

סוגים אפשריים

ערך הדיסקרימינטור הפולימורפי: type

TextContent

בלוק של תוכן טקסט.

text string  (חובה)

תוכן הטקסט.

annotations Annotation  (אופציונלי)

מידע על ציטוט של תוכן שנוצר על ידי מודל.

מידע על ציטוט של תוכן שנוצר על ידי מודל.

סוגים אפשריים

ערך הדיסקרימינטור הפולימורפי: type

UrlCitation

הערה של ציטוט כתובת URL.

‫url string  (optional)

כתובת ה-URL.

title string  (אופציונלי)

הכותרת של כתובת ה-URL.

type string  (חובה)

לא סופק תיאור.

הערך תמיד יהיה "url_citation".

start_index integer  (optional)

תחילת הקטע בתשובה שמשויך למקור הזה.

end_index integer  (optional)

סוף הקטע המשויך, לא כולל.

FileCitation

הערה לציטוט קובץ.

document_uri string  (אופציונלי)

ה-URI של הקובץ.

file_name string  (optional)

שם הקובץ.

source string  (אופציונלי)

המקור שמשויך לחלק מהטקסט.

type string  (חובה)

לא סופק תיאור.

הערך תמיד יהיה "file_citation".

start_index integer  (optional)

תחילת הקטע בתשובה שמשויך למקור הזה.

end_index integer  (optional)

סוף הקטע המשויך, לא כולל.

PlaceCitation

הערה של ציטוט מקום.

place_id string  (optional)

המזהה של המקום, בפורמט ‎ `places/{place_id}` ‎.

name string  (אופציונלי)

שם המקום.

‫url string  (optional)

הפניה ל-URI של המקום.

review_snippets ReviewSnippet  (אופציונלי)

קטעי ביקורות שמשמשים ליצירת תשובות לגבי התכונות של מקום מסוים במפות Google.

התשובה כוללת קטע מביקורת של משתמש שעונה על שאלה לגבי התכונות של מקום ספציפי במפות Google.

שדות

title string  (אופציונלי)

כותרת הביקורת.

‫url string  (optional)

קישור שמתאים לביקורת של המשתמש במפות Google.

review_id string  (optional)

המזהה של קטע הביקורת.

type string  (חובה)

לא סופק תיאור.

הערך תמיד יהיה "place_citation".

start_index integer  (optional)

תחילת הקטע בתשובה שמשויך למקור הזה.

end_index integer  (optional)

סוף הקטע המשויך, לא כולל.

type object  (חובה)

לא סופק תיאור.

הערך תמיד יהיה "text".

ImageContent

בלוק תוכן של תמונה.

data string  (אופציונלי)

תוכן התמונה.

uri מחרוזת  (אופציונלי)

ה-URI של התמונה.

mime_type enum (string)  (optional)

סוג ה-MIME של התמונה.

ערכים אפשריים:

  • image/png
  • image/jpeg
  • image/webp
  • image/heic
  • image/heif
resolution MediaResolution  (אופציונלי)

הרזולוציה של המדיה.

ערכים אפשריים:

  • low
  • medium
  • high
  • ultra_high

type object  (חובה)

לא סופק תיאור.

הערך תמיד יהיה "image".

type object  (חובה)

לא סופק תיאור.

הערך תמיד יהיה "thought_summary".

ThoughtSignatureDelta

signature string  (אופציונלי)

חתימה שתתאים למקור ה-Backend שיהיה חלק מהיצירה.

type object  (חובה)

לא סופק תיאור.

הערך תמיד יהיה "thought_signature".

FunctionCallDelta

name string  (required)

לא סופק תיאור.

ארגומנטים object  (חובה)

לא סופק תיאור.

type object  (חובה)

לא סופק תיאור.

הערך תמיד יהיה "function_call".

id string  (חובה)

מזהה ייחודי של קריאה ספציפית לכלי.

signature string  (אופציונלי)

גיבוב חתימה לאימות בקצה העורפי.

FunctionResultDelta

name string  (אופציונלי)

לא סופק תיאור.

is_error boolean  (optional)

לא סופק תיאור.

result object or string  (required)

הפרש התוצאות של קריאה לכלי.

type object  (חובה)

לא סופק תיאור.

הערך תמיד יהיה "function_result".

call_id string  (required)

מזהה שצריך להיות זהה למזהה מבלוק בקשה להפעלת פונקציה.

signature string  (אופציונלי)

גיבוב חתימה לאימות בקצה העורפי.

CodeExecutionCallDelta

arguments CodeExecutionCallArguments  (חובה)

לא סופק תיאור.

הארגומנטים להעברה להרצת הקוד.

שדות

language enum (string)  (optional)

שפת התכנות של הקוד.

ערכים אפשריים:

  • python
code string  (אופציונלי)

הקוד שיופעל.

type object  (חובה)

לא סופק תיאור.

הערך תמיד יהיה "code_execution_call".

id string  (חובה)

מזהה ייחודי של קריאה ספציפית לכלי.

signature string  (אופציונלי)

גיבוב חתימה לאימות בקצה העורפי.

CodeExecutionResultDelta

result string  (required)

לא סופק תיאור.

is_error boolean  (optional)

לא סופק תיאור.

type object  (חובה)

לא סופק תיאור.

הערך תמיד יהיה "code_execution_result".

call_id string  (required)

מזהה שצריך להיות זהה למזהה מבלוק בקשה להפעלת פונקציה.

signature string  (אופציונלי)

גיבוב חתימה לאימות בקצה העורפי.

UrlContextCallDelta

arguments UrlContextCallArguments  (required)

לא סופק תיאור.

הארגומנטים להעברה להקשר של כתובת ה-URL.

שדות

‫urls array (string)  (optional)

כתובות ה-URL לאחזור.

type object  (חובה)

לא סופק תיאור.

הערך תמיד יהיה "url_context_call".

id string  (חובה)

מזהה ייחודי של קריאה ספציפית לכלי.

signature string  (אופציונלי)

גיבוב חתימה לאימות בקצה העורפי.

UrlContextResultDelta

result UrlContextResult  (required)

לא סופק תיאור.

התוצאה של ההקשר של כתובת ה-URL.

שדות

‫url string  (optional)

כתובת ה-URL שאוחזרה.

status enum (string)  (optional)

הסטטוס של אחזור כתובת ה-URL.

ערכים אפשריים:

  • success
  • error
  • paywall
  • unsafe
is_error boolean  (optional)

לא סופק תיאור.

type object  (חובה)

לא סופק תיאור.

הערך תמיד יהיה "url_context_result".

call_id string  (required)

מזהה שצריך להיות זהה למזהה מבלוק בקשה להפעלת פונקציה.

signature string  (אופציונלי)

גיבוב חתימה לאימות בקצה העורפי.

GoogleSearchCallDelta

arguments GoogleSearchCallArguments  (required)

לא סופק תיאור.

הארגומנטים להעברה לחיפוש Google.

שדות

‫queries array (string)  (optional)

שאילתות לחיפוש באינטרנט לחיפוש המשך באינטרנט.

type object  (חובה)

לא סופק תיאור.

הערך תמיד יהיה "google_search_call".

id string  (חובה)

מזהה ייחודי של קריאה ספציפית לכלי.

signature string  (אופציונלי)

גיבוב חתימה לאימות בקצה העורפי.

GoogleSearchResultDelta

result GoogleSearchResult  (required)

לא סופק תיאור.

התוצאה של חיפוש Google.

שדות

search_suggestions string  (optional)

קטע קוד של תוכן אינטרנט שאפשר להטמיע בדף אינטרנט או בתצוגת אינטרנט של אפליקציה.

is_error boolean  (optional)

לא סופק תיאור.

type object  (חובה)

לא סופק תיאור.

הערך תמיד יהיה "google_search_result".

call_id string  (required)

מזהה שצריך להיות זהה למזהה מבלוק בקשה להפעלת פונקציה.

signature string  (אופציונלי)

גיבוב חתימה לאימות בקצה העורפי.

McpServerToolCallDelta

name string  (required)

לא סופק תיאור.

server_name string  (required)

לא סופק תיאור.

ארגומנטים object  (חובה)

לא סופק תיאור.

type object  (חובה)

לא סופק תיאור.

הערך תמיד יהיה "mcp_server_tool_call".

id string  (חובה)

מזהה ייחודי של קריאה ספציפית לכלי.

signature string  (אופציונלי)

גיבוב חתימה לאימות בקצה העורפי.

McpServerToolResultDelta

name string  (אופציונלי)

לא סופק תיאור.

server_name string  (optional)

לא סופק תיאור.

result object or string  (required)

הפרש התוצאות של קריאה לכלי.

type object  (חובה)

לא סופק תיאור.

הערך תמיד יהיה "mcp_server_tool_result".

call_id string  (required)

מזהה שצריך להיות זהה למזהה מבלוק בקשה להפעלת פונקציה.

signature string  (אופציונלי)

גיבוב חתימה לאימות בקצה העורפי.

FileSearchCallDelta

type object  (חובה)

לא סופק תיאור.

הערך תמיד יהיה "file_search_call".

id string  (חובה)

מזהה ייחודי של קריאה ספציפית לכלי.

signature string  (אופציונלי)

גיבוב חתימה לאימות בקצה העורפי.

FileSearchResultDelta

result FileSearchResult  (אופציונלי)

לא סופק תיאור.

התוצאה של חיפוש הקובץ.

type object  (חובה)

לא סופק תיאור.

הערך תמיד יהיה "file_search_result".

call_id string  (required)

מזהה שצריך להיות זהה למזהה מבלוק בקשה להפעלת פונקציה.

signature string  (אופציונלי)

גיבוב חתימה לאימות בקצה העורפי.

GoogleMapsCallDelta

arguments GoogleMapsCallArguments  (optional)

הארגומנטים שמעבירים לכלי של מפות Google.

הארגומנטים שמעבירים לכלי של מפות Google.

שדות

‫queries array (string)  (optional)

השאילתות שיופעלו.

type object  (חובה)

לא סופק תיאור.

הערך תמיד יהיה "google_maps_call".

id string  (חובה)

מזהה ייחודי של קריאה ספציפית לכלי.

signature string  (אופציונלי)

גיבוב חתימה לאימות בקצה העורפי.

GoogleMapsResultDelta

result GoogleMapsResult  (חובה)

התוצאות של מפות Google.

התוצאה של מפות Google.

שדות

מקומות מקומות  (אופציונלי)

המקומות שנמצאו.

שדות

place_id string  (optional)

המזהה של המקום, בפורמט ‎ `places/{place_id}` ‎.

name string  (אופציונלי)

שם המקום.

‫url string  (optional)

הפניה ל-URI של המקום.

review_snippets ReviewSnippet  (אופציונלי)

קטעי ביקורות שמשמשים ליצירת תשובות לגבי התכונות של מקום מסוים במפות Google.

התשובה כוללת קטע מביקורת של משתמש שעונה על שאלה לגבי התכונות של מקום ספציפי במפות Google.

שדות

title string  (אופציונלי)

כותרת הביקורת.

‫url string  (optional)

קישור שמתאים לביקורת של המשתמש במפות Google.

review_id string  (optional)

המזהה של קטע הביקורת.

widget_context_token string  (optional)

שם המשאב של אסימון ההקשר של הווידג'ט של מפות Google.

type object  (חובה)

לא סופק תיאור.

הערך תמיד יהיה "google_maps_result".

call_id string  (required)

מזהה שצריך להיות זהה למזהה מבלוק בקשה להפעלת פונקציה.

signature string  (אופציונלי)

גיבוב חתימה לאימות בקצה העורפי.

event_type string  (required)

לא סופק תיאור.

הערך תמיד יהיה "content.delta".

event_id string  (optional)

הטוקן event_id שישמש להמשך זרם האינטראקציות, מהאירוע הזה.

ContentStop

index integer  (required)

לא סופק תיאור.

event_type string  (required)

לא סופק תיאור.

הערך תמיד יהיה "content.stop".

event_id string  (optional)

הטוקן event_id שישמש להמשך זרם האינטראקציות, מהאירוע הזה.

ErrorEvent

error Error  (אופציונלי)

לא סופק תיאור.

הודעת שגיאה מאינטראקציה.

שדות

code string  (אופציונלי)

‫URI שמזהה את סוג השגיאה.

‫message string  (אופציונלי)

הודעת שגיאה שקריאה לאנשים.

event_type string  (required)

לא סופק תיאור.

הערך תמיד יהיה "error".

event_id string  (optional)

הטוקן event_id שישמש להמשך זרם האינטראקציות, מהאירוע הזה.

דוגמאות

תחילת האינטראקציה

{
  "event_type": "interaction.start",
  "interaction": {
    "id": "v1_ChdTMjQ0YWJ5TUF1TzcxZThQdjRpcnFRcxIXUzI0NGFieU1BdU83MWU4UHY0aXJxUXM",
    "model": "gemini-3-flash-preview",
    "object": "interaction",
    "status": "in_progress"
  }
}

האינטראקציה הסתיימה

{
  "event_type": "interaction.complete",
  "interaction": {
    "created": "2025-12-09T18:45:40Z",
    "id": "v1_ChdTMjQ0YWJ5TUF1TzcxZThQdjRpcnFRcxIXUzI0NGFieU1BdU83MWU4UHY0aXJxUXM",
    "model": "gemini-3-flash-preview",
    "object": "interaction",
    "role": "model",
    "status": "completed",
    "updated": "2025-12-09T18:45:40Z",
    "usage": {
      "input_tokens_by_modality": [
        {
          "modality": "text",
          "tokens": 11
        }
      ],
      "total_cached_tokens": 0,
      "total_input_tokens": 11,
      "total_output_tokens": 364,
      "total_thought_tokens": 1120,
      "total_tokens": 1495,
      "total_tool_use_tokens": 0
    }
  }
}

עדכון סטטוס האינטראקציה

{
  "event_type": "interaction.status_update",
  "interaction_id": "v1_ChdTMjQ0YWJ5TUF1TzcxZThQdjRpcnFRcxIXUzI0NGFieU1BdU83MWU4UHY0aXJxUXM",
  "status": "in_progress"
}

תחילת התוכן

{
  "event_type": "content.start",
  "content": {
    "type": "text"
  },
  "index": 1
}

דלתא של תוכן

{
  "event_type": "content.delta",
  "delta": {
    "type": "text",
    "text": "Elara\u2019s life was a symphony of quiet moments. A librarian, she found solace in the hushed aisles, the scent of aged paper, and the predictable rhythm of her days. Her small apartment, meticulously ordered, reflected this internal calm, save"
  },
  "index": 1
}

הפסקת התוכן

{
  "event_type": "content.stop",
  "index": 1
}

אירוע שגיאה

{
  "event_type": "error",
  "error": {
    "message": "Failed to get completed interaction: Result not found.",
    "code": "not_found"
  }
}