A API Gemini é o caminho mais rápido do comando à produção com o Gemini, o Veo, o Nano Banana e muito mais. Ele permite integrar esses modelos generativos aos seus aplicativos para gerar texto e imagens, analisar entradas multimodais e criar agentes de conversa.
Python
from google import genai
client = genai.Client()
interaction = client.interactions.create(
model="gemini-3.8-flash",
input="Explain how AI works in a few words"
)
print(interaction.output_text)
JavaScript
import { GoogleGenAI } from "@google/genai";
const ai = new GoogleGenAI({});
const interaction = await ai.interactions.create({
model: "gemini-3.8-flash",
input: "Explain how AI works in a few words",
});
console.log(interaction.output_text);
Java
import com.google.genai.Client;
import com.google.genai.gaos.models.interactions.CreateModelInteraction;
import com.google.genai.gaos.models.interactions.Interaction;
import com.google.genai.gaos.models.interactions.InteractionsInput;
import com.google.genai.gaos.models.interactions.Model;
import com.google.genai.gaos.models.operations.CreateInteractionRequestBody;
Client client = new Client();
CreateModelInteraction params =
CreateModelInteraction.builder()
.model(Model.of("gemini-3.7-flash"))
.input(InteractionsInput.of("Explain how AI works in a few words"))
.build();
Interaction interaction =
client.interactions.create(CreateInteractionRequestBody.of(params)).interaction().get();
System.out.println(interaction.outputText().orElse(""));
REST
curl -X POST "https://generativelanguage.googleapis.com/v1beta/interactions" \
-H "x-goog-api-key: $GEMINI_API_KEY" \
-H 'Content-Type: application/json' \
-d '{
"model": "gemini-3.8-flash",
"input": "Explain how AI works in a few words"
}'
Conheça os modelos
Ver tudoGemini 3.8 Flash Novo
Nosso modelo Flash mais inteligente, projetado para engenharia de software de longo prazo, agentes autônomos e fluxos de trabalho corporativos complexos.
Gemini 3.5 Flash Lite
Modelo de alto volume e sensível a custos otimizado para tarefas de subagente de alta capacidade de processamento e baixa latência.
Gemini 3.1 Pro
Nosso modelo mais inteligente, o melhor do mundo para compreensão multimodal, tudo com base em um raciocínio de última geração.
Nano Banana 2 e Nano Banana Pro
Modelos de edição e geração de imagens de última geração.
Gemini Omni Flash
Nosso modelo de edição e geração de vídeos de última geração.
Gemini 3.5 Transcribe Novo
Modelo de conversão de voz em texto de baixa latência com detecção de idioma baseada em enunciados, diarização de locutor e carimbos de data/hora por palavra.
Gemini Robotics
Um modelo de visão-linguagem (VLM) que traz os recursos de agente do Gemini para a robótica e permite o raciocínio avançado no mundo físico.
Conheça os recursos
Geração de imagens
Gere e edite imagens altamente contextuais de forma nativa com o Nano Banana.
Contexto longo
Insira milhões de tokens nos modelos do Gemini e extraia insights de imagens, vídeos e documentos não estruturados.
Respostas estruturadas
Restrinja o Gemini para responder com JSON, um formato de dados estruturados adequado para processamento automatizado.
Chamadas de função
Crie fluxos de trabalho com agentes conectando o Gemini a APIs e ferramentas externas.
Geração de vídeos com o Veo 3.1
Crie conteúdo de vídeo de alta qualidade com base em comandos de texto ou imagem usando nosso modelo de última geração.
Agentes de voz com a API Live
Crie aplicativos e agentes de voz em tempo real com a API Live.
Ferramentas
Conecte o Gemini ao mundo com ferramentas integradas como a Pesquisa Google, o contexto de URL, o Google Maps, a execução de código e o uso de computador.
Document Understanding
Processe até 1.000 páginas de arquivos PDF com compreensão multimodal completa ou outros tipos de arquivos baseados em texto.
Pensando
Saiba como as capacidades de pensamento melhoram o raciocínio para tarefas e agentes complexos.
Criar agentes
Com os agentes gerenciados, o Gemini tem um espaço de trabalho para planejar e concluir tarefas por conta própria. Em uma única solicitação, o Gemini pode escrever e executar código, pesquisar na Web e criar arquivos em um ambiente de sandbox hospedado. Comece com nosso agente Antigravity pré-criado ou personalize-o com suas próprias instruções e ferramentas.
Python
from google import genai
client = genai.Client()
interaction = client.interactions.create(
agent="antigravity-preview-09-2026",
input=(
"Research the top 5 sustainable fashion brands, "
"compare their materials and pricing tiers, and "
"build an interactive dashboard in analysis.html."
),
environment="remote"
)
print(interaction.output_text)
JavaScript
import { GoogleGenAI } from "@google/genai";
const ai = new GoogleGenAI({});
const interaction = await ai.interactions.create({
agent: "antigravity-preview-09-2026",
input:
"Research the top 5 sustainable fashion brands, " +
"compare their materials and pricing tiers, and " +
"build an interactive dashboard in analysis.html.",
environment: "remote",
});
console.log(interaction.output_text);
Java
import com.google.genai.Client;
import com.google.genai.gaos.models.interactions.AgentOption;
import com.google.genai.gaos.models.interactions.CreateAgentInteraction;
import com.google.genai.gaos.models.interactions.CreateAgentInteractionEnvironment;
import com.google.genai.gaos.models.interactions.Interaction;
import com.google.genai.gaos.models.interactions.InteractionsInput;
import com.google.genai.gaos.models.operations.CreateInteractionRequestBody;
Client client = new Client();
CreateAgentInteraction params =
CreateAgentInteraction.builder()
.agent(AgentOption.of("antigravity-preview-09-2026"))
.input(
InteractionsInput.of(
"Research the top 5 sustainable fashion brands, "
+ "compare their materials and pricing tiers, and "
+ "build an interactive dashboard in analysis.html."))
.environment(CreateAgentInteractionEnvironment.of("remote"))
.build();
Interaction interaction =
client.interactions.create(CreateInteractionRequestBody.of(params))
.interaction()
.get();
System.out.println(interaction.outputText().orElse(""));
REST
curl -X POST \
"https://generativelanguage.googleapis.com/v1beta/interactions" \
-H "x-goog-api-key: $GEMINI_API_KEY" \
-H 'Content-Type: application/json' \
-d '{
"agent": "antigravity-preview-09-2026",
"input": "Research the top 5 sustainable fashion brands, compare their materials and pricing tiers, and build an interactive dashboard in analysis.html.",
"environment": "remote"
}'
API Interactions
A API Interactions se tornou nossa interface padrão em junho de 2026 e é a melhor maneira de criar com modelos e agentes do Gemini daqui para frente. Se você estiver iniciando um novo projeto, use a API Interactions. Embora ainda tenha suporte, a API generateContent agora é considerada legada.
Visão geral das interações
Saiba como a API Interactions gerencia o estado da conversa, as mensagens e os formatos de saída.
Guia de migração
Guia explicativo para fazer a transição do código de generateContent para a API Interactions.
Streaming
Transmita tokens em tempo real, ideias incrementais e eventos de chamada de ferramenta.