Hoy anunciamos que la API de Interactions ha alcanzado la disponibilidad general y es ahora 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 convirtió en la forma favorita de los desarrolladores para crear aplicaciones con Gemini.
Con este lanzamiento estable, la API ahora cuenta con un esquema estable y también agregamos importantes capacidades nuevas que los desarrolladores solicitaron, incluidos Agentes Administrados, ejecución en segundo plano, Gemini Omni (próximamente) y más. Toda nuestra documentación ahora utiliza la API de Interactions por defecto y estamos trabajando con socios del ecosistema para que sea la interfaz predeterminada en todos los SDK y librerías de terceros.
La forma más simple de crear con Gemini
Ya sea que estés llamando a un modelo o ejecutando un agente, la API de Interactions 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 genai23client = genai.Client()45# Talk to a model6interaction = client.interactions.create(7 model="gemini-3.5-flash",8 input="Explain quantum entanglement simply.",9)1011# Run an agent12interaction = 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
- Agentes Administrados: Una sola llamada a la API aprovisiona un sandbox remoto de Linux donde un agente puede razonar, ejecutar código, navegar por la web y gestionar archivos. El agente Antigravity viene 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 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 en Google Image Search, música con Lyria 3, y habla expresiva con TTS multihablante.
- De Roles a Pasos: Esquema simplificado donde cada acción (user_input, thought, function_call, model_output, etc.) es un paso tipado propio, reemplazando la antigua estructura de roles.
- Optimizaciones de costo y desarrollador: Los niveles Flex y Priority te permiten optimizar costos o latencia (Flex ofrece 50% de reducción de costos). Los errores ahora señalan el campo exacto. Las interacciones pasadas son recuperables con 55 días de retención en el plan pago.
El nuevo estándar para el desarrollo
La API de Interactions es ahora la predeterminada para Google AI Studio, la API de Gemini y toda nuestra documentación, que incluye un botón para cambiar los fragmentos al formato heredado. Recomendamos usar la API de Interactions 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 de larga duración y agentes se implementen cada vez más exclusivamente en la API de Interactions. Esto se debe a que está diseñada desde cero para flujos de trabajo con estado y orientados a 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 patrones más recientes de la API, creamos la Skill gemini-interactions-api. Inyecta patrones de buenas prácticas para el desarrollo con la API de Interactions 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 API de Interactions está disponible a través de los SDK de Python y JavaScript. Si ya estás desarrollando con alguno de nuestros socios compatibles, LiteLLM, Eigent o Agno, puedes empezar a usar sus integraciones de la API de Interactions hoy mismo.
Obtén tu clave de API desde Google AI Studio y sigue la documentación de la API de Interactions para comenzar. Si migras desde generateContent, nuestra guía de migración mapea cada campo al nuevo esquema. También puedes ver la especificación OpenAPI completa.
La API de Interactions se construyó con base en los comentarios de los desarrolladores, y ese enfoque no cambiará con la disponibilidad general. Cuéntanos qué necesitas en el foro de desarrolladores.
