Início rápido da API Gemini

Neste guia de início rápido, mostramos como instalar nossas bibliotecas e fazer sua primeira solicitação de API Gemini usando a API Interactions.

Antes de começar

Para usar a API Gemini, você precisa ter uma chave de API para autenticar suas solicitações, aplicar limites de segurança e rastrear o uso na sua conta.

Crie um no AI Studio sem custo financeiro para começar:

Criar uma chave da API Gemini

Instalar o SDK de IA generativa do Google

pip install -q -U google-genai

npm install @google/genai

Faça sua primeira solicitação

Há duas maneiras de enviar uma solicitação à API Gemini:

• (Recomendado) A API Interactions é uma nova primitiva com suporte nativo para uso de ferramentas em várias etapas, orquestração e fluxos de raciocínio complexos por etapas de execução tipadas. A partir de agora, novos modelos além da família principal, além de novas ferramentas e recursos agênticos, serão lançados exclusivamente na API Interactions.
• O generateContent oferece uma maneira de gerar uma resposta simples e sem estado de um modelo. Recomendamos usar a API Interactions, mas o generateContent tem suporte total.

Este exemplo usa a API Interactions para enviar uma solicitação à API Gemini usando o modelo Gemini 3 Flash.

Se você definir sua chave de API como a variável de ambiente GEMINI_API_KEY, ela será selecionada automaticamente pelo cliente ao usar as bibliotecas da API Gemini. Caso contrário, será necessário transmitir sua chave de API como um argumento ao inicializar o cliente.

Observação: todas as amostras de código na documentação da API Gemini pressupõem que você definiu a variável de ambiente GEMINI_API_KEY.

# This will only work for SDK newer than 2.0.0
from google import genai

# The client gets the API key from the environment variable `GEMINI_API_KEY`.
client = genai.Client()

interaction = client.interactions.create(
    model="gemini-3-flash-preview", 
    input="Explain how AI works in a few words"
)

# Print the model's text response
for step in interaction.steps:
    if step.type == "model_output":
        for content_block in step.content:
            if content_block.type == "text":
                print(content_block.text)

// This will only work for SDK newer than 2.0.0
import { GoogleGenAI } from "@google/genai";

// The client gets the API key from the environment variable `GEMINI_API_KEY`.
const ai = new GoogleGenAI({});

async function main() {
  const interaction = await ai.interactions.create({
    model: "gemini-3-flash-preview",
    input: "Explain how AI works in a few words",
  });

  const modelStep = interaction.steps.find(s => s.type === 'model_output');
  if (modelStep) {
    for (const contentBlock of modelStep.content) {
      if (contentBlock.type === 'text') console.log(contentBlock.text);
    }
  }
}

main();

# Specifies the API revision to avoid breaking changes when they become default
curl -X POST "https://generativelanguage.googleapis.com/v1beta/interactions" \
  -H "x-goog-api-key: $GEMINI_API_KEY" \
  -H 'Content-Type: application/json' \
  -H "Api-Revision: 2026-05-20" \
  -d '{
    "model": "gemini-3-flash-preview",
    "input": "Explain how AI works in a few words"
  }'

Modo sem estado

Por padrão, a API Interactions gerencia o estado da conversa no lado do servidor quando você usa previous_interaction_id. Se você preferir gerenciar o histórico de conversas por conta própria no lado do cliente, ative o modo sem estado definindo store=false e transmitindo as etapas acumuladas no campo input de solicitações subsequentes.

Para mais detalhes e exemplos completos de conversas multiturno sem estado, consulte o guia de geração de texto.

A seguir

Agora que você fez sua primeira solicitação de API, talvez queira conferir os seguintes guias que mostram o Gemini em ação:

• Geração de texto
• Geração de imagens
• Compreensão de imagens
• Raciocínio
• Chamadas de função
• Contexto longo
• Embeddings