Consultoría IA para empresas — 100% remoto, trabajamos con tu equipo in-house

Inicio/Blog/OpenAI API Key: Cómo Obtener y Usar [Guía 2026]
Volver al Blog
APIsPublicado el Actualizado el 12 min

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

  1. Ve a platform.openai.com
  2. Haz clic en Sign Up
  3. 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

  1. Inicia sesión en platform.openai.com
  2. Ve a Settings (icono de engranaje)
  3. Selecciona API Keys en el menú lateral
  4. Haz clic en Create new secret key
  5. Dale un nombre descriptivo (ej: "Proyecto Web", "Bot Telegram")
  6. Copia la key inmediatamente (solo se muestra una vez)

Formato de la API Key

code
1sk-proj-XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX

Las keys empiezan con sk- seguido de un identificador del proyecto.


Configurar facturación

Añadir método de pago

  1. Ve a Settings > Billing
  2. Haz clic en Add payment method
  3. Introduce los datos de tu tarjeta
  4. Configura un límite mensual (recomendado)

Precios actuales (2026)

ModeloInputOutputMejor para
gpt-4o$2.50/M$10/MCalidad máxima
gpt-4o-mini$0.15/M$0.60/MAlto volumen
gpt-4-turbo$10/M$30/MLegacy
text-embedding-3-small$0.02/M-Embeddings
M = millón de tokens

Establecer límites

code
1Settings > Limits > Set monthly budget

Recomendación: empieza con $10-20/mes y ajusta según necesidades.


Usar la API Key

Python

python
1from openai import OpenAI
2 
3# Opción 1: Variable de entorno (recomendado)
4# export OPENAI_API_KEY=sk-...
5client = OpenAI()
6 
7# Opción 2: Pasar directamente
8client = OpenAI(api_key="sk-...")
9 
10# Hacer una llamada
11response = 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

javascript
1import OpenAI from 'openai';
2 
3const openai = new OpenAI({
4 apiKey: process.env.OPENAI_API_KEY
5});
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

bash
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)

bash
1# Solo para la sesión actual de la terminal
2export 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: ~/.bashrc
6source ~/.zshrc
7 
8# Comprobar que está definida (muestra solo los primeros caracteres)
9echo ${OPENAI_API_KEY:0:8}

Windows (PowerShell y CMD)

powershell
1# PowerShell, solo la sesión actual
2$env:OPENAI_API_KEY = "sk-proj-..."
3 
4# Permanente para tu usuario (abre una terminal NUEVA después)
5setx OPENAI_API_KEY "sk-proj-..."

bat
1:: CMD, solo la sesión actual
2set 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

bash
1# .env (en la raíz del proyecto, nunca en git)
2OPENAI_API_KEY=sk-proj-...

python
1from dotenv import load_dotenv # pip install python-dotenv
2from openai import OpenAI
3 
4load_dotenv() # carga .env en las variables de entorno
5client = OpenAI() # lee OPENAI_API_KEY automáticamente

Errores típicos con OPENAI_API_KEY

ErrorCausa habitualSolució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 variableLa variable no existe en el proceso que ejecuta el códigoDefinirla en la misma terminal o cargar el .env antes de crear el cliente
401 Incorrect API key providedKey mal copiada, revocada o con espacios/comillas de másGenerar una nueva y pegarla sin comillas dentro del .env
429 insufficient_quotaLa cuenta no tiene saldoCargar crédito en Settings > Billing
Funciona en la terminal pero no en el IDEEl IDE se abrió antes de definir la variableReiniciar el IDE (o el equipo en Windows tras setx)

Límites y cuotas

Rate limits por tier

TierRequisitoRPM (GPT-4o)TPM (GPT-4o)
FreeNueva cuenta340,000
Tier 1$5 pagados50030,000
Tier 2$50 pagados5,000450,000
Tier 3$100 pagados5,000800,000
Tier 4$250 pagados10,0002,000,000
Tier 5$1,000 pagados10,00010,000,000
RPM = Requests per minute, TPM = Tokens per minute

Subir de tier

Los tiers suben automáticamente según tu historial de pagos. No puedes pagar para subir inmediatamente.


Seguridad

Nunca hagas esto

python
1# MAL - API key en el código
2api_key = "sk-proj-ABC123..." # ¡NUNCA!
3 
4# MAL - Subir a Git
5# No incluyas .env en tu repositorio

Buenas prácticas

python
1# BIEN - Variable de entorno
2import os
3api_key = os.environ.get("OPENAI_API_KEY")
4 
5# BIEN - .env con python-dotenv
6from dotenv import load_dotenv
7load_dotenv()
8api_key = os.getenv("OPENAI_API_KEY")

.gitignore

code
1.env
2.env.local
3*.env

Rotar keys comprometidas

Si tu key se filtra:

  1. Ve a API Keys en la plataforma
  2. Elimina la key comprometida
  3. Genera una nueva
  4. 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:

  1. Crea cuenta en platform.openai.com
  2. Genera tu API key
  3. Configura límites de gasto
  4. Usa variables de entorno para seguridad

Recursos relacionados:


Más contenido técnico en Javadex.es

Síguenos: YouTube @JavadexAI | TikTok @javadex

Posts Relacionados

JS

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.

Seguir en Google

¿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

Consultoría y formación en IA para empresas

Implementamos soluciones de inteligencia artificial adaptadas a tu negocio. Proceso 100% remoto — trabajamos con tu equipo in-house sin que tengas que desplazarte.

Sesión de 30 min · Sin compromiso