Interactions API: Nuestra interfaz principal para modelos y agentes de Gemini

Hoy anunciamos que la Interactions API ha alcanzado la disponibilidad general y ahora es nuestra API principal para interactuar con los modelos y agentes de Gemini. Lanzamos su beta pública en diciembre de 2025, y rápidamente se ha convertido en la forma favorita de los desarrolladores para crear aplicaciones con Gemini.

Con este lanzamiento GA, la API ahora tiene un esquema estable y también agregamos nuevas capacidades importantes que los desarrolladores solicitaron, incluyendo Managed Agents, ejecución en segundo plano, Gemini Omni (próximamente) y más. Toda nuestra documentación ahora utiliza por defecto la Interactions API y estamos trabajando con socios del ecosistema para que sea la interfaz predeterminada en SDKs y librerías de terceros.

La forma más simple de trabajar con Gemini

Ya sea que estés llamando a un modelo o ejecutando un agente, la Interactions API te lleva allí en pocas líneas de código. Pasa un ID de modelo para inferencia o un ID de agente para tareas autónomas, y establece background=True para cualquier proceso de larga duración.

1from google import genai
2
3client = genai.Client()
4
5# Talk to a model
6interaction = client.interactions.create(
7    model="gemini-3.5-flash",
8    input="Explain quantum entanglement simply.",
9)
10
11# Run an agent
12interaction = client.interactions.create(
13    agent="antigravity-preview-05-2026",
14    input="Plot the growth of solar energy generation globally and make some slides in HTML.",
15    environment="remote",
16)

Actualizaciones clave desde diciembre

• Managed Agents: Una sola llamada a la API aprovisiona un sandbox Linux remoto donde un agente puede razonar, ejecutar código, navegar por la web y gestionar archivos. El agente Antigravity se envía como predeterminado, y puedes definir tus propios agentes personalizados con instrucciones, habilidades y fuentes de datos.
• Ejecución en segundo plano: Establece background=True en cualquier llamada. El servidor ejecuta la interacción de forma asíncrona.
• Mejoras en herramientas: Combina herramientas integradas, como Google Search, Google Maps con tus propias funciones en una sola solicitud. Los resultados de las herramientas ahora pueden devolver imágenes junto con texto.
• Mejoras en Deep Research: Dos nuevas versiones del agente (velocidad vs. profundidad), planificación colaborativa, gráficos e infografías nativos, y fundamentación multimodal con imágenes, PDFs y audio.
• Generación de medios: Generación de imágenes con Nano Banana 2 y fundamentación con Google Image Search, música con Lyria 3, y habla expresiva con TTS multi-voz.
• De Roles a Pasos: Esquema simplificado donde cada acción (user_input, thought, function_call, model_output, etc.) es su propio paso tipificado, reemplazando la antigua estructura de roles.
• Optimizaciones de costos y para desarrolladores: Los niveles Flex y Priority te permiten optimizar costos o latencia (Flex ofrece una reducción del 50% en costos). Los errores ahora señalan el campo exacto. Las interacciones pasadas son recuperables con una retención de 55 días en el nivel de pago.

El nuevo estándar para el desarrollo

La Interactions API ahora es la opción predeterminada para Google AI Studio, la Gemini API y toda nuestra documentación, que incluye un interruptor para cambiar los fragmentos de código de vuelta al formato heredado. Recomendamos usar la Interactions API para todos los proyectos y aplicaciones nuevos.

Si bien la API heredada generateContent sigue siendo totalmente compatible y continuará recibiendo nuevos modelos principales de Gemini en el futuro previsible, esperamos que las capacidades de frontera para modelos y agentes de larga duración se implementen cada vez más exclusivamente en la Interactions API. Esto se debe a que está diseñada desde cero para flujos de trabajo con estado y agentes. Hemos publicado una guía de migración para ayudarte a hacer la transición a tu propio ritmo.

Un ecosistema centrado en agentes

La mayoría de los desarrolladores ahora usan agentes de codificación (como Antigravity) para crear aplicaciones. Para facilitar que los agentes se mantengan actualizados con los últimos patrones de la API, creamos el Skill gemini-interactions-api. Inyecta patrones de mejores prácticas para el desarrollo con la Interactions API en el contexto de tu agente (streaming, llamada a funciones, salida estructurada, Deep Research y más).

1npx skills add google-gemini/gemini-skills --skill gemini-interactions-api

Comienza ahora

La Interactions API está disponible a través de los SDKs de Python y JavaScript. Si ya estás trabajando con uno de nuestros socios compatibles, LiteLLM, Eigent o Agno, puedes comenzar a usar sus integraciones con la Interactions API hoy mismo.

Obtén tu clave de API desde Google AI Studio y sigue la documentación de la Interactions API para empezar. Si estás migrando desde generateContent, nuestra guía de migración mapea cada campo al nuevo esquema. También puedes ver la especificación completa de OpenAPI.

La Interactions API fue construida basada en los comentarios de los desarrolladores, y ese enfoque no cambiará con la disponibilidad general. Cuéntanos lo que necesitas en el foro de desarrolladores.