Guía de inicio de Gemini 2.5 Pro: buscar, crear y analizar

Tu primera hora con Gemini 2.5 Pro

Si tienes 60 minutos y quieres pasar de cero a una integración funcional de Gemini 2.5 Pro, esta guía es para ti. He guiado a unos 300 desarrolladores por este proceso en los últimos dos meses. El mejor patrón: hacer que algo funcione primero, luego entender por qué funciona.

Paso 1: Obtener tu clave API (5 minutos)

Ve a Google AI Studio (aistudio.google.com). El nivel gratuito da 60 solicitudes por minuto para Gemini 2.5 Pro. Almacena tu clave API en una variable de entorno, no en el código. Agrega .env a .gitignore.

Paso 2: Tu primera llamada 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: "Explica la diferencia entre REST y GraphQL en dos párrafos.",
});
console.log(response.text);

Costos de tokens: entrada $1.25/millón de tokens, salida $5/millón. Una consulta típica cuesta unos $0.001.

Paso 3: Construir un analizador de documentos (25 minutos)

Crea una herramienta útil: recibir PDF, extraer contenido, generar resumen estructurado. Usa responseMimeType: "application/json" para forzar salida estructurada — una función específica de Gemini que garantiza JSON válido.

Paso 4: Agregar search grounding (10 minutos)

Google Search Grounding complementa respuestas con resultados de búsqueda en tiempo real. Añade 1-3 segundos de latencia y no está disponible en todas las regiones.

Paso 5: Manejo de errores y límites de tasa (10 minutos)

Backoff exponencial para 429, backoff lineal para 500/503. El SDK no tiene lógica de reintento incorporada.

Qué construir después

Tres ideas: resumidor de notas de reuniones, convertidor de capturas a código, analizador de calidad de contenido. La API de Gemini 2.5 Pro es estable para producción desde marzo de 2026. No lo pienses demasiado — empieza a construir.