Itinerario AI Builder · Semana 0 · Para empezar

PE02: Tus cuentas y claves gratis

Desde cero⏱ 45-60 min

Objetivos

  • Crear una cuenta de GitHub con verificación en dos pasos.
  • Entender qué es una clave de API y por qué vale tanto como una contraseña.
  • Conseguir al menos una clave de IA sin tarjeta (Google AI Studio, Groq u OpenRouter).
  • Guardar la clave en un fichero .env y comprobar que .gitignore impide subirla.
  • Saber revocar una clave en cada proveedor en menos de un minuto.

Antes de empezar: pe01 terminado (o un Codespace abierto) y un correo electrónico.

Prompt de arranque

Soy principiante. Tengo una carpeta de proyecto abierta en VS Code. Quiero
guardar una clave de API en un fichero .env para que mis programas la lean,
y quiero estar seguro de que ese fichero nunca se sube a GitHub. Dime qué
ficheros crear, qué escribir dentro de cada uno y con qué comando de Git
compruebo que .env está ignorado. No me pidas que pegue mi clave en el chat.

Esto lo escribe la IA, tú compruebas que funciona. Fíjate en la última frase del prompt: una clave nunca se pega en un chat, ni siquiera en el de una IA.

Explicación

Cuentas y claves: el carné y la llave

Para construir con IA necesitas dos cosas de los servicios que vas a usar: una cuenta y una clave.

La cuenta es tu carné de socio: tu nombre, tu correo y tu contraseña. Con ella entras en la web del servicio y ves tus proyectos, tu consumo y tus ajustes.

La clave de API es otra cosa. Es una llave que le das a tus programas para que puedan usar el servicio en tu nombre sin abrir el navegador. Si la cuenta es tu carné del gimnasio, la clave es la tarjeta que pasas por el torno: quien la tenga entra como si fueras tú. Por eso una clave vale exactamente lo mismo que una contraseña, y en algunos casos más, porque permite gastar tu cuota o tu dinero de forma automática, a miles de peticiones por minuto.

Una API (interfaz de programación de aplicaciones) es simplemente la «ventanilla» por la que un programa le pide cosas a otro. Cuando tu script de pe04 le pregunte algo a la IA, lo hará por esa ventanilla, enseñando la clave en cada petición.

Las cuentas que vas a crear

