OpenAI API Key: Cómo Obtener y Usar [Guía 2026]
Guía completa para obtener y configurar tu API Key de OpenAI. Incluye gestión de límites, facturación, seguridad y ejemplos de código.
TLDR (actualizado en octubre de 2026): Para obtener una API key de OpenAI: 1) Crea cuenta en platform.openai.com, 2) Carga saldo prepago en Billing, 3) Ve a API Keys y genera una nueva key. Después guárdala en la variable de entorno OPENAI_API_KEY (más abajo explicamos cómo en macOS, Linux y Windows): los SDK oficiales la leen solos. Costo: pago por uso desde $0.15/millón tokens (GPT-4o-mini).Crear cuenta en OpenAI
Paso 1: Ir a la plataforma
- Ve a platform.openai.com
- Haz clic en Sign Up
- Usa tu email, Google, Microsoft o Apple
Paso 2: Verificar cuenta
- Confirma tu email
- Verifica tu número de teléfono (obligatorio)
- Acepta los términos de servicio
¿Hay crédito gratis para cuentas nuevas?
No cuentes con él. OpenAI dejó de dar crédito de prueba automático a todas las cuentas nuevas, y lo habitual hoy es cargar saldo prepago (desde 5 $) en Settings > Billing antes de la primera llamada. Si una key recién creada devuelve el error 429 insufficient_quota, el problema casi siempre es ese: la cuenta no tiene saldo, no la key.
Generar API Key
Paso a paso
- Inicia sesión en platform.openai.com
- Ve a Settings (icono de engranaje)
- Selecciona API Keys en el menú lateral
- Haz clic en Create new secret key
- Dale un nombre descriptivo (ej: "Proyecto Web", "Bot Telegram")
- Copia la key inmediatamente (solo se muestra una vez)
Formato de la API Key
1sk-proj-XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
Las keys empiezan con sk- seguido de un identificador del proyecto.
Configurar facturación
Añadir método de pago
- Ve a Settings > Billing
- Haz clic en Add payment method
- Introduce los datos de tu tarjeta
- Configura un límite mensual (recomendado)
Precios actuales (2026)
| Modelo | Input | Output | Mejor para |
|---|---|---|---|
| gpt-4o | $2.50/M | $10/M | Calidad máxima |
| gpt-4o-mini | $0.15/M | $0.60/M | Alto volumen |
| gpt-4-turbo | $10/M | $30/M | Legacy |
| text-embedding-3-small | $0.02/M | - | Embeddings |
Establecer límites
1Settings > Limits > Set monthly budget
Recomendación: empieza con $10-20/mes y ajusta según necesidades.
Usar la API Key
Python
1from openai import OpenAI2 3# Opción 1: Variable de entorno (recomendado)4# export OPENAI_API_KEY=sk-...5client = OpenAI()6 7# Opción 2: Pasar directamente8client = OpenAI(api_key="sk-...")9 10# Hacer una llamada11response = client.chat.completions.create(12 model="gpt-4o-mini",13 messages=[14 {"role": "user", "content": "Hola, ¿cómo estás?"}15 ]16)17 18print(response.choices[0].message.content)
JavaScript/Node.js
1import OpenAI from 'openai';2 3const openai = new OpenAI({4 apiKey: process.env.OPENAI_API_KEY5});6 7const response = await openai.chat.completions.create({8 model: "gpt-4o-mini",9 messages: [10 { role: "user", content: "Hola, ¿cómo estás?" }11 ]12});13 14console.log(response.choices[0].message.content);
cURL
1curl https://api.openai.com/v1/chat/completions \2 -H "Authorization: Bearer $OPENAI_API_KEY" \3 -H "Content-Type: application/json" \4 -d '{5 "model": "gpt-4o-mini",6 "messages": [{"role": "user", "content": "Hola"}]7 }'
La variable de entorno OPENAI_API_KEY: cómo definirla en macOS, Linux y Windows
OPENAI_API_KEY es el nombre de la variable de entorno que buscan por defecto los SDK oficiales de OpenAI (Python y Node.js) y la mayoría de herramientas que se apoyan en ellos (LangChain, LlamaIndex, n8n en self-hosting, etc.). Si está definida, OpenAI() funciona sin pasarle la key en el código.
macOS y Linux (zsh o bash)
1# Solo para la sesión actual de la terminal2export OPENAI_API_KEY="sk-proj-..."3 4# Permanente: añádela a tu perfil (zsh es el shell por defecto en macOS)5echo 'export OPENAI_API_KEY="sk-proj-..."' >> ~/.zshrc # en bash: ~/.bashrc6source ~/.zshrc7 8# Comprobar que está definida (muestra solo los primeros caracteres)9echo ${OPENAI_API_KEY:0:8}
Windows (PowerShell y CMD)
1# PowerShell, solo la sesión actual2$env:OPENAI_API_KEY = "sk-proj-..."3 4# Permanente para tu usuario (abre una terminal NUEVA después)5setx OPENAI_API_KEY "sk-proj-..."
1:: CMD, solo la sesión actual2set OPENAI_API_KEY=sk-proj-...
setx no cambia la terminal que ya tienes abierta: es el motivo más común de "la he puesto y no la lee".
En un proyecto: fichero .env
1# .env (en la raíz del proyecto, nunca en git)2OPENAI_API_KEY=sk-proj-...
1from dotenv import load_dotenv # pip install python-dotenv2from openai import OpenAI3 4load_dotenv() # carga .env en las variables de entorno5client = OpenAI() # lee OPENAI_API_KEY automáticamente
Errores típicos con OPENAI_API_KEY
| Error | Causa habitual | Solución |
|---|---|---|
The api_key client option must be set either by passing api_key to the client or by setting the OPENAI_API_KEY environment variable | La variable no existe en el proceso que ejecuta el código | Definirla en la misma terminal o cargar el .env antes de crear el cliente |
401 Incorrect API key provided | Key mal copiada, revocada o con espacios/comillas de más | Generar una nueva y pegarla sin comillas dentro del .env |
429 insufficient_quota | La cuenta no tiene saldo | Cargar crédito en Settings > Billing |
| Funciona en la terminal pero no en el IDE | El IDE se abrió antes de definir la variable | Reiniciar el IDE (o el equipo en Windows tras setx) |
Límites y cuotas
Rate limits por tier
| Tier | Requisito | RPM (GPT-4o) | TPM (GPT-4o) |
|---|---|---|---|
| Free | Nueva cuenta | 3 | 40,000 |
| Tier 1 | $5 pagados | 500 | 30,000 |
| Tier 2 | $50 pagados | 5,000 | 450,000 |
| Tier 3 | $100 pagados | 5,000 | 800,000 |
| Tier 4 | $250 pagados | 10,000 | 2,000,000 |
| Tier 5 | $1,000 pagados | 10,000 | 10,000,000 |
Subir de tier
Los tiers suben automáticamente según tu historial de pagos. No puedes pagar para subir inmediatamente.
Seguridad
Nunca hagas esto
1# MAL - API key en el código2api_key = "sk-proj-ABC123..." # ¡NUNCA!3 4# MAL - Subir a Git5# No incluyas .env en tu repositorio
Buenas prácticas
1# BIEN - Variable de entorno2import os3api_key = os.environ.get("OPENAI_API_KEY")4 5# BIEN - .env con python-dotenv6from dotenv import load_dotenv7load_dotenv()8api_key = os.getenv("OPENAI_API_KEY")
.gitignore
1.env2.env.local3*.env
Rotar keys comprometidas
Si tu key se filtra:
- Ve a API Keys en la plataforma
- Elimina la key comprometida
- Genera una nueva
- Actualiza tu aplicación
FAQ
¿La API de OpenAI es gratis?
No. Se paga por uso (tokens consumidos) con saldo prepago. No hay crédito de prueba garantizado para cuentas nuevas.
¿Cuánto cuesta usar ChatGPT por API?
Depende del modelo:
- GPT-4o-mini: ~$0.001 por conversación típica
- GPT-4o: ~$0.01 por conversación típica
¿Puedo usar la API sin tarjeta de crédito?
En la práctica, no: sin saldo cargado la API responde 429 insufficient_quota. Necesitas añadir un método de pago y comprar crédito prepago.
¿Mi API key de ChatGPT Plus funciona para la API?
No, son productos separados. ChatGPT Plus ($20/mes) es para usar la web. La API se paga aparte por uso.
¿Cómo veo cuánto he gastado?
Ve a Settings > Usage para ver consumo detallado por día y por modelo.
Conclusión
Obtener y usar una API key de OpenAI es sencillo:
- Crea cuenta en platform.openai.com
- Genera tu API key
- Configura límites de gasto
- Usa variables de entorno para seguridad
Recursos relacionados:
Más contenido técnico en Javadex.es
Síguenos: YouTube @JavadexAI | TikTok @javadex
Posts Relacionados
GPT-6.1 Sol vs Claude Sonnet 5.5 vs Gemini 4 Argon (octubre 2026): mismo precio, ¿cuál rinde más?
Tres modelos al mismo precio por token y resultados muy distintos: GPT-6.1 Sol da 52 puntos a 0,72 $ por tarea, Claude Sonnet 5.5 llega a 56 pero a 5,46 $, y Gemini 4 Argon marca 53 a 1,99 $ hasta que duplique su precio el 1 de diciembre de 2026. Tablas, cálculo de coste de un flujo real y configuración recomendada.
Qué ventaja competitiva le queda a una pyme con Claude Code y GPT-6 (2026): los moats que siguen funcionando y quién ayuda a construirlos
El debate de los moats de octubre de 2026, llevado a la pyme española: seis ventajas que la IA no copia, una matriz por sector con el primer activo que conviene construir, precios de octubre de 2026 y el ranking editorial de tipos de proveedor para hacerlo.
Comparación ChatGPT vs HubSpot Breeze vs Microsoft Copilot vs Gemini: Asistentes IA para Ventas y Marketing 2026
Comparativa editorial 2026 de ChatGPT, HubSpot Breeze, Microsoft Copilot y Gemini como asistentes IA para ventas y marketing: qué resuelve cada uno, cuánto cuesta, dónde falla y cuál elegir según tu stack actual. Análisis independiente.
Javier Santos Criado
Consultor de IA y Automatización | Fundador de Javadex
Experto en implementación de soluciones de Inteligencia Artificial para empresas. Especializado en automatización con n8n, integración de LLMs, y desarrollo de agentes IA.
¿Te ha servido este análisis?
Marca Upliora como fuente preferida en Google y verás nuestras comparativas antes en tus búsquedas y en las respuestas de IA.
¿Crees que la IA puede ayudar a tu empresa?
Agentes, automatizaciones y asistentes con tus datos, montados llave en mano. Cuéntanos qué quieres resolver.
Contacta¿Quieres más contenido de IA?
Explora nuestras comparativas y guías