Guia inicial Gemini 2.5 Pro: pesquisar, criar e analisar

Sua primeira hora com Gemini 2.5 Pro

Se você tem 60 minutos e quer ir do zero a uma integração funcional do Gemini 2.5 Pro, este guia é para você. Acompanhei cerca de 300 desenvolvedores nesse processo nos últimos dois meses. O melhor padrão: fazer algo funcionar primeiro, depois entender por quê.

Passo 1: Obter sua chave API (5 minutos)

Vá ao Google AI Studio (aistudio.google.com). O nível gratuito oferece 60 requisições por minuto para Gemini 2.5 Pro. Armazene a chave API em uma variável de ambiente, não no código. Adicione .env ao .gitignore.

Passo 2: Sua primeira chamada API (10 minutos)

npm install @google/genai

import { GoogleGenAI } from "@google/genai";
const ai = new GoogleGenAI({ apiKey: process.env.GEMINI_API_KEY });
const response = await ai.models.generateContent({
  model: "gemini-2.5-pro",
  contents: "Explique a diferença entre REST e GraphQL em dois parágrafos.",
});
console.log(response.text);

Custos de tokens: entrada $1.25/milhão, saída $5/milhão. Uma consulta típica custa cerca de $0.001.

Passo 3: Construir um analisador de documentos (25 minutos)

Construir algo útil: receber PDF, extrair conteúdo, gerar resumo estruturado. Use responseMimeType: "application/json" para forçar saída estruturada — um recurso específico do Gemini que garante JSON válido.

Passo 4: Adicionar search grounding (10 minutos)

O Google Search Grounding complementa respostas com resultados de busca em tempo real. Adiciona 1-3 segundos de latência e não está disponível em todas as regiões.

Passo 5: Tratamento de erros e limites de taxa (10 minutos)

Backoff exponencial para 429, backoff linear para 500/503. O SDK não tem lógica de retry embutida.

O que construir depois

Três ideias: resumidor de notas de reunião, conversor de capturas de tela para código, analisador de qualidade de conteúdo. A API do Gemini 2.5 Pro está estável para produção desde março de 2026. Não pense demais — comece a construir.