Para obtener tu OpenAI API key, crea una cuenta en platform.openai.com, carga créditos en la facturación de tu organización y genera la llave en Settings → Organization → API keys. La API se paga aparte de ChatGPT Plus, por consumo de tokens, y la llave se guarda en una variable de entorno, nunca dentro del código.
Esta guía es para quien tiene que dejarla funcionando: el desarrollador, la analista que arma una automatización o el gerente que necesita entender qué está aprobando. Las rutas, los precios y el código están verificados en la documentación oficial de OpenAI a octubre de 2026.
Qué es la API de OpenAI y para qué sirve
La API de OpenAI es la puerta para usar los modelos de OpenAI desde tus propios sistemas, sin abrir ChatGPT. En vez de escribir en un chat, un programa le manda la instrucción y recibe la respuesta: un CRM que resume correos, una hoja de cálculo que clasifica solicitudes, un flujo que redacta borradores para que alguien los revise.
La API key es la contraseña de ese acceso. Identifica a tu organización en cada llamada y es la base del cobro. Quien la tenga puede gastar tu saldo.
El cobro es por tokens: los pedazos de texto que el modelo lee y escribe. Lo que lee (entrada) cuesta menos que lo que escribe (salida).
¿La API de OpenAI es gratis? ChatGPT Plus no la incluye
No. La API se paga por uso y aparte de cualquier plan de ChatGPT. La ayuda oficial de OpenAI dice que ChatGPT y la plataforma de la API tienen sistemas de facturación separados, y en la descripción de ChatGPT Plus el uso de la API aparece como no incluido. Lo mismo dicen las páginas de los planes Go y Business.
Es la confusión más común. Alguien paga Plus, intenta conectar una herramienta y descubre que necesita otra cuenta de pago. No es un error de configuración: son dos productos.
Existe una función llamada «Sign in with ChatGPT» que deja usar la cuota de tu plan en algunas aplicaciones de terceros. Eso no es la API y no te da una llave.
¿Y el nivel «Free» que aparece en la documentación? Es un tope de uso para cuentas en países habilitados, no un saldo de regalo. La documentación no dice qué modelos se pueden usar en ese nivel, así que no armes un proyecto contando con él.
Cómo obtener la API key de OpenAI paso a paso
La consola de la API (cuenta, llaves y facturación) vive en platform.openai.com. La documentación se mudó a developers.openai.com: si entras a la dirección vieja, te redirige.
Crea la cuenta en la plataforma
Regístrate en platform.openai.com/signup. Es la cuenta de la plataforma de la API, con su propia facturación.
Verifica lo que te pida
Al generar la primera llave puede pedirte verificar un número de teléfono. Algunos modelos o funciones exigen además verificar la organización en Settings → Organization → General → Verify Organization, con un documento de identidad oficial y físico. Un documento solo sirve para verificar una organización.
Agrega un método de pago y carga créditos
En la facturación (Billing) de la organización agregas la tarjeta y compras saldo. Más abajo está el detalle del mínimo y del vencimiento.
Crea la llave
Entra a Settings → Organization → API keys (platform.openai.com/settings/organization/api-keys) y crea una llave nueva. Ponle un nombre que diga para qué es, como «crm-produccion» o «pruebas-automatizacion». Si es una llave de proyecto, ponle fecha de vencimiento: lo recomienda la guía de buenas prácticas de OpenAI.
Guárdala en una variable de entorno
Copia la llave y guárdala en la variable de entorno
OPENAI_API_KEY, un valor que tu computador o servidor guarda fuera del código. Los SDK oficiales (las librerías de OpenAI para cada lenguaje de programación) la leen solos, así que la llave nunca tiene que aparecer en tu código.
# macOS / Linux export OPENAI_API_KEY="your_api_key_here" # Windows (PowerShell) setx OPENAI_API_KEY "your_api_key_here"
Reemplaza your_api_key_here por tu llave. En Windows, setx deja la variable para las terminales que abras después, no para la que tienes abierta.
Cómo se recargan los créditos: mínimo y vencimiento
La API de OpenAI es prepago: compras créditos y se van descontando según los tokens que consumes. Según la ayuda de OpenAI, a octubre de 2026:
- La recarga mínima es de USD 5. El valor que aparece preseleccionado es USD 10.
- La recarga automática viene activada por defecto al configurar el pago, también con un mínimo de USD 5.
- Los créditos vencen al año de comprados y el plazo no se puede extender.
- En general no son reembolsables, salvo error de facturación verificado, uso no autorizado confirmado o falla del servicio.
La compra se hace en la página de facturación (Billing) de la organización, desde la opción para comprar o agregar crédito.
Niveles de uso de la API de OpenAI
OpenAI ordena las cuentas por niveles según lo que has comprado en créditos, y cada nivel tiene un tope de uso mensual. A octubre de 2026, la documentación lista cuatro:
| Nivel | Requisito | Tope de uso |
|---|---|---|
| Free | Estar en un país habilitado | USD 100 al mes |
| Build | USD 5 en compras de crédito acumuladas | USD 500 al mes |
| Launch | USD 100 en compras acumuladas | USD 5.000 al mes |
| Grow | USD 500 en compras acumuladas | USD 200.000 al mes |
Los tres niveles pagos son Build, Launch y Grow. El nivel sube solo cuando tus compras acumuladas pasan cada umbral, y también puedes pedir el cambio en Settings → Organization → Limits → Usage Tiers → Upgrade tier.
Si un tutorial te habla de «Tier 1» a «Tier 5», está desactualizado: esos nombres ya no aparecen en la documentación. Scale Tier y Reserved Tier sí existen, pero son opciones de capacidad, no niveles de uso.
Precio de la API de OpenAI: modelos y costo por millón de tokens
La API cobra por millón de tokens, con un precio para lo que el modelo lee y otro, más alto, para lo que escribe. Estos son los modelos vigentes en el nivel Standard, para peticiones de hasta 272.000 tokens de entrada, en USD por millón de tokens, a octubre de 2026:
| Modelo (ID en la API) | Entrada | Entrada en caché | Salida | Para qué, según OpenAI |
|---|---|---|---|---|
gpt-6-astra | 10,00 | 1,00 | 50,00 | El más capaz, para el trabajo más exigente |
gpt-6.1-sol | 2,00 | 0,10 | 10,00 | Cerca de Astra en trabajo complejo, a menor costo |
gpt-6-luna | 0,10 | 0,01 | 0,50 | El más eficiente, para tareas puntuales y de alto volumen |
gpt-6-sol | 2,00 | 0,20 | 10,00 | No figura entre los modelos insignia |
gpt-5.6-sol | 4,00 | 0,40 | 20,00 | Generación anterior |
Los tres modelos insignia (GPT-6 Astra, GPT-6.1 Sol y GPT-6 Luna) tienen una ventana de contexto (lo máximo que leen en una sola petición) de 1,05 millones de tokens. Por encima de 272.000 tokens de entrada el precio sube: GPT-6 Astra pasa a USD 20 de entrada y USD 75 de salida; GPT-6.1 Sol, a USD 4 y USD 15; GPT-6 Luna, a USD 0,20 y USD 0,75.
Hay otros modos de servicio. Batch y Flex cuestan la mitad de Standard. Fast, que antes se llamaba «Priority processing», cuesta el doble.
La recomendación oficial para empezar es GPT-6 Astra. La nuestra, para una empresa, es otra: prueba la tarea con el modelo más barato que pueda resolverla y sube solo si falla. Entre GPT-6 Luna y GPT-6 Astra hay 100 veces de diferencia en el precio por token.
¿Tu equipo ya paga ChatGPT y no pasa del chat?
En la capacitación cada área aprende a usar ChatGPT Business o Enterprise sobre sus propias tareas, con reglas claras de qué información entra a la herramienta.
Ver la capacitación en ChatGPT para empresas →Tu primera llamada: el ejemplo mínimo oficial
Con la llave en la variable de entorno, este es el ejemplo del quickstart oficial de OpenAI, tal como aparece hoy. Primero instala la librería:
pip install openai
from openai import OpenAI
client = OpenAI()
response = client.responses.create(
model="gpt-6-astra",
input="Write a one-sentence bedtime story about a unicorn.",
)
print(response.output_text)Lo mismo desde la terminal, con curl, según la guía oficial de generación de texto:
curl "https://api.openai.com/v1/responses" \
-H "Content-Type: application/json" \
-H "Authorization: Bearer $OPENAI_API_KEY" \
-d '{
"model": "gpt-6-astra",
"input": "Write a one-sentence bedtime story about a unicorn."
}'Dos detalles que ahorran una tarde. Los ejemplos actuales usan la Responses API (/v1/responses), no la ruta chat/completions de muchos tutoriales viejos. Y el cliente de Python no recibe la llave como parámetro porque la lee de OPENAI_API_KEY. Si te responde una frase sobre un unicornio, tu llave funciona.
Cómo proteger tu OpenAI API key
OpenAI lo dice sin rodeos: tu API key es un secreto. Quien la tenga gasta tu saldo. Estas son las reglas de su guía de buenas prácticas:
- Nunca en el código ni en un repositorio público. Tampoco en código que corre en el navegador o en una app, donde cualquiera puede leerla.
- Cárgala desde una variable de entorno o desde un gestor de secretos en el servidor.
- Ponle fecha de vencimiento y rótala: creas la nueva, cambias las aplicaciones y revocas la vieja. Revocar una llave surte efecto en segundos.
- Separa proyectos de pruebas y de producción, cada uno con sus propios límites de gasto y de uso.
- Una llave por persona. Según la ayuda de OpenAI, compartir llaves va contra los términos de uso.
Límites de gasto
En platform.openai.com/settings/organization/limits configuras alertas de gasto por correo y un límite duro («hard spend limit») que detiene el tráfico cuando se llega al tope. El consumo lo ves en platform.openai.com/settings/organization/usage. Hazlo el mismo día que creas la llave, no después de la primera factura.
Errores comunes al configurar la API de OpenAI
- Creer que ChatGPT Plus incluye la API. Son dos cuentas de pago distintas.
- Pegar la llave en el código «para probar rápido». Ese archivo termina en un repositorio, en un correo o en una captura de pantalla.
- Dejar la recarga automática sin límite duro. Viene encendida por defecto.
- Copiar tutoriales viejos: la ruta
chat/completions, niveles «Tier 1 a Tier 5» o modelos que ya no están en la lista. Compara siempre con developers.openai.com. - Una sola llave para todo el equipo. Cuando se filtra o alguien se va, revocarla tumba todas las integraciones a la vez.
- Usar el modelo más caro para todo. Clasificar correos no necesita el modelo insignia.
- Ignorar la verificación de la organización cuando un modelo o una función la pide.
- En Windows, probar en la misma terminal donde corriste
setx. Abre una nueva.
Cómo llevar la API de OpenAI al trabajo de tu equipo
Obtener la llave es la parte fácil. Lo difícil es decidir qué proceso conectar, qué información puede salir hacia la API y quién revisa lo que vuelve. Eso no lo resuelve la documentación: lo resuelve el criterio del equipo, y por eso en PorContar damos capacitación en IA para empresas sobre el trabajo real de cada área.
- Si el equipo quiere dejar procesos funcionando, con la IA conectada al correo, las hojas de cálculo o el CRM, eso es el curso de automatización de procesos con IA.
- Si es el área de tecnología la que va a integrar modelos en el código, la ruta es Claude Code para equipos de tecnología.
- Si estás aprendiendo por tu cuenta, mira los cursos de IA para personas.
¿Estás comparando proveedores? La misma guía existe para la Claude API key y para la API de Perplexity.
Antes de conectar la API, mide cómo usa la IA tu equipo
El diagnóstico es gratuito y toma dos minutos: ves en qué nivel de adopción está tu equipo y por dónde conviene empezar.
Hacer el diagnóstico de IA →Sigue aprendiendo con nuestros cursos
Domina Claude para Negocios
MarketingEstrategia de Marketing con IA
ContenidoStorytelling con IA y Creación de Contenido
Preguntas frecuentes
¿Cómo obtener la API key de OpenAI?
¿La API de OpenAI es gratis?
¿ChatGPT Plus incluye la API de OpenAI?
¿Cuánto cuesta la API de OpenAI?
¿Cuál es la recarga mínima y cuándo vencen los créditos?
¿Cómo veo o recupero mi API key de OpenAI?
¿Cómo conecto la API de OpenAI con n8n u otra herramienta?
¿Qué pasa si alguien ve mi API key?
Datos verificados el 17 de octubre de 2026 en la documentación oficial de OpenAI: quickstart, precios, niveles de uso y buenas prácticas. Recarga mínima, vencimiento y facturación separada de ChatGPT: ayuda de OpenAI · Revisión trimestral
