Interactions API: Nossa interface principal para modelos e agentes Gemini

Hoje anunciamos que a API de Interações está disponível ao público em geral e é agora nossa API principal para interagir com modelos e agentes Gemini. Lançamos sua versão beta pública em dezembro de 2025, e rapidamente se tornou a forma favorita dos desenvolvedores de construir aplicações com Gemini.

Com este lançamento GA, a API agora possui um esquema estável e também adicionamos importantes novos recursos solicitados pelos desenvolvedores, incluindo Agentes Gerenciados, execução em segundo plano, Gemini Omni (em breve) e mais. Toda a nossa documentação agora utiliza a API de Interações como padrão e estamos trabalhando com parceiros do ecossistema para torná-la a interface padrão em SDKs e bibliotecas de terceiros.

A forma mais simples de construir com Gemini

Seja chamando um modelo ou executando um agente, a API de Interações te leva até lá com poucas linhas de código. Passe um ID de modelo para inferência ou um ID de agente para tarefas autônomas e defina background=True para tarefas longas.

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="Explique o emaranhamento quântico de forma simples.",
9)
10
11# Run an agent
12interaction = client.interactions.create(
13    agent="antigravity-preview-05-2026",
14    input="Plote o crescimento da geração de energia solar globalmente e crie alguns slides em HTML.",
15    environment="remote",
16)

Principais atualizações desde dezembro

• Agentes Gerenciados: Uma única chamada de API provisiona um sandbox Linux remoto onde um agente pode raciocinar, executar código, navegar na web e gerenciar arquivos. O agente Antigravity vem como padrão, e você pode definir seus próprios agentes personalizados com instruções, habilidades e fontes de dados.
• Execução em segundo plano: Defina background=True em qualquer chamada. O servidor executa a interação assincronamente.
• Melhorias nas ferramentas: Combine ferramentas integradas, como Google Search e Google Maps, com suas próprias funções em uma única requisição. Os resultados das ferramentas agora podem retornar imagens junto com texto.
• Melhorias no Deep Research: Duas novas versões do agente (velocidade vs. profundidade), planejamento colaborativo, gráficos nativos e infográficos, e fundamentação multimodal com imagens, PDFs e áudio.
• Geração de mídia: Geração de imagens com Nano Banana 2 e fundamentação do Google Image Search, música com Lyria 3 e fala expressiva com TTS multi-voz.
• De papéis para etapas: Esquema simplificado onde cada ação (user_input, thought, function_call, model_output, etc.) é sua própria etapa tipada, substituindo a antiga estrutura de papéis.
• Otimizações de custo e desenvolvimento: Camadas Flex e Priority permitem otimizar para custo ou latência (Flex oferece redução de 50% no custo). Erros agora indicam o campo exato. Interações passadas são recuperáveis com retenção de 55 dias no plano pago.

O novo padrão para desenvolvimento

A API de Interações agora é o padrão do Google AI Studio, da API Gemini e de toda a nossa documentação, que inclui um botão para alternar os snippets de volta ao formato legado. Recomendamos usar a API de Interações para todos os novos projetos e aplicações.

Embora a API legada generateContent continue totalmente suportada e continuará recebendo novos modelos Gemini principais em um futuro previsível, esperamos que os recursos de fronteira para modelos e agentes de longa duração sejam cada vez mais lançados exclusivamente na API de Interações. Isso porque ela foi projetada desde o início para fluxos de trabalho com estado e agentes. Publicamos um guia de migração para ajudar você a fazer a transição no seu próprio ritmo.

Um ecossistema focado em agentes

A maioria dos desenvolvedores agora está usando agentes de codificação (como Antigravity) para construir aplicações. Para facilitar que os agentes se mantenham atualizados com os padrões mais recentes da API, criamos a Skill gemini-interactions-api. Ela injeta padrões de melhores práticas para desenvolvimento com a API de Interações no contexto do seu agente (streaming, chamada de funções, saída estruturada, Deep Research e mais).

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

Comece agora

A API de Interações está disponível através dos SDKs Python e JavaScript. Se você já está construindo com um de nossos parceiros suportados, LiteLLM, Eigent ou Agno, você pode começar a usar as integrações da API de Interações deles hoje mesmo.

Pegue sua chave de API no Google AI Studio e siga a documentação da API de Interações para começar. Se você está migrando do generateContent, nosso guia de migração mapeia cada campo para o novo esquema. Você também pode ver a especificação OpenAPI completa.

A API de Interações foi construída com base no feedback dos desenvolvedores, e esse foco não vai mudar com a disponibilidade geral. Conte para a gente o que você precisa no fórum de desenvolvedores.