GitHub (https://github.com/signup). Es el sitio donde se guardan y comparten proyectos de código. Lo necesitas para Codespaces, para guardar tu trabajo del itinerario y como «carné» para entrar en otros servicios. Al crearla, GitHub te pedirá activar la verificación en dos pasos (2FA): además de la contraseña, un código de una app del móvil. Hazlo: es la medida que más ataques evita.

Un proveedor de IA con nivel sin coste. Te proponemos tres, todos sin tarjeta en octubre de 2026. Basta con uno; tener dos te salva el día si uno falla.

  • Google AI Studio (https://aistudio.google.com/apikey). Da acceso a los modelos Gemini. Entras con una cuenta de Google y creas la clave en dos clics. Es el proveedor por defecto del Curso 0 y el que usa el script de pe04.
  • Groq (https://console.groq.com/keys). Ejecuta modelos abiertos (Llama, gpt-oss) a una velocidad muy alta. Te registras con correo, Google o GitHub. Es la alternativa si AI Studio no te funciona.
  • OpenRouter (https://openrouter.ai/settings/keys). Es un «centro comercial» de modelos: una sola clave da acceso a cientos de ellos, algunos marcados como :free. Sin comprar créditos, los modelos gratuitos tienen un tope de 50 peticiones al día y 20 por minuto.

Los límites gratuitos cambian a menudo. No te aprendas cifras: cuando dudes, mira la página oficial de límites de cada proveedor (están en la tabla de URLs).

Una advertencia sobre los niveles gratuitos: lo que envías a un servicio gratuito puede usarse según sus condiciones, que no siempre son las de un plan de pago. Regla práctica para todo el curso: en las pruebas, nada de datos personales, de clientes ni de tu empresa.

Qué aspecto tiene una clave

Las claves son cadenas largas de letras y números con un prefijo que delata de dónde vienen:

ProveedorEmpieza por
Google AI StudioAQ. (las claves antiguas, AIza)
Groqgsk_
OpenRoutersk-or-v1-
GitHub (token personal)ghp_ o github_pat_

Esos prefijos existen precisamente para que los robots los reconozcan. Y ojo: hay robots buenos y malos. Los buenos, como el escaneo de secretos de GitHub, avisan al proveedor y a veces revocan la clave al instante. Los malos rastrean repositorios públicos día y noche y usan una clave publicada en cuestión de minutos.

La regla de oro

Una clave nunca se pega en un chat, ni en un repositorio, ni en una captura de pantalla.

  • Ni en un chat: ni en el de una IA, ni en WhatsApp, ni en un foro pidiendo ayuda. Si necesitas ayuda con un error, copia el error, no la clave. Si la IA te pide la clave, responde «está en mi .env, no la voy a compartir».
  • Ni en un repositorio: aunque sea privado. Los repositorios privados se hacen públicos por error, se comparten con colaboradores o se clonan en ordenadores ajenos.
  • Ni en una captura: ni en un vídeo. Si vas a grabar tu pantalla, oculta la clave antes.

El fichero .env: la caja fuerte del proyecto

Si la clave no puede ir en el código, ¿dónde va? En un fichero llamado exactamente .env (con el punto delante y sin nada detrás), en la carpeta del proyecto. Dentro, una línea por clave, con el formato NOMBRE=valor, sin espacios alrededor del igual y sin comillas:

GEMINI_API_KEY=AQ.pega_aqui_tu_clave

Tu programa leerá ese fichero al arrancar (en pe04 verás cómo, con una línea de Python). La clave queda separada del código: puedes enseñar el código a quien quieras sin enseñar la llave.

El fichero .gitignore: la lista de lo que no se sube

Git, la máquina del tiempo de pe01, guarda fotos de todos los ficheros del proyecto. Para que nunca fotografíe el .env, se crea otro fichero, .gitignore, con la lista de cosas que Git debe ignorar. La línea .env dentro de .gitignore es tu seguro. Y se comprueba, no se supone: el comando git check-ignore -v .env te dice si Git lo está ignorando y por qué regla.

Un truco profesional: crea también un .env.example con los nombres de las variables pero sin valores. Ese sí se sube, y sirve para que cualquiera (incluido tú dentro de seis meses) sepa qué claves necesita el proyecto.

Qué hacer si una clave se escapa

Pasa hasta en las mejores familias. Lo importante es el orden:

  1. Revoca la clave en el proveedor. Ya. Antes de borrar el commit, antes de avisar a nadie. Una clave revocada deja de funcionar al instante y deja de ser peligrosa.
  2. Crea una nueva y ponla en tu .env.
  3. Revisa el consumo en el panel del proveedor por si alguien la usó.
  4. Después, si quieres, limpia el historial. Pero borrar el commit no basta: la clave pudo copiarse en el minuto en que estuvo publicada.

Revocar es igual en los tres proveedores: entras en la página de claves, localizas la clave por su nombre y pulsas el icono de papelera o «Delete». Por eso conviene poner nombres descriptivos a las claves («portatil-curso0», «grabacion-demo»): sabrás cuál borrar sin dudar.

Lab paso a paso

Objetivo: una cuenta de GitHub con 2FA, una clave de IA guardada en .env, y la prueba de que Git la ignora. Los pasos de navegador son iguales en los tres sistemas; los de terminal cambian.

Paso 1. Cuenta de GitHub (navegador, todos los sistemas)

1Entra en https://github.com/signup, escribe tu correo, una contraseña y un nombre de usuario. Verifica el correo con el código que te llega.

2Ve a https://github.com/settings/security y activa Two-factor authentication con una app de autenticación (Google Authenticator, Microsoft Authenticator o similar).

3Descarga los códigos de recuperación y guárdalos fuera del ordenador (impresos o en un gestor de contraseñas).

Si va bien, en la página de seguridad verás la verificación en dos pasos como activada.

Paso 2. Una clave de IA (navegador)

Elige al menos uno. Recomendado: Google AI Studio, porque es el que usa el script de pe04. Groq es la alternativa más sencilla.

Google AI Studio

1Entra en https://aistudio.google.com/apikey con tu cuenta de Google y acepta las condiciones.

2Pulsa Create API key (Crear clave de API). Si te pide un proyecto, deja que cree uno por defecto.

3Copia la clave, que empieza por AQ. (si creaste la tuya hace tiempo, puede empezar por AIza: también vale). No la pegues en ningún sitio todavía: el siguiente paso es meterla en .env.

Groq

1Entra en https://console.groq.com/keys y regístrate (correo, Google o GitHub).

2Pulsa Create API Key, ponle un nombre como curso0-portatil y confirma.

3Copia la clave que empieza por gsk_. Solo se muestra una vez.

OpenRouter

1Entra en https://openrouter.ai/settings/keys y regístrate.

2Pulsa Create Key (Crear clave), ponle nombre y deja el límite de crédito vacío o en 0.

3Copia la clave que empieza por sk-or-v1-.

Paso 3. Carpeta del proyecto con Git (terminal)

Windows (PowerShell)

mkdir $HOME\lab\mi-primera-ia
cd $HOME\lab\mi-primera-ia
git init

Y abre la carpeta en VS Code:

code .

macOS y Ubuntu

mkdir -p ~/lab/mi-primera-ia
cd ~/lab/mi-primera-ia
git init

Y abre la carpeta en VS Code:

code .

Qué debe verse: Initialized empty Git repository in .../mi-primera-ia/.git/ y VS Code abierto en esa carpeta. En Codespaces, sustituye la ruta por /workspaces/<tu-codespace>/mi-primera-ia y omite code ..

Paso 4. Crear .gitignore, .env y .env.example (en VS Code)

En el panel izquierdo de VS Code, pulsa el icono New File (Nuevo archivo) y crea estos tres ficheros. Escribe el nombre exacto, con el punto delante.

.gitignore:

.env
.venv/
__pycache__/

.env (pega tu clave en lugar del texto de ejemplo y guarda con Ctrl + S o Cmd + S):

GEMINI_API_KEY=AQ.pega_aqui_tu_clave

.env.example:

GEMINI_API_KEY=

Si usas otro proveedor, cambia el nombre de la variable: GROQ_API_KEY para Groq u OPENROUTER_API_KEY para OpenRouter.

Paso 5. Comprobar que Git ignora .env (terminal)

Los comandos son iguales en Windows, macOS y Ubuntu:

git check-ignore -v .env
git status

Qué debe verse:

.gitignore:1:.env	.env

Y en git status, en la lista de «Untracked files», aparecen .env.example y .gitignore, pero no aparece .env. Si .env aparece en git status, para: revisa el error frecuente sobre el nombre del fichero.

Paso 6. Simulacro de revocación (navegador)

Crea una segunda clave llamada simulacro-borrar, comprueba que aparece en la lista y bórrala con el icono de papelera. Cronométrate: debería llevarte menos de un minuto. Así, el día que lo necesites de verdad, sabrás dónde está el botón.

Evidencia

  • Captura de la página de seguridad de GitHub con la verificación en dos pasos activada (tapa el correo).
  • Captura de la terminal con la salida de git check-ignore -v .env y de git status sin .env en la lista.
  • Captura de la lista de claves del proveedor con la clave simulacro-borrar ya eliminada (las claves salen recortadas, pero tapa igualmente cualquier fragmento visible).

Criterio de aceptación

URLs de activación

Verificadas el 11-10-2026 (200 OK; github.com/signup devuelve 403 a peticiones automáticas pero abre bien en el navegador).

Para quéURL oficial
Crear cuenta de GitHubhttps://github.com/signup
Activar 2FA en GitHubhttps://github.com/settings/security
Tokens personales de GitHub (revocar)https://github.com/settings/tokens
Clave de Google AI Studio (crear y borrar)https://aistudio.google.com/apikey
Límites de Gemini APIhttps://ai.google.dev/gemini-api/docs/rate-limits
Clave de Groq (crear y borrar)https://console.groq.com/keys
Límites de Groqhttps://console.groq.com/docs/rate-limits
Clave de OpenRouter (crear y borrar)https://openrouter.ai/settings/keys
Límites de OpenRouterhttps://openrouter.ai/docs/api/reference/limits
Escaneo de secretos de GitHubhttps://docs.github.com/es/code-security/secret-scanning/introduction/about-secret-scanning

Errores frecuentes

SíntomaQué pasaCómo se arregla
.env aparece en git status aunque está en .gitignoreEn Windows, el Bloc de notas guardó el fichero como .env.txt, o el .gitignore se llama .gitignore.txt.Crea los ficheros desde VS Code. Para comprobar nombres reales: Get-ChildItem -Force en PowerShell o ls -la en macOS y Linux. Renombra con Rename-Item .env.txt .env o mv .env.txt .env.
.env sigue apareciendo en GitHub después de añadirlo a .gitignoreEl fichero ya se había incluido en un commit antes de crear .gitignore. .gitignore solo afecta a ficheros nuevos.Revoca la clave (está expuesta). Después: git rm --cached .env, haz commit y crea una clave nueva.
Error 401 Unauthorized o Invalid API Key al usar la claveLa clave está mal copiada (falta un carácter, hay un espacio o unas comillas), es de otro proveedor o fue revocada.Copia de nuevo la clave desde el panel, sin espacios ni comillas: NOMBRE=valor. Comprueba que el prefijo coincide con el proveedor. Si la perdiste, crea una nueva: no se pueden volver a ver.
Error 429 Too Many RequestsHas superado el límite gratuito por minuto o por día.Espera un minuto (o al día siguiente si es el límite diario), haz menos peticiones seguidas o cambia temporalmente a otro proveedor con su propia clave.
AI Studio dice que el servicio no está disponible o pide facturaciónCuenta de Google gestionada (trabajo o centro educativo) con la API desactivada, o país no admitido.Usa una cuenta personal de Google o pasa a Groq u OpenRouter, que no piden tarjeta.
No encuentras la clave que creaste ayerLos proveedores solo la muestran completa una vez, al crearla.Bórrala y crea otra; esta vez pégala directamente en .env.
GitHub te envía un correo «secret detected»Has subido una clave y el escaneo de secretos la ha detectado.No lo ignores: revoca la clave en el proveedor, crea una nueva y retírala del repositorio.

Quiz

Cinco preguntas para comprobar que lo has entendido. Necesitas un 70 % para aprobar.