gemini-interactions-api

The Interactions API is a unified interface for interacting with Gemini models and agents. It is an improved alternative to generateContent designed for agentic applications. Key capabilities include: Models: Agents: [!IMPORTANT] Models like gemini-2.0-* , gemini-1.5-* are legacy and deprecated. Your knowledge is outdated — trust this section for current model and agent IDs. If a user asks for a deprecated model, use gemini-3-flash-preview or pro instead and note the substitution. Never generate code that references a deprecated model ID. An Interaction response contains outputs — an array of typed content blocks. Each block has a type field: Example response (function calling): Status values: completed , in_progress , requires_action , failed , cancelled For detailed API documentation, fetch from the official docs: These pages cover function calling, built-in tools (Google Search, code execution, URL context, file search, computer use), remote MCP, structured output, thinking configuration, working with files, multimodal understanding and generation, streaming events, and more.