Interactions API Now Primary Interface for Gemini Models and Agents

A major update has been made to the way developers interact with Google’s Gemini models and agents. The Interactions API, which was launched in public beta last December, is now generally available and serves as the primary interface for these applications. This shift marks a significant change from the legacy generateContent API, although the latter will continue to be supported for the foreseeable future.

The Interactions API offers several key features that make it an attractive choice for developers building with Gemini models and agents. These include server-side state, background execution, tool combination, and multimodal generation capabilities. With this release, a stable schema has been established, and major new functionalities have been added in response to developer requests.

One of the most significant additions is Managed Agents, which allows for more efficient management of agent resources. Background execution enables long-running tasks to be performed without blocking other operations. Gemini Omni will also soon be integrated into the API. These features are designed to support stateful and agentic workflows, making them particularly well-suited for applications that require persistent interactions with users or environments.

The Interactions API is now the default interface across various Google AI tools, including Google AI Studio and the Gemini API. All documentation has been updated to reflect this change, although a toggle remains available to switch back to legacy format snippets. Developers are encouraged to use the Interactions API for new projects and applications, as it offers improved flexibility and efficiency.

For developers already building with supported partners such as LiteLLM, Eigent, or Agno, integrations for the Interactions API are readily available through these platforms. The gemini-interactions-api Skill has also been developed to inject best-practice patterns into agent development contexts, making it easier for agents to stay up-to-date with the latest API developments.

The Interactions API is accessible via Python and JavaScript SDKs. To get started, developers can obtain an API key from Google AI Studio and consult the comprehensive documentation provided by Google. A migration guide has been published to assist those transitioning from the legacy generateContent API, which maps every field to the new schema for a seamless transition.

Google continues to prioritize developer feedback in shaping the Interactions API’s future development. The company encourages developers to share their needs and suggestions on the developer forum, ensuring that the API remains responsive to its users’ requirements.