Configurando Gemini

Antes de generar texto, necesitamos preparar nuestro entorno. A diferencia de las pruebas rápidas en la web, aquí construiremos una infraestructura de código de producción.

Utilizaremos el SDK oficial de Google (@google/genai) para Node.js, que nos abstrae de la complejidad de las peticiones HTTP puras.

Paso 1: Obtener tu API Key

Necesitamos una credencial para autenticarnos. Google ofrece un tier gratuito generoso ideal para desarrollo.

1. Ve a Google AI Studio.
2. Inicia sesión con tu cuenta de Google.
3. Haz clic en el botón Create API Key.
4. Copia la clave que empieza por AIza.... No la compartas.

Paso 2: Inicializar el proyecto

Vamos a crear un directorio limpio para nuestro laboratorio. Abre tu terminal:

Terminal

# Crear carpeta del proyecto
mkdir gemini-lab
cd gemini-lab

# Iniciar proyecto de Node.js (acepta los defaults)
npm init -y

# Instalar el SDK de Google y dotenv para variables de entorno
npm install @google/genai dotenv

Consejo

Asegúrate de tener Node.js versión 18 o superior instalada para que el SDK funcione correctamente.

Paso 3: Seguridad (.env)

Nunca escribas tu API Key directamente en el código (hardcode). Si subes ese archivo a GitHub, los bots robarán tu clave en segundos. Usaremos variables de entorno.

1. Crea un archivo llamado .env en la raíz de tu proyecto.
2. Pega tu clave con el siguiente nombre:

.env

GEMINI_API_KEY=AIza...

3. Crea un archivo .gitignore y añade lo siguiente para evitar accidentes:

.gitignore

node_modules
.env

Paso 4: El cliente singleton

En lugar de conectar con Gemini en cada archivo, crearemos un módulo de configuración centralizado. Esto nos permitirá cambiar el modelo (por ejemplo, de flash a pro) en un solo lugar.

Crea una carpeta src y dentro un archivo config.js (o .ts si usas TypeScript):

• Directoriogemini-lab

  • .env
  • package.json
  • Directoriosrc

    • config.js Tu archivo de conexión

Copia el siguiente código en src/config.js:

src/config.js

import { GoogleGenAI } from "@google/genai";
import dotenv from "dotenv";

// 1. Cargar variables de entorno
dotenv.config();
const apiKey = process.env.GEMINI_API_KEY;

// 2. Validación temprana (Fail Fast)
if (!apiKey) {
  throw new Error("ERROR: La variable GEMINI_API_KEY no está definida en el archivo .env");
}

// 3. Inicializar el cliente
const genAI = new GoogleGenAI({apiKey});

// 4. Exportar el cliente para uso general
export const client = genAI;

console.log("Conexión con Gemini configurada correctamente.");

Paso 5: Prueba de conexión

Vamos a verificar que todo funciona antes de continuar. Crea un archivo temporal test.js en la raíz:

test.js

import { client } from "./src/config.js";

async function main() {
  try {
    const prompt = "Confirma tu estado. Responde únicamente con 'OK'.";
    const result = await client.models.generateContent({
      model: "gemini-3-flash-preview",
      contents: [{ role: "user", parts: [{ text: prompt }] }]
    });
    console.log(result.text);
  } catch (error) {
    console.error("Error conectando:", error);
  }
}

main();

Ejecútalo en tu terminal: node test.js. Si ves un “OK”, tu infraestructura está lista para construir aplicaciones complejas.